IMessageFilterTable<TFilterData>.GetMatchingValues Метод

Определение

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

System.ServiceModel.Dispatcher

Сборка:

System.ServiceModel.dll

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

Перегрузки

GetMatchingValues(Message, ICollection<TFilterData>)	Возвращает значение, указывающее, удовлетворяет ли заданное сообщение критерию соответствия хотя бы одного фильтра, и добавляет параметр FilterData из соответствующих фильтров в коллекцию.
GetMatchingValues(MessageBuffer, ICollection<TFilterData>)	Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия хотя бы одного фильтра, и добавляет параметр FilterData из соответствующих фильтров в коллекцию.

Комментарии

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

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

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

GetMatchingValues(Message, ICollection<TFilterData>)

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

public:
 bool GetMatchingValues(System::ServiceModel::Channels::Message ^ message, System::Collections::Generic::ICollection<TFilterData> ^ results);

public bool GetMatchingValues (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<TFilterData> results);

abstract member GetMatchingValues : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<'FilterData> -> bool

Public Function GetMatchingValues (message As Message, results As ICollection(Of TFilterData)) As Boolean

Параметры

message

Message

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

results

ICollection<TFilterData>

Ссылочный параметр, хранящий данные фильтров, которые удовлетворяют условию, в универсальной коллекции.

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

Boolean

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

Комментарии

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

Данные фильтров объектов MessageFilter, соответствующих запросу, хранятся в параметре results.

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

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

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

public:
 bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, System::Collections::Generic::ICollection<TFilterData> ^ results);

public:
 bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ buffer, System::Collections::Generic::ICollection<TFilterData> ^ results);

public bool GetMatchingValues (System.ServiceModel.Channels.MessageBuffer messageBuffer, System.Collections.Generic.ICollection<TFilterData> results);

public bool GetMatchingValues (System.ServiceModel.Channels.MessageBuffer buffer, System.Collections.Generic.ICollection<TFilterData> results);

abstract member GetMatchingValues : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<'FilterData> -> bool

abstract member GetMatchingValues : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<'FilterData> -> bool

Public Function GetMatchingValues (messageBuffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean

Public Function GetMatchingValues (buffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean

Параметры

messageBufferbuffer

MessageBuffer

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

results

ICollection<TFilterData>

Ссылочный параметр, хранящий данные фильтров, которые удовлетворяют условию, в универсальной коллекции ICollection<T><FilterData>.

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

Boolean

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

Комментарии

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

Данные фильтров объектов MessageFilter, соответствующих запросу, хранятся в параметре results.