通过线数据集数组和点数据集数组(可选)构建网络数据集,可以设置保存的非系统字段及打断模式。

命名空间:  SuperMap.Analyst.NetworkAnalyst
程序集:  SuperMap.Analyst.NetworkAnalyst (in SuperMap.Analyst.NetworkAnalyst)
版本: dll

语法

C#
public static DatasetVector BuildNetwork(
	DatasetVector[] lineDatasets,
	DatasetVector[] pointDatasets,
	string[] lineFieldNames,
	string[] pointFieldNames,
	Datasource outputDatasource,
	string networkDatasetName,
	NetworkSplitMode networkSplitMode,
	double tolerance
)

参数

lineDatasets
Type: array< SuperMap.Data..::.DatasetVector >[]()[]
指定的用于构建网络数据集的线数据集数组。
pointDatasets
Type: array< SuperMap.Data..::.DatasetVector >[]()[]
指定的用于构建网络数据集的点数据集数组。可选。
lineFieldNames
Type: array< System..::.String >[]()[]
指定的结果网络数据集中需要保存的线数据集数组中的非系统字段名称的数组。
pointFieldNames
Type: array< System..::.String >[]()[]
指定的结果网络数据集中需要保存的点数据集数组中的非系统字段名称的数组。
outputDatasource
Type: SuperMap.Data..::.Datasource
指定的用于存储结果数据集的数据源。
networkDatasetName
Type: System..::.String
指定的结果网络数据集的名称。
networkSplitMode
Type: SuperMap.Analyst.NetworkAnalyst..::.NetworkSplitMode
指定的打断模式。
tolerance
Type: System..::.Double
指定的用于判定点是否为网络数据集上的节点的容限值(也可理解为打断容限)。当打断模式为拓扑处理方式(即 NetworkSplitMode.TopologyProcessing)时,该值即为进行拓扑处理操作所使用的容限值。单位与用于构建网络数据集的点、线数据集的单位相同。

返回值

构建的网络数据集。

备注

注意:

  1. 线数据集数组必须至少包含一个元素,而点数据集数组是可选的,如果将 pointDatasets 指定为一个空数组,此时,将通过多个线数据集来构建网络数据集。显然,此时无论采用哪种打断方式,都只会在线线相交处打断。
  2. 参与构建的点数据集的点对象不是全部都会添加到网络数据集中,只有在线上的点对象是有效的参与点(点线距离在指定的容限范围内);
  3. 指定了点数据集的保留字段后,只有点数据集的有效参与点的这些字段的值将赋给对应的网络结点,其他结点的相应字段信息为0或空。

异常

异常条件
System..::.ArgumentNullExceptionlineDatasets 为 null。
System..::.ArgumentExceptionlineDatasets 长度为 0。
System..::.ArgumentExceptiontolerance 小于 0。

版本信息

SuperMap iObjects .NET


请参见