XPathMessageFilterTable<TFilterData>.GetMatchingFilters Метод

Определение

Пространство имен:

System.ServiceModel.Dispatcher

Сборка:

System.ServiceModel.dll

Возвращает значение, указывающее, удовлетворяет ли заданный XML документ критерию соответствия хотя бы одного фильтра, и добавляет соответствующие фильтры в коллекцию.

Перегрузки

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)	Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия хотя бы одного SeekableXPathNavigator, и добавляет соответствующие фильтры в коллекцию.
GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)	Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия хотя бы одного XPathNavigator, и добавляет соответствующие фильтры в коллекцию.
GetMatchingFilters(Message, ICollection<MessageFilter>)	Возвращает значение, указывающее, удовлетворяет ли заданное сообщение критерию соответствия хотя бы одного XPathMessageFilter, и добавляет соответствующие фильтры в коллекцию.
GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)	Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия хотя бы одного XPathMessageFilter, и добавляет соответствующие фильтры в коллекцию.

Комментарии

Используйте этот метод, если предполагается, что несколько фильтров будут удовлетворять условиям сообщения, и эти фильтры требуются.

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)

Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия хотя бы одного SeekableXPathNavigator, и добавляет соответствующие фильтры в коллекцию.

public:
 bool GetMatchingFilters(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

member this.GetMatchingFilters : System.ServiceModel.Dispatcher.SeekableXPathNavigator * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (navigator As SeekableXPathNavigator, results As ICollection(Of MessageFilter)) As Boolean

Параметры

navigator

SeekableXPathNavigator

Объект SeekableXPathNavigator для проверки.

results

ICollection<MessageFilter>

Ссылочный параметр, в котором хранятся объекты MessageFilter, соответствующие условиям фильтра ICollection<T><Filter>.

Возвращаемое значение

Boolean

true, если параметр messageBuffer удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.

Исключения

ArgumentNullException

Параметр navigator или results имеет значение null.

Комментарии

Используйте этот метод, если предполагается, что несколько фильтров будут удовлетворять условиям навигатора, и эти фильтры требуются.

Если ожидается, что сообщению будет соответствовать только один фильтр, то используйте метод GetMatchingFilter.

GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)

Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия хотя бы одного XPathNavigator, и добавляет соответствующие фильтры в коллекцию.

public:
 bool GetMatchingFilters(System::Xml::XPath::XPathNavigator ^ navigator, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.Xml.XPath.XPathNavigator navigator, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

member this.GetMatchingFilters : System.Xml.XPath.XPathNavigator * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (navigator As XPathNavigator, results As ICollection(Of MessageFilter)) As Boolean

Параметры

navigator

XPathNavigator

Объект XPathNavigator для проверки.

results

ICollection<MessageFilter>

Ссылочный параметр, в котором хранятся объекты MessageFilter, соответствующие условиям фильтра ICollection<T><Filter>.

Возвращаемое значение

Boolean

true, если параметр messageBuffer удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.

Исключения

ArgumentNullException

Параметр navigator или results имеет значение null.

Комментарии

Используйте этот метод, если предполагается, что несколько фильтров будут удовлетворять сообщению, указанному в XPathNavigator, и эти фильтры требуются.

Если ожидается, что сообщению будет соответствовать только один фильтр, то используйте метод GetMatchingFilter.

GetMatchingFilters(Message, ICollection<MessageFilter>)

Возвращает значение, указывающее, удовлетворяет ли заданное сообщение критерию соответствия хотя бы одного XPathMessageFilter, и добавляет соответствующие фильтры в коллекцию.

public:
 virtual bool GetMatchingFilters(System::ServiceModel::Channels::Message ^ message, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (message As Message, results As ICollection(Of MessageFilter)) As Boolean

Параметры

message

Message

Объект Message для проверки.

results

ICollection<MessageFilter>

Ссылочный параметр, в котором хранятся объекты MessageFilter, соответствующие условиям фильтра ICollection<T><Filter>.

Возвращаемое значение

Boolean

true, если параметр message удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.

Реализации

GetMatchingFilters(Message, ICollection<MessageFilter>)

Исключения

ArgumentNullException

Параметр message или results имеет значение null.

InvalidBodyAccessException

Была предпринята попытка проверить содержимое тела сообщения с помощью фильтра.

Комментарии

Используйте этот метод, если предполагается, что несколько фильтров будут удовлетворять условиям сообщения, и эти фильтры требуются.

Фильтрам в таблице не разрешается проверять текст сообщения.

Объекты XPathMessageFilter, соответствующие запросу, хранятся в параметре results коллекции ICollection<T>. Параметр FilterData затем может быть восстановлен из таблицы фильтров путем использования этих фильтров в качестве ключей с методами, предоставляемыми словарем IDictionary<TKey,TValue>.

Этот метод реализует GetMatchingFilters.

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия хотя бы одного XPathMessageFilter, и добавляет соответствующие фильтры в коллекцию.

public:
 virtual bool GetMatchingFilters(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.MessageBuffer messageBuffer, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (messageBuffer As MessageBuffer, results As ICollection(Of MessageFilter)) As Boolean

Параметры

messageBuffer

MessageBuffer

Объект MessageBuffer для проверки.

results

ICollection<MessageFilter>

Ссылочный параметр, в котором хранятся объекты MessageFilter, соответствующие условиям фильтра ICollection<T><Filter>.

Возвращаемое значение

Boolean

true, если параметр messageBuffer удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.

Реализации

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

Исключения

ArgumentNullException

Параметр messageBuffer или results имеет значение null.

Комментарии

Используйте этот метод, если предполагается, что несколько фильтров будут удовлетворять условиям буферизованного сообщения, и эти фильтры требуются.

Фильтрам в таблице разрешается проверять текст сообщения.

Объекты MessageFilter, соответствующие запросу, хранятся в параметре results коллекции ICollection<T>. Параметр FilterData затем может быть восстановлен из таблицы фильтров путем использования этих фильтров в качестве ключей с методами, предоставляемыми словарем IDictionary<TKey,TValue>.

Этот метод реализует GetMatchingFilters.