IMessageFilterTable<TFilterData>.GetMatchingFilter Metode

Definisi

Ruang nama:

System.ServiceModel.Dispatcher

Rakitan:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Mengembalikan filter dari tabel yang kriteria kuerinya dipenuhi oleh pesan tertentu atau pesan yang di-buffer.

Overload

GetMatchingFilter(Message, MessageFilter)	Mengembalikan nilai yang menunjukkan apakah kriteria pencocokan tepat satu filter dalam tabel dipenuhi oleh pesan yang ditentukan, dan mengembalikan filter tersebut dalam out parameter.
GetMatchingFilter(MessageBuffer, MessageFilter)	Mengembalikan nilai yang menunjukkan apakah kriteria pencocokan tepat satu filter dalam tabel dipenuhi oleh pesan yang ditentukan atau pesan buffer, dan mengembalikan filter tersebut dalam out parameter.

Keterangan

Gunakan metode ini ketika satu filter diharapkan cocok dengan pesan dan filter yang cocok diperlukan.

Gunakan GetMatchingFilter jika konten isi tidak memerlukan pemeriksaan. Gunakan GetMatchingFilter jika isi isi pesan mungkin memerlukan pemeriksaan.

GetMatchingFilter(Message, MessageFilter)

Sumber:

IMessageFilterTable.cs

Mengembalikan nilai yang menunjukkan apakah kriteria pencocokan tepat satu filter dalam tabel dipenuhi oleh pesan yang ditentukan, dan mengembalikan filter tersebut dalam out parameter.

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 -> bool

Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

Parameter

message

Message

Yang akan diuji Message .

filter

MessageFilter

out parameter yang menyimpan filter yang dipenuhi oleh message. Jika tidak ada filter yang ditemukan, parameter diatur ke nilai defaultnya.

Mengembalikan

Boolean

true jika kriteria pencocokan setidaknya satu filter dalam tabel dipenuhi oleh message; false jika tidak ada filter yang terpenuhi.

Keterangan

Gunakan metode ini ketika satu filter diharapkan cocok dengan pesan dan filter yang cocok diperlukan.

Jika isi pesan harus diperiksa oleh filter dalam tabel filter, gunakan GetMatchingFilter versi metode .

Catatan Bagi Implementer

Jika lebih dari satu filter cocok dengan pesan, harus MultipleFilterMatchesException dilemparkan.

Versi ini mengambil Message dan harus melempar InvalidBodyAccessException jika mencoba memeriksa isi pesan.

GetMatchingFilter(MessageBuffer, MessageFilter)

Sumber:

IMessageFilterTable.cs

Mengembalikan nilai yang menunjukkan apakah kriteria pencocokan tepat satu filter dalam tabel dipenuhi oleh pesan yang ditentukan atau pesan buffer, dan mengembalikan filter tersebut dalam 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 -> bool

Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

Parameter

messageBuffer

MessageBuffer

Yang akan diuji MessageBuffer .

filter

MessageFilter

out parameter yang menyimpan filter yang dipenuhi oleh message. Jika tidak ada filter yang ditemukan, parameter diatur ke nilai defaultnya.

Mengembalikan

Boolean

true jika kriteria pencocokan setidaknya satu filter dalam tabel dipenuhi oleh messageBuffer; false jika tidak ada filter yang terpenuhi.

Keterangan

Gunakan metode ini ketika satu filter diharapkan cocok dengan pesan buffer, filter yang cocok harus dikembalikan, dan isi pesan mungkin harus diperiksa.