IQueryFilter与ISpatialFilter接口的使用

       在ArcGIS二次开发中，IQueryFilter和ISpatialFilter是最常用的查询接口。

一、IQueryFilter接口

        IQueryFilter接口用于属性查询。该接口提供了1个方法和3个属性。如AddField方法用于向输出字段集中添加一个字段，OutputSpatialReference属性用于获取给定字段的输出几何图形的空间参考，SubFields用于获取或设置输出几何图形的字段名称清单，WhereClause用于获取或设置查询过滤条件。

       对于IQueryFilter.SubFields这个属性之前一直是被我忽略的，后来在实际应用时才发现，SubFields属性可以用来提高性能。主要原理是：性能增益来自于获取所需的字段值，而不是每行的所有数据。

    SubFields的默认值为“*”，表示将返回所有字段值。将其设置回原始（默认）“*”可以通过将其设置为“*”或“”来完成。还可以是使用IQueryFilter.AddField方法向筛选字段集合中（SubFields）添加字段名。

/// <summary>
/// 
/// </summary>
/// <param name="pFeatureClass"></param>
public static void Test(IFeatureClass pFeatureClass)
{
    List<int> lisOids = new List<int>();
    using (ComReleaser comReleaser=new ComReleaser())
    {
        IQueryFilter queryFilter = new QueryFilterClass();
        queryFilter.SubFields = $"{pFeatureClass.ShapeFieldName},{pFeatureClass.OIDFieldName}";   //筛选器的字段名使用逗号分隔，此处设置的是获取“shape”和“OID”
        //queryFilter.AddField(pFeatureClass.OIDFieldName);   向筛选字段集合中添加字段名
        //queryFilter.WhereClause = $"{pFeatureClass.OIDFieldName}<1000"; 过滤条件
        IFeatureCursor pFeatureCursor = pFeatureClass.Search(queryFilter, true);
        IFeature pFeature = null;
        while ((pFeature = pFeatureCursor.NextFeature()) != null)
        {
            lisOids.Add(pFeature.OID);
        }
    }
}

当设置了SubFields后就获取不到被过滤掉的字段值了。

二、 ISpatialFilter接口

          ISpatialFilter继承了接口IQueryFilter，在属性查询的基础上加了要素与要素的空间关系进行查询。Geometry用于设置查询几何；SpatialRel设置查询的空间关系,具体可参考：GIS空间查询（SpatialFilter）时各种空间关系总结；
GeometryField设置查询的几何字段的名称;SearchOrder属性用于设置搜索顺序，仅仅在ArcSDE中起作用，通常空间查询优先于属性查询。

     其中SpatialFilterClass还继承了接口IQueryFilterDefinition2。

/// <summary>
/// 空间查询
/// </summary>
/// <param name="pFeatureClass">要素图层</param>
/// <param name="pGeometry">查询几何</param>
public static void UsingISpatialFilter(IFeatureClass pFeatureClass, IGeometry pGeometry)
{
    //创建属性查询
    ISpatialFilter pSpatialFilter = new SpatialFilterClass()
    {
        SubFields = "",  //设置查询字段
        WhereClause = "",  //过滤条件

        Geometry = pGeometry,   //设置查询几何
        SpatialRel = esriSpatialRelEnum.esriSpatialRelContains, //设置查询的空间关系
        GeometryField = pFeatureClass.ShapeFieldName,

        PostfixClause = $"ORDER BY {pFeatureClass.OIDFieldName} desc", //排序
    };

    //ISpatialFilter转为IQueryFilterDefinition接口后设置
    //IQueryFilterDefinition2 pQueryFilterDef2 = (IQueryFilterDefinition2)pSpatialFilter;
    //pQueryFilterDef2.PostfixClause = $"ORDER BY {pFeatureClass.OIDFieldName} desc";

    using (ComReleaser comReleaser = new ComReleaser())
    {
        IFeatureCursor pFeatureCursor = pFeatureClass.Search(pSpatialFilter, true);
        comReleaser.ManageLifetime(pFeatureCursor);
        IFeature pFeature = null;
        while ((pFeature = pFeatureCursor.NextFeature()) != null)
        {
            //
        }
    }
}

 

三、IQueryFilterDefinition接口

         可见IQueryFilter和ISpatialFilter只能执行简单的属性查询。若要执行复杂点的就需要使用IQueryDef接口查询或则转为IQueryFilterDefinition接口。IQueryFilterDefinition接口可设置Order By和Group By语句。

public void UsingIQueryFilterDefinition(IFeatureClass pFeatureClass)
{
    //创建属性查询
    IQueryFilter pQueryFilter = new QueryFilterClass();
    //转为IQueryFilterDefinition接口
    IQueryFilterDefinition2 pQueryFilterDef2 = (IQueryFilterDefinition2)pQueryFilter;
    pQueryFilterDef2.PostfixClause = $"ORDER BY {pFeatureClass.OIDFieldName} desc";  //追加查询子句
    using (ComReleaser comReleaser = new ComReleaser())
    {
        IFeatureCursor pFeatureCursor = pFeatureClass.Search(pQueryFilter, true);
        comReleaser.ManageLifetime(pFeatureCursor);
        IFeature pFeature = null;
        while ((pFeature = pFeatureCursor.NextFeature()) != null)
        {
            //
        }
    }
}