XPathMessageFilter.Match Metode

Definisi

Ruang nama:

System.ServiceModel.Dispatcher

Rakitan:

System.ServiceModel.dll

Menentukan apakah pesan atau dokumen XML memenuhi kriteria kueri filter JalurX.

Overload

Match(Message)	Menguji apakah pesan tertentu memenuhi kriteria filter JalurX. Formulir ini tidak diizinkan untuk mengakses isi pesan.
Match(MessageBuffer)	Menentukan apakah pesan yang di-buffer memenuhi kriteria kueri filter JalurX.
Match(SeekableXPathNavigator)	Menentukan apakah dokumen XML yang disediakan oleh navigator JalurX yang dioptimalkan yang ditentukan memenuhi kriteria kueri filter JalurX.
Match(XPathNavigator)	Mengevaluasi filter melalui navigator JalurX yang ditentukan.

Keterangan

Metode ini memeriksa satu filter terhadap pesan. Jika Anda perlu memeriksa pesan terhadap beberapa filter, masukkan filter ke dalam tabel filter lalu gunakan metode pencocokan yang disediakan oleh tabel.

Jika Anda hanya perlu menguji header pesan dan bukan isi pesan, gunakan metode .Match

Jika Anda perlu menguji bagian isi pesan, gunakan metode .Match

Untuk pengujian yang melibatkan kueri JalurX, gunakan salah satu kelebihan beban yang tersisa dari Match.

Match(Message)

Menguji apakah pesan tertentu memenuhi kriteria filter JalurX. Formulir ini tidak diizinkan untuk mengakses isi pesan.

public:
 override bool Match(System::ServiceModel::Channels::Message ^ message);

public override bool Match (System.ServiceModel.Channels.Message message);

override this.Match : System.ServiceModel.Channels.Message -> bool

Public Overrides Function Match (message As Message) As Boolean

Parameter

message

Message

Yang akan diuji Message .

Mengembalikan

Boolean

true Message jika memenuhi kriteria filter; jika tidak, false.

Pengecualian

ArgumentNullException

messageadalah null.

InvalidBodyAccessException

Evaluasi JalurX mencoba memeriksa isi pesan.

XPathException

Terjadi kesalahan pengkompilasi.

Keterangan

XPathMessageFilter.Match Gunakan metode untuk mencocokkan elemen dari isi. Pengecualian dilemparkan oleh metode ini jika mesin mencoba mengakses isi pesan untuk mengevaluasi ekspresi JalurX. Ini membantu memastikan bahwa mesin filter tidak mengakses aliran isi.

Match(MessageBuffer)

Menentukan apakah pesan yang di-buffer memenuhi kriteria kueri filter JalurX.

public:
 override bool Match(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer);

public override bool Match (System.ServiceModel.Channels.MessageBuffer messageBuffer);

override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool

Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean

Parameter

messageBuffer

MessageBuffer

Yang akan diuji MessageBuffer .

Mengembalikan

Boolean

true Match(MessageBuffer) jika memenuhi kriteria filter; jika tidak false.

Pengecualian

ArgumentNullException

messageadalah null.

XPathException

Terjadi kesalahan pengkompilasi.

Keterangan

Gunakan kelebihan beban Match metode ini saat MessageBuffer tersedia. Formulir ini diizinkan untuk memeriksa isi pesan.

Match(SeekableXPathNavigator)

Menentukan apakah dokumen XML yang disediakan oleh navigator JalurX yang dioptimalkan yang ditentukan memenuhi kriteria kueri filter JalurX.

public:
 bool Match(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator);

public bool Match (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator);

override this.Match : System.ServiceModel.Dispatcher.SeekableXPathNavigator -> bool

Public Function Match (navigator As SeekableXPathNavigator) As Boolean

Parameter

navigator

SeekableXPathNavigator

SeekableXPathNavigator yang menyediakan data untuk diuji.

Mengembalikan

Boolean

true jika data dari SeekableXPathNavigator memenuhi kriteria filter; jika tidak, false.

Pengecualian

ArgumentNullException

navigatoradalah null.

XPathException

Terjadi kesalahan pengkompilasi.

Keterangan

Kelas SeekableXPathNavigator memperluas XPathNavigator kelas dengan metode yang menjalankan kueri dengan lebih efisien.

Match(XPathNavigator)

Mengevaluasi filter melalui navigator JalurX yang ditentukan.

public:
 bool Match(System::Xml::XPath::XPathNavigator ^ navigator);

public bool Match (System.Xml.XPath.XPathNavigator navigator);

override this.Match : System.Xml.XPath.XPathNavigator -> bool

Public Function Match (navigator As XPathNavigator) As Boolean

Parameter

navigator

XPathNavigator

XPathNavigator yang menyediakan data untuk diuji.

Mengembalikan

Boolean

true jika data dari XPathNavigator memenuhi kriteria filter; false jika tidak.

Pengecualian

ArgumentNullException

navigatoradalah null.

XPathException

Terjadi kesalahan pengkompilasi.