ContextBindingElement Kelas

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

System.ServiceModel.dll

Menyediakan tingkat perlindungan dan mekanisme pertukaran sebagai bagian dari konteks elemen pengikatan dan fungsionalitas untuk membangun pendengar dan pabrik saluran.

C#

public class ContextBindingElement : System.ServiceModel.Channels.BindingElement, System.ServiceModel.Channels.IContextBindingElement, System.ServiceModel.Description.IPolicyExportExtension

Warisan

Object

BindingElement

ContextBindingElement

Penerapan

IContextBindingElement IPolicyExportExtension

Keterangan

ContextBindingElement memungkinkan pengguna untuk menambahkan elemen ke pengikatan layanan untuk mengelola protokol pertukaran konteksnya. ContextBindingElement biasanya ditumpuk di atas elemen pengikatan keandalan, keamanan, dan transportasi. ContextBindingElement tidak memerlukan opsi konfigurasi apa pun dan dapat membuat pabrik saluran untuk IRequestChannel, , IRequestSessionChanneldan IDuplexSessionChannel. Ini juga dapat membuat pendengar saluran untuk IReplyChannel, , IReplySessionChanneldan IDuplexSessionChannel. Saluran konteks tidak mengubah antarmuka saluran - tumpukan saluran yang mendasar harus mendukung bentuk saluran yang diminta dan kemampuan sesi.

Pendengar dan pabrik saluran digunakan untuk membangun bagian tumpukan saluran yang digunakan untuk memproses pesan masuk dan keluar.

Catatan

Jika pengikatan berbasis sesi dibuat dengan ContextBindingElement dan digunakan dengan kontrak yang menentukanNotAllowedSessionMode = , InvalidOperationException dilemparkan saat saluran dibuat dengan teks berikut: "Manajemen konteks saluran tidak dapat diaktifkan atau dinonaktifkan setelah saluran dibuka." Anda harus mengatur SessionMode ke Allowed atau Required tidak menggunakan saluran berbasis sesi.

Saat membuat pengikatan kustom, disarankan agar Anda menambahkan ContextBindingElement ke BindingElementCollection pengikatan kustom sebelum menambahkan elemen pengikatan keandalan dan keamanan, jika ada. Jika tidak, layanan Anda dapat melempar ProtocolException dengan pesan berikut:

"Saluran konteks menerima pesan dengan konteks yang tidak cocok dengan konteks saat ini yang di-cache di saluran. Pastikan layanan tidak mengubah konteks setelah awalnya diatur atau nonaktifkan manajemen konteks dengan mengatur properti saluran 'IContextManager.Enabled' ke false."

Konstruktor

ContextBindingElement()	Menginisialisasi instans baru kelas ContextBindingElement.
ContextBindingElement(ProtectionLevel)	Menginisialisasi instans ContextBindingElement baru kelas dengan tingkat perlindungan tertentu.
ContextBindingElement(ProtectionLevel, ContextExchangeMechanism)	Menginisialisasi instans ContextBindingElement baru kelas dengan tingkat perlindungan dan mekanisme pertukaran tertentu.
ContextBindingElement(ProtectionLevel, ContextExchangeMechanism, Uri)	Menginisialisasi instans ContextBindingElement baru kelas dengan tingkat perlindungan yang ditentukan, mekanisme pertukaran konteks, dan alamat panggilan balik klien.
ContextBindingElement(ProtectionLevel, ContextExchangeMechanism, Uri, Boolean)	Menginisialisasi instans ContextBindingElement baru kelas dengan tingkat perlindungan yang ditentukan, mekanisme pertukaran konteks, alamat panggilan balik klien, dan nilai yang menentukan apakah manajemen konteks diaktifkan.

Properti

ClientCallbackAddress	Mendapatkan atau mengatur alamat panggilan balik klien untuk elemen pengikatan.
ContextExchangeMechanism	Mendapatkan atau mengatur mekanisme pertukaran yang digunakan untuk mengkomunikasikan konteks untuk elemen pengikatan.
ContextManagementEnabled	Mendapatkan atau menetapkan nilai yang menentukan apakah manajemen konteks diaktifkan.
ProtectionLevel	Mendapatkan atau mengatur tingkat perlindungan untuk elemen pengikatan dari konteks.

Metode

BuildChannelFactory<TChannel>(BindingContext)	Membangun tumpukan pabrik saluran pada klien yang membuat jenis saluran tertentu untuk konteks tertentu.
BuildChannelListener<TChannel>(BindingContext)	Membangun tumpukan pendengar saluran pada klien yang menerima jenis saluran tertentu untuk konteks tertentu.
CanBuildChannelFactory<TChannel>(BindingContext)	Mengembalikan nilai yang menunjukkan apakah elemen pengikatan saat ini dapat membangun pabrik untuk jenis saluran dan konteks tertentu.
CanBuildChannelListener<TChannel>(BindingContext)	Mengembalikan nilai yang menunjukkan apakah pengikatan saat ini dapat membangun pendengar untuk jenis saluran dan konteks tertentu.
Clone()	Membuat objek baru ContextBindingElement yang diinisialisasi dari objek saat ini.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExportPolicy(MetadataExporter, PolicyConversionContext)	Menulis pernyataan kebijakan kustom ke dalam konteks elemen pengikatan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetProperty<T>(BindingContext)	Mengembalikan objek yang ditik dengan konteks yang ditentukan dari lapisan yang sesuai dalam tumpukan saluran.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk