XPathMessageFilterTable<TFilterData>.GetMatchingFilter Метод

Определение

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

System.ServiceModel.Dispatcher

Сборка:

System.ServiceModel.dll

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

Перегрузки

GetMatchingFilter(Message, MessageFilter)	Возвращает значение, указывающее, удовлетворяет ли заданное сообщение критерию соответствия одного фильтра, и возвращает этот фильтр в параметре out.
GetMatchingFilter(MessageBuffer, MessageFilter)	Возвращает значение, указывающее, удовлетворяет ли заданное или буферизованное сообщение критерию соответствия одного фильтра, и возвращает этот фильтр в параметре out.
GetMatchingFilter(SeekableXPathNavigator, MessageFilter)	Возвращает значение, указывающее, удовлетворяет ли заданное или буферизованное сообщение критерию соответствия для одного объекта SeekableXPathNavigator, и возвращает этот фильтр в параметре out.
GetMatchingFilter(XPathNavigator, MessageFilter)	Возвращает значение, указывающее, удовлетворяет ли заданное или буферизованное сообщение критерию соответствия для одного объекта XPathNavigator, и возвращает этот фильтр в параметре out.

Комментарии

Проверяет, удовлетворяет ли сообщение одному из фильтров в таблице фильтров.

GetMatchingFilter(Message, MessageFilter)

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

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

Параметры

message

Message

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

filter

MessageFilter

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

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

Boolean

Объект MessageFilter, чьим критериям запроса отвечает сообщение; или значение null, если по запросу не найдено ни одного фильтра.

Реализации

GetMatchingFilter(Message, MessageFilter)

Исключения

ArgumentNullException

message имеет значение null.

MultipleFilterMatchesException

Найдено несколько фильтров, соответствующих параметру message.

InvalidBodyAccessException

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

Комментарии

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

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

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

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

GetMatchingFilter(MessageBuffer, MessageFilter)

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

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool

Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

Параметры

messageBuffer

MessageBuffer

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

filter

MessageFilter

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

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

Boolean

Объект MessageFilter, чьим критериям запроса отвечает буферизованное сообщение; или значение null, если по запросу не найдено ни одного фильтра.

Реализации

GetMatchingFilter(MessageBuffer, MessageFilter)

Исключения

ArgumentNullException

messageBuffer имеет значение null.

MultipleFilterMatchesException

Найдено несколько фильтров, соответствующих параметру messageBuffer.

Комментарии

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

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

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

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

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

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

public:
 bool GetMatchingFilter(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.ServiceModel.Dispatcher.SeekableXPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As SeekableXPathNavigator, ByRef filter As MessageFilter) As Boolean

Параметры

navigator

SeekableXPathNavigator

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

filter

MessageFilter

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

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

Boolean

Объект MessageFilter, чьим критериям запроса отвечает навигатор; или значение null, если по запросу не найдено ни одного фильтра.

Исключения

ArgumentNullException

navigator имеет значение null.

MultipleFilterMatchesException

Найдено несколько фильтров, соответствующих параметру navigator.

Комментарии

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

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

GetMatchingFilter(XPathNavigator, MessageFilter)

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

public:
 bool GetMatchingFilter(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.Xml.XPath.XPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.Xml.XPath.XPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As XPathNavigator, ByRef filter As MessageFilter) As Boolean

Параметры

navigator

XPathNavigator

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

filter

MessageFilter

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

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

Boolean

Объект MessageFilter, чьим критериям запроса отвечает навигатор; или значение null, если по запросу не найдено ни одного фильтра.

Исключения

ArgumentNullException

navigator имеет значение null.

MultipleFilterMatchesException

Найдено несколько фильтров, соответствующих параметру navigator.

Комментарии

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

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