IMessageFilterTable<TFilterData>.GetMatchingValue Méthode

Définition

Espace de noms:
System.ServiceModel.Dispatcher
Assembly:
System.ServiceModel.dll

Retourne une valeur qui indique si le critère de correspondance d’un filtre dans la table est satisfait par le message spécifié ou le message mis en mémoire tampon et retourne les données de filtre pour le filtre correspondant.

Surcharges

Nom Description
GetMatchingValue(Message, TFilterData)

Retourne une valeur qui indique si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message spécifié et ajoute les données de filtre correspondantes à une collection.
GetMatchingValue(MessageBuffer, TFilterData)

Retourne une valeur qui indique si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message mis en mémoire tampon spécifié et ajoute les données de filtre correspondantes à une collection.

Remarques

Utilisez l’une de ces méthodes lorsque, au plus, un filtre est censé correspondre au message et seules les données de filtre du filtre correspondant doivent être récupérées. Ces méthodes retournent une valeur booléenne qui indique si un filtre correspondant a été trouvé et définissez le data paramètre de référence sur les données de filtre correspondantes.

Utilisez GetMatchingFilter si le corps du message n’est pas inspecté par l’un des filtres de la table de filtres.

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

GetMatchingValue(Message, TFilterData)

Retourne une valeur qui indique si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message spécifié et ajoute les données de filtre correspondantes à une collection.

public:
 bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % value);
public bool GetMatchingValue(System.ServiceModel.Channels.Message message, out TFilterData value);
abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
Public Function GetMatchingValue (message As Message, ByRef value As TFilterData) As Boolean

Paramètres

message
Message

Message À tester.

value
TFilterData

out paramètre qui stocke les FilterData valeurs qui correspondent à l’objet message.

Retours

Boolean

true si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message ; false si aucun filtre n’est satisfait.

Remarques

Utilisez cette méthode lorsqu’un seul filtre est censé correspondre au message et que seules les données de filtre du filtre correspondant doivent être récupérées.

Cette méthode attend au maximum un seul filtre correspondant. Si plusieurs filtres correspondent, un MultipleFilterMatchesException doit être levée.

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

Notes pour les responsables de l’implémentation

Si plusieurs filtres correspondent au message, un MultipleFilterMatchesException doit être levée.

Cette surcharge prend une Message valeur et doit lever une InvalidBodyAccessException valeur si elle tente d’examiner le corps du message.

S’applique à

GetMatchingValue(MessageBuffer, TFilterData)

Retourne une valeur qui indique si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message mis en mémoire tampon spécifié et ajoute les données de filtre correspondantes à une collection.

public:
 bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % value);
public bool GetMatchingValue(System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData value);
abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
Public Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef value As TFilterData) As Boolean

Paramètres

messageBuffer
MessageBuffer

MessageBuffer À tester.

value
TFilterData

out paramètre qui stocke les FilterData valeurs qui correspondent à l’objet messageBuffer.

Retours

Boolean

true si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message ; false si aucun filtre n’est satisfait.

Remarques

Utilisez cette méthode lorsqu’un seul filtre est censé correspondre au message mis en mémoire tampon, seules les données de filtre du filtre correspondant doivent être récupérées et le corps du message peut être inspecté.

Notes pour les responsables de l’implémentation

Si plusieurs filtres correspondent au message, un MultipleFilterMatchesException doit être levée.

S’applique à