XPathMessageFilterTable<TFilterData>.GetMatchingFilters Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, указывающее, удовлетворяет ли заданный 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> -> boolPublic Function GetMatchingFilters (navigator As SeekableXPathNavigator, results As ICollection(Of MessageFilter)) As BooleanПараметры
- navigator
- SeekableXPathNavigator
Объект SeekableXPathNavigator для проверки.
- results
- ICollection<MessageFilter>
Ссылочный параметр, в котором хранятся объекты MessageFilter, соответствующие условиям фильтра ICollection<T><Filter>.
Возвращаемое значение
true, если параметр messageBuffer удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.
Исключения
Параметр 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> -> boolPublic Function GetMatchingFilters (navigator As XPathNavigator, results As ICollection(Of MessageFilter)) As BooleanПараметры
- navigator
- XPathNavigator
Объект XPathNavigator для проверки.
- results
- ICollection<MessageFilter>
Ссылочный параметр, в котором хранятся объекты MessageFilter, соответствующие условиям фильтра ICollection<T><Filter>.
Возвращаемое значение
true, если параметр messageBuffer удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.
Исключения
Параметр 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> -> boolPublic Function GetMatchingFilters (message As Message, results As ICollection(Of MessageFilter)) As BooleanПараметры
- results
- ICollection<MessageFilter>
Ссылочный параметр, в котором хранятся объекты MessageFilter, соответствующие условиям фильтра ICollection<T><Filter>.
Возвращаемое значение
true, если параметр message удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.
Реализации
Исключения
Параметр message или results имеет значение null.
Была предпринята попытка проверить содержимое тела сообщения с помощью фильтра.
Комментарии
Используйте этот метод, если предполагается, что несколько фильтров будут удовлетворять условиям сообщения, и эти фильтры требуются.
Фильтрам в таблице не разрешается проверять текст сообщения.
Объекты 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> -> boolPublic Function GetMatchingFilters (messageBuffer As MessageBuffer, results As ICollection(Of MessageFilter)) As BooleanПараметры
- messageBuffer
- MessageBuffer
Объект MessageBuffer для проверки.
- results
- ICollection<MessageFilter>
Ссылочный параметр, в котором хранятся объекты MessageFilter, соответствующие условиям фильтра ICollection<T><Filter>.
Возвращаемое значение
true, если параметр messageBuffer удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.
Реализации
Исключения
Параметр messageBuffer или results имеет значение null.
Комментарии
Используйте этот метод, если предполагается, что несколько фильтров будут удовлетворять условиям буферизованного сообщения, и эти фильтры требуются.
Фильтрам в таблице разрешается проверять текст сообщения.
Объекты MessageFilter, соответствующие запросу, хранятся в параметре results коллекции ICollection<T>. Параметр FilterData затем может быть восстановлен из таблицы фильтров путем использования этих фильтров в качестве ключей с методами, предоставляемыми словарем IDictionary<TKey,TValue>.
Этот метод реализует GetMatchingFilters.
