大网数据广告活动
.NET 与 C# 开发

自定义筛选器

· 52CE 我爱测

借助自定义筛选器,您可以定义无法通过系统提供的消息筛选器实现的匹配逻辑。 例如,您可以创建这样的自定义筛选器:该筛选器散列特定的消息元素,然后检查元素值以确定该筛选器应返回 true 还是 false。

借助自定义筛选器,您可以定义无法通过系统提供的消息筛选器实现的匹配逻辑。 例如,您可以创建这样的自定义筛选器:该筛选器散列特定的消息元素,然后检查元素值以确定该筛选器应返回 true 还是 false。

实现

自定义筛选器是 xref:System.ServiceModel.Dispatcher.MessageFilter 抽象基类的实现。 当实现自定义筛选器时,构造函数可以选择接受一个字符串参数。 该参数包含传递到 MessageFilter 构造函数的配置信息,以便提供筛选器为执行匹配而在运行时需要的任何值或配置。 例如,该参数可用于提供筛选器在要进行求值的消息中查找的值。 下面的示例演示接受字符串参数的自定义消息筛选器的基本实现:

public class MyMessageFilter: MessageFilter  
{  
    string filterData;  
    public MyMessageFilter(string filterData)  
    {  
        if(string.IsNullOrEmpty(filterData)  
            throw new ArgumentNullException("filterData");  
        this.filterData=filterData;  
    }  
    public override bool Match(System.ServiceModel.Channels.Message message)  
    {  
        ...  
        return retValue;  
    }  
    public override bool Match(System.ServiceModel.Channels.MessageBuffer buffer)  
    {  
        ...  
        return retValue;  
    }  
}  

Note: 在实际实现中,Match 方法包含将检查消息,以确定是否应返回此消息筛选器的逻辑 ,则返回 true或false。

性能

实现自定义筛选器时,应考虑筛选器完成消息评估所需要的最长时间,这十分重要。 由于某个消息可能需通过多个筛选器进行评估才能找到匹配项,因此应确保客户端请求在评估完所有筛选器之前不会超时,这十分重要。 因此,自定义筛选器只应包含评估消息的内容或特性所需的代码,以便确定消息是否匹配筛选条件。

一般而言,在实现自定义筛选器时,应避免以下情况:

  • IO,如将数据保存到磁盘或数据库。

  • 不必要的处理,如循环访问文档中的多个记录。

  • 阻止操作,如涉及获取共享资源上的锁的调用或涉及对数据库执行查找的调用。

在生产环境中使用自定义筛选器之前,应运行性能测试以确定筛选器评估消息所花费的平均时间长度。 与筛选器表中使用的其他筛选器的平均处理时间相结合,您便可精确确定客户端应用程序应指定的最大超时值。

用法

若要对路由服务使用自定义筛选器,您必须将其添加到筛选器表通过指定新筛选器条目类型的"自定义,"消息筛选器的完全限定的类型名称和您的程序集的名称。 与其他 MessageFilter 一样,您可以指定将传递到自定义筛选器的构造函数中的字符串 filterData。

下面的示例演示如何对路由服务使用自定义筛选器:

<!--ROUTING SECTION -->  
<routing>  
  <filters>  
    <filter name="CustomFilter1" filterType="Custom"   
            customType="CustomAssembly.MyMessageFilter,   
            CustomAssembly" filterData="custom data" />  
  </filters>  
  <filterTables>  
    <table name="routingTable1">  
      <filters>  
        <add filterName="CustomFilter1" endpointName="CalculatorService" />  
      </filters>  
    </table>  
  </filterTables>  
</routing>  
RoutingConfiguration rc = new RoutingConfiguration();  
List<ServiceEndpoint> endpointList = new List<ServiceEndpoint>();  
endpointList.Add(client);  
rc.FilterTable.Add(new MyMessageFilter("CustomData"), endpointList);  

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。