MessageFilterTable<TFilterData>.GetMatchingValue Метод

Определение

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

System.ServiceModel.Dispatcher

Сборка:

System.ServiceModel.dll

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

Перегрузки

GetMatchingValue(Message, TFilterData)	Возвращает значение, указывающее, удовлетворяет ли заданное сообщение критерию соответствия одного объекта MessageFilter, и добавляет соответствующие данные фильтра в коллекцию.
GetMatchingValue(MessageBuffer, TFilterData)	Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия одного фильтра, и добавляет соответствующие данные фильтра в коллекцию.

Комментарии

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

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

GetMatchingValue(Message, TFilterData)

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

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool

Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean

Параметры

message

Message

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

data

TFilterData

Параметр out, хранящий параметр FilterData, удовлетворяющий условиям message.

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

Boolean

true, если сообщение удовлетворяет критериям соответствия одного фильтра в таблице; false, если не соответствует ни одному фильтру.

Реализации

GetMatchingValue(Message, TFilterData)

Исключения

MultipleFilterMatchesException

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

InvalidBodyAccessException

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

Комментарии

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

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

GetMatchingValue(MessageBuffer, TFilterData)

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

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ buffer, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer buffer, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool

Public Function GetMatchingValue (buffer As MessageBuffer, ByRef data As TFilterData) As Boolean

Параметры

buffer

MessageBuffer

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

data

TFilterData

Параметр out, хранящий параметр FilterData, удовлетворяющий условиям buffer.

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

Boolean

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

Реализации

GetMatchingValue(MessageBuffer, TFilterData)

Исключения

MultipleFilterMatchesException

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

Комментарии

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

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