C# Class SuperMap.Connector.Data

Data 组件接口，用以访问 SuperMap iServer 数据服务组件中的REST服务，封装了与空间数据相关的一系列功能。
只能对 SuperMap REST 接口类型服务的访问。 实例化Data对象时需要使用明确的数据服务组件地址(例如：http://localhost:8090/iserver/services/data-world/rest")
ファイルを表示 Open project: SuperMap/iClient-for-DotNet Class Usage Examples

Public Methods

Method Description
AddFeatures ( string datasourceName, String datasetName, List targetFeatures ) : EditResult

在指定数据集中增加一组同类型的要素。
CopyDataset ( string srcDatasourceName, string srcDatasetName, string destDatasetName ) : bool

复制数据集。

在指定的源数据源中，复制指定的源数据集。
CopyDataset ( string srcDatasourceName, string srcDatasetName, string destDatasourceName, string destDatasetName ) : bool

复制数据集。

从指定的源数据源中，复制指定的源数据集到指定的目标数据源中的目标数据集。
CreateDataset ( string datasourceName, string datasetName, DatasetType datasetType ) : bool

在指定的数据源中，根据指定的数据集信息创建一个新的数据集。
CreateField ( string datasourceName, string datasetName, FieldInfo fieldInfo ) : bool

在指定的数据集下创建新的字段。

只能在空数据集中进行创建字段的操作。

Data ( string serviceUrl ) : System

构造函数。
DeleteDataset ( string datasourceName, string datasetName ) : bool

在指定的数据源中，根据指定的数据集信息删除一个数据集。
DeleteFeatures ( string datasourceName, string datasetName, int ids ) : EditResult

在指定的数据集中删除一组要素。
DeleteField ( string datasourceName, string datasetName, string fieldName ) : bool

删除指定数据集下的字段。

只能在空数据集中进行删除字段的操作。

GetDatasetInfo ( string datasourceName, string datasetName ) : DatasetInfo

获取指定数据源的指定数据集信息。
GetDatasourceInfo ( string datasourceName ) : DatasourceInfo

获取指定的某个数据源的信息。
GetDatasourceInfos ( ) : List

获取所有数据源的信息。
GetFeature ( string datasetNames, Geometry geometry, SpatialQueryMode spatialQueryMode, string fields ) : List

获取与指定几何对象具有特定空间查询模式的要素。
GetFeature ( string datasetNames, Geometry geometry, SpatialQueryMode spatialQueryMode, string attributeFilter, string fields ) : List

获取与指定几何对象具有特定空间查询模式的要素。
GetFeature ( string datasetNames, Geometry geometry, double bufferDistance, string fields ) : List

获取落在指定几何对象的缓冲区内的要素。
GetFeature ( string datasetNames, Geometry geometry, double bufferDistance, string attributeFilter, string fields ) : List

获取落在指定空间对象的缓冲区内，并满足一定属性过滤条件的要素。
GetFeature ( string datasetNames, QueryParameter queryParam ) : List

通过 SQL 查询条件获取要素。
GetFeature ( string datasetNames, QueryParameter queryParam, int maxFeatures ) : List

通过 SQL 查询条件获取要素。
GetFeature ( string datasetNames, Rectangle2D bounds, string fields ) : List

获取在指定空间范围内的要素。
GetFeature ( string datasetNames, Rectangle2D bounds, string attributeFilter, string fields ) : List

获取在指定空间范围内，并满足一定属性过滤条件的要素。
GetFeature ( string datasetNames, int ids, string fields ) : List

根据指定要素 ID 获取指定数据集中的要素。
GetFieldInfo ( string datasourceName, string datasetName, string fieldName ) : FieldInfo

获取指定数据集下字段的字段信息。
GetFieldInfos ( string datasourceName, string datasetName ) : List

获取指定数据集的所有字段信息。
Statistic ( string datasourceName, string datasetName, string fieldName, StatisticMode statisticMode ) : double

在指定的数据集中，根据指定的统计方法对指定字段进行统计计算。
UpdateDatasetInfo ( string datasourceName, string datasetName, DatasetInfo newDatasetInfo ) : bool

在指定的数据源中，更新指定数据集的信息。

现支持更新IsFileCache，Description，PrjCoordSys，Charset，Palette，NoValue 属性。

UpdateDatasourceInfo ( string datasourceName, DatasourceInfo newDatasourceInfo ) : bool

用新的数据源信息更新原来的数据源信息。

只能对数据源信息中的 CoordUnit、Description、DistanceUnit" 进行更新。

UpdateFeatures ( string datasourceName, string datasetName, List targetFeatures ) : EditResult

在指定的数据集中，更新一组要素。 参数 targetFeatures 是新要素列表，其要素 ID 与数据集中待更新的要素 ID 相同，根据 ID 查找到待更新的要素， 然后将原要素更新到新的要素。
UpdateField ( string datasourceName, string datasetName, string fieldName, FieldInfo newFiledInfo ) : bool

更新指定数据集的字段信息。

只能在空数据集中进行更新字段的操作。

只能对字段的别名 Caption 进行更新。

Method Details

AddFeatures() public method

在指定数据集中增加一组同类型的要素。
public AddFeatures ( string datasourceName, String datasetName, List targetFeatures ) : EditResult
datasourceName string 数据源名称，必设参数。
datasetName String 数据集名称，必设参数。
targetFeatures List 待添加的要素列表，列表中的要素必须是同一种类型，必设参数。
return EditResult

CopyDataset() public method

复制数据集。

在指定的源数据源中，复制指定的源数据集。

参数 srcDatasourceName、srcDatasetName、destDatasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public CopyDataset ( string srcDatasourceName, string srcDatasetName, string destDatasetName ) : bool
srcDatasourceName string 源数据源名称，必设参数。
srcDatasetName string 源数据集名称，必设参数。
destDatasetName string 目标数据集名称，必设参数。
return bool

CopyDataset() public method

复制数据集。

从指定的源数据源中，复制指定的源数据集到指定的目标数据源中的目标数据集。

参数 srcDatasourceName、srcDatasetName、destDatasourceName、destDatasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public CopyDataset ( string srcDatasourceName, string srcDatasetName, string destDatasourceName, string destDatasetName ) : bool
srcDatasourceName string 源数据源名称，必设参数。
srcDatasetName string 源数据集名称，必设参数。
destDatasourceName string 目标数据源名称，必设参数。
destDatasetName string 目标数据集名称，必设参数。
return bool

CreateDataset() public method

在指定的数据源中，根据指定的数据集信息创建一个新的数据集。
参数 datasourceName、datasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public CreateDataset ( string datasourceName, string datasetName, DatasetType datasetType ) : bool
datasourceName string 数据源名称，必选参数。
datasetName string 数据集名称，必选参数。
datasetType DatasetType 数据集类型。目前支持六种枚举值：POINT、LINE、REGION、TEXT、CAD、TABULAR。
return bool

CreateField() public method

在指定的数据集下创建新的字段。
只能在空数据集中进行创建字段的操作。
参数 datasourceName、datasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public CreateField ( string datasourceName, string datasetName, FieldInfo fieldInfo ) : bool
datasourceName string 数据源名称，必设参数。
datasetName string 数据集名称，必设参数。
fieldInfo FieldInfo 字段信息。
return bool

Data() public method

构造函数。
参数 serviceUrl 为空时抛出异常。
public Data ( string serviceUrl ) : System
serviceUrl string SuperMap iServer 空间数据服务组件的URL地址。
return System

DeleteDataset() public method

在指定的数据源中，根据指定的数据集信息删除一个数据集。
参数 datasourceName、datasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public DeleteDataset ( string datasourceName, string datasetName ) : bool
datasourceName string 数据源名称。
datasetName string 数据集名称。
return bool

DeleteFeatures() public method

在指定的数据集中删除一组要素。
public DeleteFeatures ( string datasourceName, string datasetName, int ids ) : EditResult
datasourceName string 数据源名称，必设参数。
datasetName string 数据集名称，必设参数。
ids int 待删除要素的 ID 数组，必设参数。
return EditResult

DeleteField() public method

删除指定数据集下的字段。
只能在空数据集中进行删除字段的操作。
参数 datasourceName、datasetName、fieldName 为空时抛出异常。 服务端处理错误时抛出异常。
public DeleteField ( string datasourceName, string datasetName, string fieldName ) : bool
datasourceName string 数据源名称，必设参数。
datasetName string 数据集名称，必设参数。
fieldName string 字段名称，必设参数。
return bool

GetDatasetInfo() public method

获取指定数据源的指定数据集信息。
参数 datasourceName、datasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public GetDatasetInfo ( string datasourceName, string datasetName ) : DatasetInfo
datasourceName string 数据源名称，必选参数。
datasetName string 数据集名称，必选参数。
return DatasetInfo

GetDatasourceInfo() public method

获取指定的某个数据源的信息。
参数 datasourceName 为空时抛出异常。 服务端处理错误时抛出异常。
public GetDatasourceInfo ( string datasourceName ) : DatasourceInfo
datasourceName string 数据源名称，必设参数。
return DatasourceInfo

GetDatasourceInfos() public method

获取所有数据源的信息。
服务端处理错误时抛出异常。
public GetDatasourceInfos ( ) : List
return List

GetFeature() public method

获取与指定几何对象具有特定空间查询模式的要素。
参数 datasetNames、geometry 为空时抛出异常。 服务端处理错误时抛出异常。
public GetFeature ( string datasetNames, Geometry geometry, SpatialQueryMode spatialQueryMode, string fields ) : List
datasetNames string 数据集名称数组(datasourceName:datasetName)，如 World:Capitals，必选参数。
geometry Geometry 几何对象。
spatialQueryMode SpatialQueryMode 空间查询模式。
fields string 待返回的字段数组。当该参数为 null 时，返回全部字段。
return List

GetFeature() public method

获取与指定几何对象具有特定空间查询模式的要素。
参数 datasetNames、geometry 为空时抛出异常。 服务端处理错误时抛出异常。
public GetFeature ( string datasetNames, Geometry geometry, SpatialQueryMode spatialQueryMode, string attributeFilter, string fields ) : List
datasetNames string 数据集名称数组(datasourceName:datasetName)，如 World:Capitals，必选参数。
geometry Geometry 几何对象。
spatialQueryMode SpatialQueryMode 空间查询模式。
attributeFilter string 属性过滤条件。
fields string 待返回的字段数组。当该参数为 null 时，返回全部字段。
return List

GetFeature() public method

获取落在指定几何对象的缓冲区内的要素。
参数 datasetNames、geometry 为空时抛出异常。 参数 bufferDistance 小于等于0时抛出异常。 服务端处理错误时抛出异常。
public GetFeature ( string datasetNames, Geometry geometry, double bufferDistance, string fields ) : List
datasetNames string 数据集名称数组(datasourceName:datasetName)，如 World:Capitals，必选参数。
geometry Geometry 几何对象。
bufferDistance double 缓冲区的半径，单位同当前数据集坐标单位（coordUnit）。
fields string 待返回的字段数组。当该参数为 null 时，返回全部字段。
return List

GetFeature() public method

获取落在指定空间对象的缓冲区内，并满足一定属性过滤条件的要素。
参数 datasetNames、geometry 为空时抛出异常。 参数 bufferDistance 小于等于0时抛出异常。 服务端处理错误时抛出异常。
public GetFeature ( string datasetNames, Geometry geometry, double bufferDistance, string attributeFilter, string fields ) : List
datasetNames string 数据集名称数组(datasourceName:datasetName)，如 World:Capitals，必选参数。
geometry Geometry 几何对象。
bufferDistance double 缓冲区的半径，单位同当前数据集坐标单位（coordUnit）。
attributeFilter string 属性查询过滤条件。如 fieldValue < 100，name like '%酒店%'。
fields string 待返回的字段数组。当该参数为 null 时，返回全部字段。
return List

GetFeature() public method

通过 SQL 查询条件获取要素。
参数 datasetNames 为空时抛出异常。 服务端处理错误时抛出异常。
public GetFeature ( string datasetNames, QueryParameter queryParam ) : List
datasetNames string /// 数据集名称数组(datasourceName:datasetName),必选参数。 /// 数据集名称由数据源名和数据集名构成，例如 World 数据源下的 Ocean 数据集，这里的数据集名称就是“World:Ocean”。 ///
queryParam SuperMap.Connector.Utility.QueryParameter 查询参数。
return List

GetFeature() public method

通过 SQL 查询条件获取要素。
参数 datasetNames 为空时抛出异常。 服务端处理错误时抛出异常。
public GetFeature ( string datasetNames, QueryParameter queryParam, int maxFeatures ) : List
datasetNames string /// 数据集名称数组(datasourceName:datasetName),必选参数。 /// 数据集名称由数据源名和数据集名构成，例如 World 数据源下的 Ocean 数据集，这里的数据集名称就是“World:Ocean”。 ///
queryParam SuperMap.Connector.Utility.QueryParameter 查询参数。
maxFeatures int 最多可返回的要素数量。
return List

GetFeature() public method

获取在指定空间范围内的要素。
参数 datasetNames、bounds 为空时抛出异常。 服务端处理错误时抛出异常。
public GetFeature ( string datasetNames, Rectangle2D bounds, string fields ) : List
datasetNames string 数据集名称数组(datasourceName:datasetName)，如 World:Capitals，必选参数。
bounds Rectangle2D 指定的查询范围。
fields string 待返回的字段数组。当该参数为 null 时，返回全部字段。
return List

GetFeature() public method

获取在指定空间范围内，并满足一定属性过滤条件的要素。
参数 datasetNames、bounds 为空时抛出异常。 服务端处理错误时抛出异常。
public GetFeature ( string datasetNames, Rectangle2D bounds, string attributeFilter, string fields ) : List
datasetNames string 数据集名称数组(datasourceName:datasetName)，如 World:Capitals，必选参数。
bounds Rectangle2D 指定的查询范围。
attributeFilter string 属性过滤条件。
fields string 待返回的字段数组。当该参数为 null 时，返回全部字段。
return List

GetFeature() public method

根据指定要素 ID 获取指定数据集中的要素。
参数 datasetNames、ids 为空时抛出异常。 服务端处理错误时抛出异常。
public GetFeature ( string datasetNames, int ids, string fields ) : List
datasetNames string 数据集名称数组(datasourceName:datasetName)，如 World:Capitals，必选参数。
ids int 要素 ID。
fields string 待返回的字段数组。当该参数为 null 时，返回全部字段。
return List

GetFieldInfo() public method

获取指定数据集下字段的字段信息。
参数 datasourceName、datasetName、fieldName 为空时抛出异常。 服务端处理错误时抛出异常。
public GetFieldInfo ( string datasourceName, string datasetName, string fieldName ) : FieldInfo
datasourceName string 数据源名称，必设参数。
datasetName string 数据集名称，必设参数。
fieldName string 字段名称，必设参数。
return FieldInfo

GetFieldInfos() public method

获取指定数据集的所有字段信息。
参数 datasourceName、datasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public GetFieldInfos ( string datasourceName, string datasetName ) : List
datasourceName string 数据源名称，必设参数。
datasetName string 数据集名称，必设参数。
return List

Statistic() public method

在指定的数据集中，根据指定的统计方法对指定字段进行统计计算。
参数 datasourceName、datasetName、fieldName 为空时抛出异常。 服务端处理错误时抛出异常。
public Statistic ( string datasourceName, string datasetName, string fieldName, StatisticMode statisticMode ) : double
datasourceName string 数据源名称，必设参数。
datasetName string 数据集名称，必设参数。
fieldName string 字段名称，必设参数。
statisticMode StatisticMode 统计方法。
return double

UpdateDatasetInfo() public method

在指定的数据源中，更新指定数据集的信息。
现支持更新IsFileCache，Description，PrjCoordSys，Charset，Palette，NoValue 属性。
参数 datasourceName、datasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public UpdateDatasetInfo ( string datasourceName, string datasetName, DatasetInfo newDatasetInfo ) : bool
datasourceName string 数据源名称。
datasetName string 待更新的数据集的名称。
newDatasetInfo DatasetInfo 新的数据集信息。
return bool

UpdateDatasourceInfo() public method

用新的数据源信息更新原来的数据源信息。
只能对数据源信息中的 CoordUnit、Description、DistanceUnit" 进行更新。
参数 datasourceName 为空时抛出异常。 服务端处理错误时抛出异常。
public UpdateDatasourceInfo ( string datasourceName, DatasourceInfo newDatasourceInfo ) : bool
datasourceName string 数据源名称，必设参数。
newDatasourceInfo DatasourceInfo 新的数据源信息。
return bool

UpdateFeatures() public method

在指定的数据集中，更新一组要素。 参数 targetFeatures 是新要素列表，其要素 ID 与数据集中待更新的要素 ID 相同，根据 ID 查找到待更新的要素， 然后将原要素更新到新的要素。
public UpdateFeatures ( string datasourceName, string datasetName, List targetFeatures ) : EditResult
datasourceName string 数据源名称，必设参数。
datasetName string 数据源名称，必设参数。
targetFeatures List 新要素列表。其 ID 与要更新的要素 ID 相同，必设参数。
return EditResult

UpdateField() public method

更新指定数据集的字段信息。

只能在空数据集中进行更新字段的操作。

只能对字段的别名 Caption 进行更新。

参数 datasourceName、datasetName、fieldName、newFiledInfo 为空时抛出异常。 服务端处理错误时抛出异常。
public UpdateField ( string datasourceName, string datasetName, string fieldName, FieldInfo newFiledInfo ) : bool
datasourceName string 数据源名称，必设参数。
datasetName string 数据集名称，必设参数。
fieldName string 字段名称，必设参数。
newFiledInfo FieldInfo 新的字段信息，必设参数。
return bool