UndergroundStorageSetStageDesign Method

Sets the stage design table for the underground storage.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDrainageDesignMgd (in AeccDrainageDesignMgd.dll) Version: 13.9.960.0
Syntax
Copy
public void SetStageDesign(
	StageDesignCollection designTable
)

Parameters

designTable  StageDesignCollection
The design table to set. Must not be null and contain at least 2 records.
Exceptions
ExceptionCondition
ArgumentNullException Thrown when "designTable" is null. Parameter name: designTable
ArgumentException Thrown when the design table contains less than 2 records, or when the footprint areas in the design table records are not all the same. Parameter name: designTable
InvalidOperationException Thrown when the underground storage geometry has changed since the design table was retrieved, causing a mismatch in footprint areas. Call GetStageDesign() again to refresh the data.
Remarks
For underground storage facilities, all footprint areas in the design table must be identical due to the uniform cross-sectional nature of underground storage systems. This method validates that all records have the same footprint area before setting the design table.

Requirements:

  • Stage design data collection (design table) must contain at least 2 records/items to define a valid storage curve
  • All footprint areas must be identical (uniform cross-section)
  • Geometry must not have changed since table was retrieved

If the underground storage geometry has been modified since the design table was last retrieved, this method will throw an InvalidOperationException to ensure data consistency. Users should call GetStageDesign() again to get the updated table with current geometry.

This method is only available for UndergroundStorage objects, not for Pond objects. Naming aligns with GetStageStorage for consistency.

Additionally, this method synchronizes the UGS geometry (depth, top elevation, bottom elevation) with the design table depth to maintain consistency between the design table and physical geometry.

See Also