Creates a new assembly instance.
Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.3.0.0 (25.3.0.0)
Syntax
C#
public static AssemblyInstance Create( Document document, ICollection<ElementId> assemblyMemberIds, ElementId namingCategoryId )
Parameters
- document Document
- The document containing the elements.
- assemblyMemberIds ICollection<ElementId>
- The elements that comprise the assembly.
- namingCategoryId ElementId
- The naming category for the assembly instance.
Return Value
AssemblyInstanceThe newly created assembly instance.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | One or more element ids was not permitted for membership in the assembly instance. Elements should be of a valid category and should not be a member of an existing assembly. -or- This naming category was not valid for an assembly instance containing the proposed members. The naming category should match one of the member element categories. |
| ArgumentNullException | A non-optional argument was null |
| InvalidOperationException | The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). |
| ModificationForbiddenException | The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process. |
| ModificationOutsideTransactionException | The document has no open transaction. |