WebMessageEncodingBindingElement Kelas

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

System.ServiceModel.Web.dll

Memungkinkan pengodean pesan XML, JavaScript Object Notation (JSON) teks biasa, dan konten biner "mentah" untuk dibaca dan ditulis saat digunakan dalam pengikatan Windows Communication Foundation (WCF).

public ref class WebMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IWsdlExportExtension

public sealed class WebMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IWsdlExportExtension

type WebMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension

Public NotInheritable Class WebMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IWsdlExportExtension

Warisan

Object

BindingElement

MessageEncodingBindingElement

WebMessageEncodingBindingElement

Penerapan

IWsdlExportExtension

Keterangan

Pengodean adalah proses mengubah pesan menjadi urutan byte. Decoding adalah proses sebaliknya. Proses ini memerlukan spesifikasi pengodean karakter. Bekerja WebMessageEncodingBindingElement dengan mendelegasikan ke serangkaian encoder dalam untuk menangani pengodean XML teks biasa dan JSON, dan data biner "mentah". Delegasi ini dilakukan oleh encoder pesan komposit.

Elemen pengikatan ini dan encoder kompositnya digunakan untuk mengontrol pengodean dalam skenario yang tidak menggunakan olahpesan SOAP yang digunakan oleh WebHttpBinding. Skenario ini termasuk "XML Lama Mentah" (POX), Representational State Transfer (REST), Sindikasi yang Sangat Sederhana(RSS) dan sindikasi Atom, serta Asynchronous JavaScript and XML (AJAX). Encoder pesan komposit tidak mendukung SOAP atau WS-Addressing, sehingga MessageVersion selalu mengembalikan None.

Elemen pengikatan dapat dikonfigurasi dengan pengodean karakter tulis pada waktu konstruksi menggunakan WebMessageEncodingBindingElement(Encoding) konstruktor. Nilai Encoding menentukan perilaku menulis untuk kasus JSON dan XML Tekstual. Saat dibaca, semua pengodean pesan dan pengodean teks yang valid dipahami.

Konstruktor ini menetapkan nilai default pada jumlah maksimum pembaca dan penulis yang dialokasikan untuk kumpulan dan yang masing-masing tersedia untuk memproses pesan masuk dan keluar tanpa mengalokasikan pembaca atau penulis baru. Properti MaxReadPoolSize dan MaxWritePoolSize juga dapat digunakan untuk mengatur jumlah maksimum pembaca dan penulis untuk dialokasikan masing-masing. Secara default 64 pembaca dan 16 penulis dialokasikan.

Batasan kompleksitas default juga ditetapkan oleh konstruktor ini pada XmlDictionaryReaderQuotas yang terkait dengan pengodean ini oleh ReaderQuotas properti untuk melindungi dari serangan kelas penolakan layanan (DOS) yang mencoba menggunakan kompleksitas pesan untuk mengikat sumber daya pemrosesan titik akhir.

WebMessageEncodingBindingElement memiliki CreateMessageEncoderFactory metode yang membuat pabrik encoder pesan yang menghasilkan JSON, XML atau Dekoder pesan mentah dan encoder yang sesuai tergantung pada jenis konten yang ditentukan.

juga WebMessageEncodingBindingElement menyediakan metode untuk membangun pabrik dan pendengar untuk saluran tempat permintaan HTTP mengalir.

Encoder komposit dan kelas dan komponen konfigurasi terkait dapat digunakan dalam kepercayaan parsial dan penggunaan ini tidak memerlukan izin khusus.

Konstruktor

WebMessageEncodingBindingElement()	Menginisialisasi instans baru kelas WebMessageEncodingBindingElement.
WebMessageEncodingBindingElement(Encoding)	Menginisialisasi instans WebMessageEncodingBindingElement baru kelas dengan pengodean karakter tulis tertentu.

Properti

ContentTypeMapper	Mendapatkan atau mengatur bagaimana tipe konten pesan masuk dipetakan ke format.
CrossDomainScriptAccessEnabled	Mendapatkan atau menetapkan nilai yang menentukan apakah akses skrip lintas domain diaktifkan.
MaxReadPoolSize	Mendapatkan atau menetapkan nilai yang menentukan jumlah maksimum pembaca yang dialokasikan ke kumpulan dan yang tersedia untuk memproses pesan masuk tanpa mengalokasikan pembaca baru.
MaxWritePoolSize	Mendapatkan atau menetapkan nilai yang menentukan jumlah maksimum penulis yang dialokasikan ke kumpulan dan yang tersedia untuk memproses pesan keluar tanpa mengalokasikan penulis baru.
MessageVersion	Mendapatkan atau mengatur versi pesan yang menunjukkan bahwa elemen pengikatan tidak menggunakan SOAP atau WS-Addressing.
ReaderQuotas	Mendapatkan batasan pada kompleksitas pesan SOAP yang dapat diproses oleh titik akhir yang dikonfigurasi dengan pengikatan ini.
WriteEncoding	Mendapatkan atau mengatur pengodean karakter yang digunakan untuk menulis teks pesan.

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 dapat membangun pabrik saluran untuk jenis saluran tertentu. (Diperoleh dari BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)	Mengembalikan nilai yang menunjukkan apakah pengikatan saat ini dapat membangun pendengar untuk jenis saluran dan konteks tertentu.
Clone()	Membuat objek baru WebMessageEncodingBindingElement yang diinisialisasi dari objek saat ini.
CreateMessageEncoderFactory()	Membuat pabrik encoder pesan yang menghasilkan encoder pesan yang dapat menulis pesan JavaScript Object Notation (JSON) atau XML.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetProperty<T>(BindingContext)	Mengembalikan objek jenis yang diminta, jika ada, dari lapisan yang sesuai di tumpukan saluran, atau null jika tidak ada.
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)

Implementasi Antarmuka Eksplisit

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)	Menghasilkan informasi kontrak WSDL dari kebijakan pengodean yang terkandung dalam elemen pengikatan.
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)	Menghasilkan informasi kontrak WSDL dari kebijakan pengodean yang terkandung dalam elemen pengikatan.