Namespace: Autodesk.Revit.DB.Structure Class: RebarContainer

RebarContainer.Create

Method

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.

Syntax

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
)

static member Create : 
        aDoc : Document * 
        hostElement : Element * 
        rebarContainerTypeId : ElementId -> RebarContainer

Examples

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

Parameters

Parameter	Type	Description
aDoc	Document	A document.
hostElement	Element	The element that will host the RebarContainer.
rebarContainerTypeId	ElementId	The id of the RebarContainerType.

Return Value

Type	Description
RebarContainer	The newly created Rebar Container instance.

Exceptions

Exception	Condition
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.
ArgumentNullException	A non-optional argument was null