API 增强功能

了解 API 的增强功能。

2025.2 版新特性

在以下功能区域中对 API 进行了更新：

• 添加了铁路超高曲线的铁路超高临界桩号下可用的新特性。
  • CANTCriticalStation::CantJerk。获取铁路超高临界桩号的“铁路超高突变”设置。
  • CANTCriticalStation::CantRatio。获取铁路超高临界桩号的“铁路超高比”设置。

  有关详细信息，请参见“铁路超高表格编辑器”对话框。

• 添加了 RailCANTInfo 结构下可用的新特性。
  • RailCANTInfo.LateralAcceleration
  • RailCANTInfo.CantGradient
  • RailCANTInfo.CurveRadius
  • RailCANTInfo.EquilibriumCant
  • RailCANTInfo.EquilibriumCantGradient
  • RailCANTInfo.EquilibriumCantVerticalSpeed
  • RailCANTInfo.CantDeficiency
  • RailCANTInfo.CantDeficiencyGradient
  • RailCANTInfo.CantDeficiencyVerticalSpeed
  • RailCANTInfo.CantRatio
  • RailCANTInfo.CantJerk
  • RailCANTInfo.VerticalSpeed
  • RailCANTInfo.DesignSpeed
• 提高了 RailCANTInfo 结构的性能。
• 为 ProfileViewBandItem 类更新了特性：
  • ProfileViewBandItem.Alingment2Id。设定纵断面图中铁路超高数据标注栏的次要路线。
  • ProfileViewBandItem.MaxDistance。设定纵断面图中铁路超高数据标注栏的最大偏移距离。

  有关标注栏特性的详细信息，请参见“标注栏”选项卡（“纵断面图特性”对话框）。

• 为 ProfileViewBandSetItem 类更新了特性：
  • ProfileViewBandSetItem::GetHorizontalGeometryPointsOptions()。获取“平曲线点”选项信息。
  • ProfileViewBandSetItem::SetHorizontalGeometryPointsOptions。设置“平曲线点”选项。

  有关标注栏中的曲线点的详细信息，请参见“要在标注栏中标记的曲线点”对话框。

• 重力管道的更新。
  • 添加了 API 类 CrossingPipeProfileLabel。
  • 添加了 ObjectIDCollection 方法：
    • CrossingPipeProfileLabel.Create(ObjectId profileViewPartId, ObjectId profileViewId, ObjectId labelStyleId);
    • CrossingPipeProfileLabel.Create(ObjectId profileViewPartId, ObjectId profileViewId);
    • GetAvailableLabelIds(ObjectId profileViewPartId, ObjectId profileViewId);}}

2025.1 版新特性

在以下功能区域中对 API 进行了更新：

• 添加了 PressurePart.SwapPartSize 用于交换压力管道、管件和设备附件的零件尺寸。
• 为 CANTCriticalStation 类添加了新特性：
  • CANTCriticalStation.DesignSpeed。获取铁路超高曲线的铁路超高临界桩号的设计速度。
  • CANTCriticalStation.CurveRadius。获取铁路超高曲线的铁路超高临界桩号的曲线半径。
  • CANTCriticalStation.EquilibriumCantGradient。获取铁路超高曲线的铁路超高临界桩号的铁路超高梯度。
  • CANTCriticalStation.CantDeficiencyGradient。获取铁路超高曲线的铁路超高临界桩号的欠超高梯度。
  • CANTCriticalStation.EquilibriumCantVerticalSpeed。获取铁路超高曲线的铁路超高临界桩号的平衡垂直速度。
  • CANTCriticalStation.CantDeficiencyVerticalSpeed。获取铁路超高曲线的铁路超高临界桩号的欠超高垂直速度。
• 为 ProfileViewBandItem 类添加了新特性：
  • ProfileViewBandItem.Alingment2Id。设定纵断面图中水平简图标注栏的次要路线。
  • ProfileViewBandItem.MaxDistance。设定纵断面图中水平简图标注栏的最大偏移距离。

  有关水平简图标注栏特性的详细信息，请参见“标注栏”选项卡（“纵断面图特性”对话框）。

• 为以下纵断面图方法添加了示例代码：
  • ProfileView.Create(ObjectId, Point3d)
  • ProfileView.Create(ObjectId, Point3d, SplitProfileViewCreationOptions)
  • ProfileView.Create(ObjectId, Point3d, StackedProfileViewsCreationOptions)
  • ProfileView.Create(ObjectId, Point3d, StackedProfileViewsCreationOptions, SplitProfileViewCreationOptions)
  • ProfileView.Create(CivilDocument, String, ObjectId, ObjectId, Point3d)
  • ProfileView.Create(CivilDocument, String, String, String, Point3d)
  • ProfileView.Create(ObjectId, Point3d, String, ObjectId, ObjectId)
  • ProfileView.Create(ObjectId, Point3d, String, ObjectId, StackedProfileViewsCreationOptions)
  • ProfileView.Create(ObjectId, Point3d, String, ObjectId, ObjectId, SplitProfileViewCreationOptions)
  • ProfileView.Create(ObjectId, Point3d, String, ObjectId, StackedProfileViewsCreationOptions, SplitProfileViewCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, MultipleProfileViewsCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, StackedProfileViewsCreationOptions, MultipleProfileViewsCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, MultipleProfileViewsCreationOptions, SplitProfileViewCreationOptions, ProfileViewDatumType)
  • ProfileView.CreateMultiple(ObjectId, Point3d, StackedProfileViewsCreationOptions, MultipleProfileViewsCreationOptions, SplitProfileViewCreationOptions, ProfileViewDatumType)
  • ProfileView.CreateMultiple(ObjectId, Point3d, String, ObjectId, ObjectId, MultipleProfileViewsCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, String, ObjectId, StackedProfileViewsCreationOptions, MultipleProfileViewsCreationOptions)
  • ProfileView.CreateMultiple(ObjectId, Point3d, String, ObjectId, ObjectId, MultipleProfileViewsCreationOptions, SplitProfileViewCreationOptions, ProfileViewDatumType)
  • ProfileView.CreateMultiple(ObjectId, Point3d, String, ObjectId, StackedProfileViewsCreationOptions, MultipleProfileViewsCreationOptions, SplitProfileViewCreationOptions, ProfileViewDatumType)

  有关纵断面图方法的详细信息，请参见纵断面图方法。

2025 版新特性

在以下功能区域中对 API 进行了更新：

• 支持 .NET 8.0 Framework。
• 增加了对曲面详细级别要素的 .NET API 支持。有关详细信息，请参见修改曲面的详细级别。
  • Surface.IsLevelOfDetailEnabled。获取和设定曲面详细级别状态。
  • SettingsSurface.Defaults.LevelOfDetail。获取曲面详细级别默认设置的特性。

有关详细信息，请参见 Autodesk Civil 3D API 中的新功能。