C# Класс SuperMap.Connector.Data

Data 组件接口,用以访问 SuperMap iServer 数据服务组件中的REST服务,封装了与空间数据相关的一系列功能。
只能对 SuperMap REST 接口类型服务的访问。 实例化Data对象时需要使用明确的数据服务组件地址(例如:http://localhost:8090/iserver/services/data-world/rest")
Показать файл Открыть проект Примеры использования класса

Открытые методы

Метод Описание
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 进行更新。

Описание методов

AddFeatures() публичный Метод

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

CopyDataset() публичный Метод

复制数据集。

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

参数 srcDatasourceName、srcDatasetName、destDatasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public CopyDataset ( string srcDatasourceName, string srcDatasetName, string destDatasetName ) : bool
srcDatasourceName string 源数据源名称,必设参数。
srcDatasetName string 源数据集名称,必设参数。
destDatasetName string 目标数据集名称,必设参数。
Результат bool

CopyDataset() публичный Метод

复制数据集。

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

参数 srcDatasourceName、srcDatasetName、destDatasourceName、destDatasetName 为空时抛出异常。 服务端处理错误时抛出异常。
public CopyDataset ( string srcDatasourceName, string srcDatasetName, string destDatasourceName, string destDatasetName ) : bool
srcDatasourceName string 源数据源名称,必设参数。
srcDatasetName string 源数据集名称,必设参数。
destDatasourceName string 目标数据源名称,必设参数。
destDatasetName string 目标数据集名称,必设参数。
Результат bool

CreateDataset() публичный Метод

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

CreateField() публичный Метод

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

Data() публичный Метод

构造函数。
参数 serviceUrl 为空时抛出异常。
public Data ( string serviceUrl ) : System
serviceUrl string SuperMap iServer 空间数据服务组件的URL地址。
Результат System

DeleteDataset() публичный Метод

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

DeleteFeatures() публичный Метод

在指定的数据集中删除一组要素。
public DeleteFeatures ( string datasourceName, string datasetName, int ids ) : EditResult
datasourceName string 数据源名称,必设参数。
datasetName string 数据集名称,必设参数。
ids int 待删除要素的 ID 数组,必设参数。
Результат EditResult

DeleteField() публичный Метод

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

GetDatasetInfo() публичный Метод

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

GetDatasourceInfo() публичный Метод

获取指定的某个数据源的信息。
参数 datasourceName 为空时抛出异常。 服务端处理错误时抛出异常。
public GetDatasourceInfo ( string datasourceName ) : DatasourceInfo
datasourceName string 数据源名称,必设参数。
Результат DatasourceInfo

GetDatasourceInfos() публичный Метод

获取所有数据源的信息。
服务端处理错误时抛出异常。
public GetDatasourceInfos ( ) : List
Результат List

GetFeature() публичный Метод

获取与指定几何对象具有特定空间查询模式的要素。
参数 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 时,返回全部字段。
Результат List

GetFeature() публичный Метод

获取与指定几何对象具有特定空间查询模式的要素。
参数 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 时,返回全部字段。
Результат List

GetFeature() публичный Метод

获取落在指定几何对象的缓冲区内的要素。
参数 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 时,返回全部字段。
Результат List

GetFeature() публичный Метод

获取落在指定空间对象的缓冲区内,并满足一定属性过滤条件的要素。
参数 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 时,返回全部字段。
Результат List

GetFeature() публичный Метод

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

GetFeature() публичный Метод

通过 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 最多可返回的要素数量。
Результат List

GetFeature() публичный Метод

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

GetFeature() публичный Метод

获取在指定空间范围内,并满足一定属性过滤条件的要素。
参数 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 时,返回全部字段。
Результат List

GetFeature() публичный Метод

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

GetFieldInfo() публичный Метод

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

GetFieldInfos() публичный Метод

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

Statistic() публичный Метод

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

UpdateDatasetInfo() публичный Метод

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

UpdateDatasourceInfo() публичный Метод

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

UpdateFeatures() публичный Метод

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

UpdateField() публичный Метод

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

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

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

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