Skip to content
RevitAPI doc lite

Reference.ParseFromStableRepresentation

Public Class

Converts a stable String representation of a reference to a Reference object.

Namespace: Autodesk.Revit.DB

Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)

Syntax

public static Reference ParseFromStableRepresentation(
  Document document,
  string representation
)

Parameters

document Document

The document.

representationString

The reference representation.

Return Value

Reference

Exceptions

Exception

Condition

ArgumentNullException

One or more arguments was ..

ArgumentException

Reference representation could not be successfully parsed, or element id obtained from reference representation could not be found in this document.

Remarks

Use ConvertToStableRepresentation(Document) to obtain the representation. The Reference will have only the following information set:

You will also be able to pass the reference to Document.GetElement(reference) and Element.GetGeometryObjectFromReference(reference) to obtain the element and geometry object referred to.

Example

public Reference ParseReference(Document doc, String str)
{
    Reference reference = Reference.ParseFromStableRepresentation(doc, str);
    if (null == reference)
    {
        TaskDialog.Show("ParseReference", "Reference is Null.");
    }
    return reference;
}