Partager via


IMessageFilterTable<TFilterData>.GetMatchingValues Méthode

Définition

Ajoute à une collection les données des filtres qui correspondent au message ou au message mis en mémoire tampon indiqué.

Surcharges

GetMatchingValues(Message, ICollection<TFilterData>)

Retourne une valeur qui indique si le message indiqué respecte le critère de correspondance d'au moins un filtre de la table, et ajoute FilterData des filtres correspondants à une collection.

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

Retourne une valeur qui indique si le message mis en mémoire tampon indiqué respecte le critère de correspondance d'au moins un filtre de la table, et ajoute FilterData des filtres correspondants à une collection.

Remarques

Utilisez cette méthode lorsque plusieurs filtres sont supposés correspondre au message et que seules les données de filtre sont requises. Ces méthodes retournent une valeur booléenne qui indique si les filtres correspondants ont été trouvés et regroupent dans une collection toutes les données de filtre correspondantes.

Il est important de noter que la collection qui contient les données de filtre n'est pas effacée avant que les résultats soient ajoutés. Cela permet d'accumuler toutes les correspondances de plusieurs tables de filtres en une seule collection.

Utilisez GetMatchingValues si le contenu du corps du message ne nécessite aucune vérification. Utilisez GetMatchingValues si le contenu du corps du message doit faire l'objet d'une analyse.

GetMatchingValues(Message, ICollection<TFilterData>)

Retourne une valeur qui indique si le message indiqué respecte le critère de correspondance d'au moins un filtre de la table, et ajoute FilterData des filtres correspondants à une 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
Public Function GetMatchingValues (message As Message, results As ICollection(Of TFilterData)) As Boolean

Paramètres

message
Message

Message à tester.

results
ICollection<TFilterData>

Paramètre de référence qui stocke les données de filtre correspondants, incluses dans une collection générique.

Retours

Boolean

true si le critère de correspondance d'au moins un filtre dans la table est respecté par message ; false si aucun filtre n'est respecté.

Remarques

Utilisez cette méthode lorsqu'un ou plusieurs filtres sont supposés correspondre au message, que seules les données de filtre sont requises et que le contenu du corps du message n'a pas à être inspecté.

Les données de filtre des objets MessageFilter correspondants sont stockées dans le paramètre results.

Si le corps du message est inspecté par un filtre dans la table de filtres, mettez le message en mémoire tampon et transmettez-le à la version GetMatchingValues de la méthode.

S’applique à

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

Retourne une valeur qui indique si le message mis en mémoire tampon indiqué respecte le critère de correspondance d'au moins un filtre de la table, et ajoute FilterData des filtres correspondants à une collection.

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

Paramètres

messageBufferbuffer
MessageBuffer

MessageBuffer à tester.

results
ICollection<TFilterData>

Paramètre de référence qui stocke les données des filtres correspondants dans un objet ICollection<T><FilterData> générique.

Retours

Boolean

true si le critère de correspondance d'au moins un filtre dans la table est respecté par messageBuffer ; false si aucun filtre n'est respecté.

Remarques

Utilisez cette méthode lorsqu'un ou plusieurs filtres sont supposés correspondre au message mis en mémoire tampon, que seules les données de filtre sont requises et que le corps du message peut faire l'objet d'une inspection.

Les données de filtre des objets MessageFilter correspondants sont stockées dans le paramètre results.

S’applique à