Creates a field containing a single value in the Schema, with given name and type.
Namespace: Autodesk.Revit.DB.ExtensibleStorage
Assembly: RevitAPI (in RevitAPI.dll) Version: 24.0.0.0 (24.0.0.0)
Since: 2012
Syntax
C# |
---|
|
Visual Basic |
---|
|
Visual C++ |
---|
|
Parameters
- fieldName
- Type: SystemString
The name of the new field.
- fieldType
- Type: SystemType
The type of the new field.
Return Value
The FieldBuilder object may be used to add more details to the field. Make sure to set the unit type if the field contains floating-point values.Remarks
The supported types are Boolean, Byte, Int16, Int32, Int64, Float, Double, ElementId, GUID, String, XYZ, UV and Entity.
Note that data of type ElementId is not copied to new elements that are created via copy/paste or a linear or radial array.
Note that a schema may contain a maximum of 256 fields.
Exceptions
Exception | Condition |
---|---|
Autodesk.Revit.ExceptionsArgumentException | The parameter fieldName is not acceptable for naming Extensible Storage objects. -or- The field type is not supported. |
Autodesk.Revit.ExceptionsArgumentNullException | A non-optional argument was null |
Autodesk.Revit.ExceptionsInvalidOperationException | The SchemaBuilder has already finished building the Schema. |