IMessageFilterTable<TFilterData>.GetMatchingValue 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 waarde die aangeeft of het criterium voor overeenkomst van een filter in de tabel wordt voldaan door het opgegeven bericht of het gebufferde bericht en retourneert de filtergegevens voor het overeenkomende filter.
Overloads
| Name | Description |
|---|---|
| GetMatchingValue(Message, TFilterData) |
Retourneert een waarde die aangeeft of het overeenkomstcriterium van precies één filter in de tabel voldoet aan het opgegeven bericht en de overeenkomende filtergegevens aan een verzameling toevoegt. |
| GetMatchingValue(MessageBuffer, TFilterData) |
Retourneert een waarde die aangeeft of het overeenkomstcriterium van precies één filter in de tabel voldoet aan het opgegeven gebufferde bericht en de overeenkomende filtergegevens aan een verzameling toevoegt. |
Opmerkingen
Gebruik een van deze methoden wanneer naar verwachting één filter overeenkomt met het bericht en alleen de filtergegevens uit het overeenkomende filter moeten worden hersteld. Deze methoden retourneren een Booleaanse waarde die aangeeft of er een overeenkomend filter is gevonden en de data referentieparameter is ingesteld op de overeenkomende filtergegevens.
Gebruik GetMatchingFilter deze optie als de hoofdtekst van het bericht niet wordt gecontroleerd door een van de filters in de filtertabel.
Als de hoofdtekst van het bericht kan worden gecontroleerd door een filter in de filtertabel, buffert u het bericht en geeft u het door aan de GetMatchingFilter versie van de methode.
GetMatchingValue(Message, TFilterData)
Retourneert een waarde die aangeeft of het overeenkomstcriterium van precies één filter in de tabel voldoet aan het opgegeven bericht en de overeenkomende filtergegevens aan een verzameling toevoegt.
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 -> boolPublic Function GetMatchingValue (message As Message, ByRef value As TFilterData) As BooleanParameters
- value
- TFilterData
out parameter die de FilterData die overeenkomt met de message.
Retouren
true als aan het criterium voor overeenkomst van precies één filter in de tabel wordt voldaan door het bericht; false als er geen filter is voldaan.
Opmerkingen
Gebruik deze methode wanneer naar verwachting één filter overeenkomt met het bericht en alleen de filtergegevens uit het overeenkomende filter moeten worden hersteld.
Deze methode verwacht maximaal één overeenkomend filter. Als meer dan één filter overeenkomt, moet er een MultipleFilterMatchesException worden gegenereerd.
Als de hoofdtekst van het bericht moet worden geïnspecteerd door een filter in de filtertabel, buffert u het bericht en CreateBufferedCopy geeft u het door aan de GetMatchingValue versie van de methode.
Notities voor uitvoerders
Als meer dan één filter overeenkomt met het bericht, moet er een MultipleFilterMatchesException worden gegenereerd.
Deze overbelasting neemt een Message en moet een InvalidBodyAccessException als het probeert de berichttekst te onderzoeken.
Van toepassing op
GetMatchingValue(MessageBuffer, TFilterData)
Retourneert een waarde die aangeeft of het overeenkomstcriterium van precies één filter in de tabel voldoet aan het opgegeven gebufferde bericht en de overeenkomende filtergegevens aan een verzameling toevoegt.
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 -> boolPublic Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef value As TFilterData) As BooleanParameters
- messageBuffer
- MessageBuffer
De MessageBuffer te testen.
- value
- TFilterData
out parameter die de FilterData die overeenkomt met de messageBuffer.
Retouren
true als aan het criterium voor overeenkomst van precies één filter in de tabel wordt voldaan door het bericht; false als er geen filter is voldaan.
Opmerkingen
Gebruik deze methode wanneer naar verwachting één filter overeenkomt met het gebufferde bericht, moeten alleen de filtergegevens van het overeenkomende filter worden hersteld en moet de hoofdtekst van het bericht mogelijk worden geïnspecteerd.
Notities voor uitvoerders
Als meer dan één filter overeenkomt met het bericht, moet er een MultipleFilterMatchesException worden gegenereerd.