Revit 2023 API |
Entity..::..Get<(Of <(<'FieldType>)>)> Method (String, ForgeTypeId) |
Entity Class See Also |
Retrieves the value of the field in the entity.
Namespace: Autodesk.Revit.DB.ExtensibleStorage
Assembly: RevitAPI (in RevitAPI.dll) Version: 23.0.0.0 (23.1.0.0)
Since:
2012
Syntax
C# |
---|
public FieldType Get<FieldType>( string fieldName, ForgeTypeId unitTypeId ) |
Visual Basic |
---|
Public Function Get(Of FieldType) ( _ fieldName As String, _ unitTypeId As ForgeTypeId _ ) As FieldType |
Visual C++ |
---|
public: generic<typename FieldType> FieldType Get( String^ fieldName, ForgeTypeId^ unitTypeId ) |
Parameters
- fieldName
- Type: System..::..String
The name of the field to retrieve.
- unitTypeId
- Type: Autodesk.Revit.DB..::..ForgeTypeId
Identifier of the unit to which the value will be converted before returning. Must be compatible with the spec specified when creating the Schema.
Type Parameters
- FieldType
- The type of the field
Remarks
The template parameter must match the type of the field (specified when creating the Schema) exactly; this method does not perform data type conversions. The types for containers are IList for arrays and IDictionary for maps.
This method is a shortcut that will look up the field by name. If you want to call it on many entities, it is faster if you look up the field yourself.
Exceptions
Exception | Condition |
---|---|
Autodesk.Revit.Exceptions..::..ArgumentNullException | A non-optional argument was NULL |
Autodesk.Revit.Exceptions..::..InvalidOperationException | The Field belongs to a different Schema from this Entity, or this Entity is invalid. |
Autodesk.Revit.Exceptions..::..ArgumentException | Requested type does not match the field type. |
Autodesk.Revit.Exceptions..::..ArgumentException | The name matches no field in this Entity's Schema. |
Autodesk.Revit.Exceptions..::..ArgumentException | The unitTypeId value is not compatible with the field description. |
Autodesk.Revit.Exceptions..::..ArgumentException | This field's subschema prevents reading. |