IMessageFilterTable<TFilterData>.GetMatchingValues Метод

Определение

Добавляет данные фильтров из фильтров, соответствующих указанному сообщению или буферизованному сообщению, в коллекцию.Adds the filter data of the filters that match the specified message or buffered message to a collection.

Перегрузки

GetMatchingValues(Message, ICollection<TFilterData>)

Возвращает значение, указывающее, удовлетворяет ли заданное сообщение критерию соответствия хотя бы одного фильтра, и добавляет параметр FilterData из соответствующих фильтров в коллекцию.Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified message, and adds the FilterData of the matching filters to a collection.

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия хотя бы одного фильтра, и добавляет параметр FilterData из соответствующих фильтров в коллекцию.Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified buffered message, and adds the FilterData of the matching filters to a collection.

Комментарии

Используйте этот метод, если предполагается, что несколько фильтров будут удовлетворять условиям сообщения, и требуются только данные соответствующих фильтров.Use this method when more than one filter is expected to match and only the matching filter data is required. Эти методы возвращают логические значения, указывающие, были ли найдены соответствующие фильтры, и помещают все данные найденных фильтров в коллекцию.These methods return a boolean that indicates whether matching filters were found and put any matching filter data into a collection.

Обратите внимание, что коллекция, содержащая данные фильтров, не очищается до добавления результатов.Note that the collection that contains the filter data is not cleared before the results are added. Это позволяет накапливать все найденные соответствия для нескольких таблиц фильтров в одной коллекции.This allows you to accumulate all matches across multiple filter tables into a single collection.

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

GetMatchingValues(Message, ICollection<TFilterData>)

Возвращает значение, указывающее, удовлетворяет ли заданное сообщение критерию соответствия хотя бы одного фильтра, и добавляет параметр FilterData из соответствующих фильтров в коллекцию.Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified message, and adds the FilterData of the matching filters to a collection.

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

Параметры

message
Message

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

results
ICollection<TFilterData>

Ссылочный параметр, хранящий данные фильтров, которые удовлетворяют условию, в универсальной коллекции.Reference parameter that stores the filter data of the matching filters in a generic collection.

Возвраты

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 one or more filters are expected to match the message, only the filter data is required, and the contents of the body of the message are not to be inspected.

Данные фильтров объектов MessageFilter, соответствующих запросу, хранятся в параметре results.The filter data of the matching MessageFilter objects is stored in the results parameter.

Если текст сообщения проверяется фильтром в таблице фильтров, то поместите сообщение в буфер и передайте его в версию GetMatchingValues метода.If the body of the message is inspected by a filter in the filter table, buffer the message and pass it to the GetMatchingValues version of the method.

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

Возвращает значение, указывающее, удовлетворяет ли заданное буферизованное сообщение критерию соответствия хотя бы одного фильтра, и добавляет параметр FilterData из соответствующих фильтров в коллекцию.Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified buffered message, and adds the FilterData of the matching filters to a collection.

public:
 bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ buffer, 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
Public Function GetMatchingValues (buffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean

Параметры

messageBuffer
MessageBuffer

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

results
ICollection<TFilterData>

Ссылочный параметр, хранящий данные фильтров, которые удовлетворяют условию, в универсальной коллекции ICollection<T><FilterData>.Reference parameter that stores the filter data of the matching filters in a generic ICollection<T><FilterData>.

Возвраты

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 one or more filters are expected to match the buffered message, only the filter data is required, and the body of the message may require inspection.

Данные фильтров объектов MessageFilter, соответствующих запросу, хранятся в параметре results.The filter data of the matching MessageFilter objects is stored in the results parameter.

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