Namespace: Autodesk.Revit.DB.Architecture Class: BuildingPad

BuildingPad.Create

Method

Description:
Creates a new BuildingPad element and adds it to the document.

Remarks:
The document will be regenerated during the creation of building pad element. If the input curve loops intersect the curve loops of existing BuildingPads hosted on the same topography surface, an InvalidOperationException will be thrown. If you need access to the topography surface created by the introduction of this building pad, you can obtain it from AssociatedTopographySurfaceId.

Syntax

public static BuildingPad Create(
	Document document,
	ElementId buildingPadTypeId,
	ElementId levelId,
	IList<CurveLoop> curveLoops
)

Public Shared Function Create ( 
	document As Document,
	buildingPadTypeId As ElementId,
	levelId As ElementId,
	curveLoops As IList(Of CurveLoop)
) As BuildingPad

public:
static BuildingPad^ Create(
	Document^ document, 
	ElementId^ buildingPadTypeId, 
	ElementId^ levelId, 
	IList<CurveLoop^>^ curveLoops
)

static member Create : 
        document : Document * 
        buildingPadTypeId : ElementId * 
        levelId : ElementId * 
        curveLoops : IList<CurveLoop> -> BuildingPad

Parameters

Parameter	Type	Description
document	Document	The document to be modified.
buildingPadTypeId	ElementId	The type id set to the BuildingPad.
levelId	ElementId	The level id set to the BuildingPad.
curveLoops	IList	The boundary of the BuildingPad.

Return Value

Type	Description
BuildingPad	The new BuildingPad element.

Exceptions

Exception	Condition
ArgumentException	The buildingPadTypeId is not a valid type id for a BuildingPad. -or- The ElementId levelId is not a Level. -or- The input curve loops cannot compose a valid boundary, that means: no curve loop is contained in the given collection; these curve loops intersect with each other for some of them; or each curve loop is not closed individually; or each curve loop is not planar; or each curve loop is not in a plane parallel to the horizontal(XY) plane.
ArgumentNullException	A non-optional argument was null
InvalidOperationException	Failed to create the Sketch for the boundary of new created BuildingPad. -or- Cannot find an appropriate hosting topography surface for this BuildingPad. -or- This topography surface cannot be the host of this BuildingPad. -or- The given curve loops intersect with curve loops of existing BuildingPads hosted on the same TopographySurface. -or- There is at least one existing SubRegion which is completely inside or overlap the boundary of current BuildingPad hosted on the same TopographySurface. This behavior is not allowed.
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.