FamilyInstance.GetReferenceByName
Method
Description:
Gets the family instance reference corresponding to the named reference plane in the instance's family.
Gets the family instance reference corresponding to the named reference plane in the instance's family.
Remarks:
If there is a reference plane in the instance's family that has the given name, and the plane's "Is Reference" property is not "Not a Reference", there will be a corresponding reference in the family's instance. This function returns that reference.
If there is a reference plane in the instance's family that has the given name, and the plane's "Is Reference" property is not "Not a Reference", there will be a corresponding reference in the family's instance. This function returns that reference.
Parameters
Parameter | Type | Description |
---|---|---|
name | String | The name of the reference plane in the family. |
Return Value
Type | Description |
---|---|
Reference | Returns the family instance reference corresponding to the named reference plane in the instance's family. Returns null if there is no reference plane with this name in the family, or if the plane exists but its "Is Reference" property is "Not a Reference", or if the input string is empty. |
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | A non-optional argument was null |