IMessageFilterTable<TFilterData>.GetMatchingFilter IMessageFilterTable<TFilterData>.GetMatchingFilter IMessageFilterTable<TFilterData>.GetMatchingFilter IMessageFilterTable<TFilterData>.GetMatchingFilter Method

Определение

Возвращает фильтр из таблицы, чьим критериям запроса удовлетворяет указанное сообщение или буферизованное сообщение.Returns a filter from the table whose query criteria are satisfied by a specified message or buffered message.

Перегрузки

GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter)

Возвращает значение, указывающее, удовлетворяет ли заданное сообщение критерию соответствия одного фильтра, и возвращает этот фильтр в параметре out.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message, and returns that filter in an out parameter.

GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter)

Возвращает значение, указывающее, удовлетворяет ли заданное или буферизованное сообщение критерию соответствия одного фильтра, и возвращает этот фильтр в параметре out.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message or buffered message, and returns that filter in an out parameter.

Комментарии

Используйте этот метод, если предполагается, что только один фильтр будет удовлетворять сообщению, и этот фильтр требуется.Use this method when a single filter is expected to match the message and the matching filter is required.

Используйте метод GetMatchingFilter, если содержимое текста не требуется проверять.Use GetMatchingFilter if the body content does not require examination. Используйте метод GetMatchingFilter, если содержимое текста сообщения может потребовать проверки.Use GetMatchingFilter if the contents of the message body may require examination.

GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter)

Возвращает значение, указывающее, удовлетворяет ли заданное сообщение критерию соответствия одного фильтра, и возвращает этот фильтр в параметре out.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message, and returns that filter in an out parameter.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % result);
public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter result);
abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Параметры

message
Message Message Message Message

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

filter
MessageFilter MessageFilter MessageFilter MessageFilter

Параметр out, содержащий фильтр, которому удовлетворяет параметр message.out parameter that stores the filter that is satisfied by the message. Если фильтр не найден, параметру присваивается значение по умолчанию.If no filter was found, the parameter is set to its default value.

Возвраты

true, если параметр message удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.true if the match criterion of at least one filter in the table is satisfied by message; false if no filter is satisfied.

Комментарии

Используйте этот метод, если предполагается, что только один фильтр будет удовлетворять сообщению, и этот фильтр требуется.Use this method when a single filter is expected to match the message and the matching filter is required.

Если текст сообщения должен проверяться фильтром в таблице фильтров, то используйте GetMatchingFilter версию метод.If the body of the message must be inspected by a filter in the filter table, use the GetMatchingFilter version of the method.

Примечания для тех, кто реализует этот метод

Если сообщению соответствуют несколько фильтров, должно быть создано исключение MultipleFilterMatchesException.If more than one filter matches the message, a MultipleFilterMatchesException must be thrown.

В данной версии берется Message и должно выдаваться исключение InvalidBodyAccessException, если производится попытка проверить текст сообщения.This version takes a Message and must throw an InvalidBodyAccessException if it tries to examine the message body.

GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter)

Возвращает значение, указывающее, удовлетворяет ли заданное или буферизованное сообщение критерию соответствия одного фильтра, и возвращает этот фильтр в параметре out.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message or buffered message, and returns that filter in an out parameter.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ buffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % result);
public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer buffer, out System.ServiceModel.Dispatcher.MessageFilter result);
abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
Public Function GetMatchingFilter (buffer As MessageBuffer, ByRef result As MessageFilter) As Boolean

Параметры

messageBuffer
MessageBuffer MessageBuffer MessageBuffer MessageBuffer

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

filter
MessageFilter MessageFilter MessageFilter MessageFilter

Параметр out, содержащий фильтр, которому удовлетворяет параметр message.out parameter that stores the filter that is satisfied by the message. Если фильтр не найден, параметру присваивается значение по умолчанию.If no filter was found, the parameter is set to its default value.

Возвраты

true, если параметр messageBuffer удовлетворяет критерию соответствия по крайней мере одного фильтра из таблицы; false, если не удовлетворяются критерии ни одного из фильтров.true if the match criterion of at least one filter in the table is satisfied by messageBuffer; false if no filter is satisfied.

Комментарии

Используйте этот метод, если предполагается, что только один фильтр будет удовлетворять буферизованному сообщению, и соответствующий фильтр должен быть возвращен, а тело сообщения может потребоваться проверить.Use this method when a single filter is expected to match the buffered message, the matching filter must be returned, and the body of the message may have to be inspected.

Применяется к