Creates a new Corridor object.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDbMgd (in AeccDbMgd.dll) Version: 10.3.488.0

Syntax

C#
public ObjectId Add(
	string corridorName,
	string baselineName,
	ObjectId alignmentId,
	ObjectId profileId,
	string baselineRegionName,
	ObjectId assemblyId
)
Visual Basic
Public Function Add ( _
	corridorName As String, _
	baselineName As String, _
	alignmentId As ObjectId, _
	profileId As ObjectId, _
	baselineRegionName As String, _
	assemblyId As ObjectId _
) As ObjectId
Visual C++
public:
ObjectId Add(
	String^ corridorName, 
	String^ baselineName, 
	ObjectId alignmentId, 
	ObjectId profileId, 
	String^ baselineRegionName, 
	ObjectId assemblyId
)

Parameters

corridorName
Type: System..::..String
Name of the Corridor to be created.
baselineName
Type: System..::..String
Name of the Baseline to be created.
alignmentId
Type: ObjectId
ObjectId of the Alignment used to create the Baseline.
profileId
Type: ObjectId
ObjectId of the Profile used to create the Baseline.
baselineRegionName
Type: System..::..String
Name of the BaselineRegion to be created.
assemblyId
Type: ObjectId
ObjectId of the Assembly used to create the region.

Remarks

This method creates a new Corridor object. It allows you to specify the Corridor object name, the new Baseline name, the Alignment and Profile ids used to create the Baseline, a region name for a new BaselineRegion to be created, and the Assembly id to be used within the region.

The specified Profile object must belong to the specified Alignment.

Exceptions

ExceptionCondition
System..::..ArgumentException

This exception is thrown if corridorName is empty or becomes empty after it is trimmed (removing all leading and trailing blank spaces) or a Corridor with the same name already exists. The Corridor name is case-sensitive; threfore, "Corridor - 1" will not match "corridor - 1". This practice is not recommended.

This exception is also thrown if the baselineName is empty or becomes empty after it is trimmed (removing all leading and trailing blank spaces).

This exception is also thrown if the specified alignmentId does not reference an Alignment object, the Alignment instance belongs to a different drawing, or it is ObjectId.Null.

This exception is also thrown if the specified profileId does not reference a Profile object, the Profile object instance is not owned by the specified Alignment, or the Profile object belongs to a different drawing.

This exception is also thrown if the specified baselineRegionName is empty or becomes empty after trimming (removing leading and trailing blank spaces).

This exception is also thrown if the specified assemblyId is ObjectId.Null or does not reference an instance of an Assembly object.

System..::..ArgumentNullException

This exception is thrown if the corridorName or the baselineName spefified are null.

This exception is also thrown if the specified baselineRegionName is null.

See Also