XPathMessageFilter.Match Метод

Определение

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

System.ServiceModel.Dispatcher

Сборка:

System.ServiceModel.dll

Определяет, удовлетворяет ли сообщение или документ XML критериям запроса фильтра XPath.

Перегрузки

Match(Message)	Проверяет, удовлетворяет ли критериям фильтра XPath указанное сообщение. Такая форма не допустима для доступа к телу сообщения.
Match(MessageBuffer)	Определяет, удовлетворяет ли буферизованное сообщение критериям запроса фильтра XPath.
Match(SeekableXPathNavigator)	Определяет, удовлетворяет ли критериям запроса фильтра XPath предоставленный указанным оптимизированным навигатором XPath документ XML.
Match(XPathNavigator)	Оценивает фильтр посредством указанного навигатора XPath.

Комментарии

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

Если требуется проверить только заголовки сообщений, а не текста сообщений, то используйте метод Match.

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

Для проверок, включающих в себя запросы XPath, используйте одну из оставшихся перегрузок метода Match.

Match(Message)

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

public:
 override bool Match(System::ServiceModel::Channels::Message ^ message);

public override bool Match (System.ServiceModel.Channels.Message message);

override this.Match : System.ServiceModel.Channels.Message -> bool

Public Overrides Function Match (message As Message) As Boolean

Параметры

message

Message

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

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

Boolean

true, если объект Message удовлетворяет критериям фильтра; в противном случае — false.

Исключения

ArgumentNullException

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

InvalidBodyAccessException

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

XPathException

Произошла ошибка компилятора.

Комментарии

Метод XPathMessageFilter.Match используется для поиска совпадающих элементов в тексте сообщения. Этот метод вызывает исключение, если обработчик попытается получить доступ к тексту сообщения, чтобы вычислить выражение XPath. Это помогает гарантировать невозможность доступа обработчика фильтра к потоку текста.

Match(MessageBuffer)

Определяет, удовлетворяет ли буферизованное сообщение критериям запроса фильтра XPath.

public:
 override bool Match(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer);

public override bool Match (System.ServiceModel.Channels.MessageBuffer messageBuffer);

override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool

Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean

Параметры

messageBuffer

MessageBuffer

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

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

Boolean

Значение true, если объект Match(MessageBuffer) удовлетворяет критериям фильтра; в противном случае значение false.

Исключения

ArgumentNullException

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

XPathException

Произошла ошибка компилятора.

Комментарии

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

Match(SeekableXPathNavigator)

Определяет, удовлетворяет ли критериям запроса фильтра XPath предоставленный указанным оптимизированным навигатором XPath документ XML.

public:
 bool Match(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator);

public bool Match (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator);

override this.Match : System.ServiceModel.Dispatcher.SeekableXPathNavigator -> bool

Public Function Match (navigator As SeekableXPathNavigator) As Boolean

Параметры

navigator

SeekableXPathNavigator

Объект SeekableXPathNavigator, предоставляющий данные для проверки.

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

Boolean

true, если данные из объекта SeekableXPathNavigator удовлетворяют критериям фильтра; в противном случае — false.

Исключения

ArgumentNullException

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

XPathException

Произошла ошибка компилятора.

Комментарии

Класс SeekableXPathNavigator расширяет класс XPathNavigator добавлением методов, выполняющих запросы более эффективно.

Match(XPathNavigator)

Оценивает фильтр посредством указанного навигатора XPath.

public:
 bool Match(System::Xml::XPath::XPathNavigator ^ navigator);

public bool Match (System.Xml.XPath.XPathNavigator navigator);

override this.Match : System.Xml.XPath.XPathNavigator -> bool

Public Function Match (navigator As XPathNavigator) As Boolean

Параметры

navigator

XPathNavigator

Объект XPathNavigator, предоставляющий данные для проверки.

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

Boolean

true, если данные из объекта XPathNavigator удовлетворяют критериям фильтра; в противном случае — false.

Исключения

ArgumentNullException

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

XPathException

Произошла ошибка компилятора.