IMessageFilterTable<TFilterData>.GetMatchingFilter Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een filter uit de tabel waarvan aan de querycriteria wordt voldaan door een opgegeven bericht of gebufferd bericht.
Overloads
| Name | Description |
|---|---|
| GetMatchingFilter(Message, MessageFilter) |
Retourneert een waarde die aangeeft of het overeenkomstcriterium van precies één filter in de tabel voldoet aan het opgegeven bericht en dat filter in een |
| GetMatchingFilter(MessageBuffer, MessageFilter) |
Retourneert een waarde die aangeeft of het criterium voor overeenkomst van precies één filter in de tabel wordt voldaan door het opgegeven bericht of het gebufferde bericht, en retourneert dat filter in een |
Opmerkingen
Gebruik deze methode wanneer naar verwachting één filter overeenkomt met het bericht en het overeenkomende filter is vereist.
Gebruik GetMatchingFilter deze optie als de lichaamsinhoud geen onderzoek vereist. Gebruik GetMatchingFilter deze optie als de inhoud van de hoofdtekst van het bericht onderzoek kan vereisen.
GetMatchingFilter(Message, MessageFilter)
Retourneert een waarde die aangeeft of het overeenkomstcriterium van precies één filter in de tabel voldoet aan het opgegeven bericht en dat filter in een out parameter retourneert.
public:
bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);public bool GetMatchingFilter(System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> boolPublic Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As BooleanParameters
- filter
- MessageFilter
out parameter waarmee het filter wordt opgeslagen dat wordt voldaan door de message. Als er geen filter is gevonden, wordt de parameter ingesteld op de standaardwaarde.
Retouren
true als aan het criterium voor overeenkomst van ten minste één filter in de tabel wordt voldaan message; false als er geen filter wordt voldaan.
Opmerkingen
Gebruik deze methode wanneer naar verwachting één filter overeenkomt met het bericht en het overeenkomende filter is vereist.
Als de hoofdtekst van het bericht moet worden gecontroleerd door een filter in de filtertabel, gebruikt u de GetMatchingFilter versie van de methode.
Notities voor uitvoerders
Als meer dan één filter overeenkomt met het bericht, moet er een MultipleFilterMatchesException worden gegenereerd.
Deze versie neemt een Message en moet een InvalidBodyAccessException als deze probeert de hoofdtekst van het bericht te onderzoeken.
Van toepassing op
GetMatchingFilter(MessageBuffer, MessageFilter)
Retourneert een waarde die aangeeft of het criterium voor overeenkomst van precies één filter in de tabel wordt voldaan door het opgegeven bericht of het gebufferde bericht, en retourneert dat filter in een out parameter.
public:
bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);public bool GetMatchingFilter(System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> boolPublic Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As BooleanParameters
- messageBuffer
- MessageBuffer
De MessageBuffer te testen.
- filter
- MessageFilter
out parameter waarmee het filter wordt opgeslagen dat wordt voldaan door de message. Als er geen filter is gevonden, wordt de parameter ingesteld op de standaardwaarde.
Retouren
true als aan het criterium voor overeenkomst van ten minste één filter in de tabel wordt voldaan messageBuffer; false als er geen filter wordt voldaan.
Opmerkingen
Gebruik deze methode wanneer naar verwachting één filter overeenkomt met het gebufferde bericht, moet het overeenkomende filter worden geretourneerd en moet de hoofdtekst van het bericht mogelijk worden geïnspecteerd.