M

RebarContainer.Create

Description:
Creates a new instance of a Rebar Container element within the project.

Remarks:
Created Rebar Container starts out empty. Use appendItemFromRebar, appendItemFromCurves, appendItemFromRebarShape, appendItemFromCurvesAndShape to fill its content.

public static RebarContainer Create(
	Document aDoc,
	Element hostElement,
	ElementId rebarContainerTypeId
)

Public Shared Function Create ( _
	aDoc As Document, _
	hostElement As Element, _
	rebarContainerTypeId As ElementId _
) As RebarContainer

public:
static RebarContainer^ Create(
	Document^ aDoc, 
	Element^ hostElement, 
	ElementId^ rebarContainerTypeId
)

Autodesk.Revit.DB.Document

aDoc

A document.
Autodesk.Revit.DB.Element

hostElement

The element that will host the RebarContainer.
Autodesk.Revit.DB.ElementId

rebarContainerTypeId

The id of the RebarContainerType.

Return Value RebarContainer The newly created Rebar Container instance.

RebarContainer CreateRebarContainer(Autodesk.Revit.DB.Document document, FamilyInstance beam)
{
    // Create a new rebar container
    ElementId defaultRebarContainerTypeId = RebarContainerType.CreateDefaultRebarContainerType(document);
    RebarContainer container = RebarContainer.Create(document, beam, defaultRebarContainerTypeId);

    // Any items for this container should be presented in schedules and tags as separate subelements
    container.PresentItemsAsSubelements = true;

    return container;
}

Private Function CreateRebarContainer(document As Autodesk.Revit.DB.Document, beam As FamilyInstance) As RebarContainer
    ' Create a new rebar container
    Dim defaultRebarContainerTypeId As ElementId = RebarContainerType.CreateDefaultRebarContainerType(document)
    Dim container As RebarContainer = RebarContainer.Create(document, beam, defaultRebarContainerTypeId)

    ' Any items for this container should be presented in schedules and tags as separate subelements
    container.PresentItemsAsSubelements = True

    Return container
End Function

Autodesk.Revit.Exceptions.ArgumentException

The element hostElement was not found in the given document. -or- hostElement is not a valid rebar host. -or- the ElementId rebarContainerTypeId is either invalid or not a RebarContainerType.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was NULL
Autodesk.Revit.Exceptions.DisabledDisciplineException

None of the following disciplines is enabled: Structural.