WebMessageEncodingBindingElement 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 WebMessageEncodingBindingElement 類別的新執行個體。
多載
WebMessageEncodingBindingElement() |
初始化 WebMessageEncodingBindingElement 類別的新執行個體。 |
WebMessageEncodingBindingElement(Encoding) |
使用指定的寫入字元編碼,初始化 WebMessageEncodingBindingElement 類別的新執行個體。 |
WebMessageEncodingBindingElement()
初始化 WebMessageEncodingBindingElement 類別的新執行個體。
public:
WebMessageEncodingBindingElement();
public WebMessageEncodingBindingElement ();
Public Sub New ()
備註
這個建構函式會使用 UTF8Encoding 做為預設的字元編碼。 因此,當您需要這個字元編碼時,請使用這個建構函式。 如果您需要另一個字元編碼,請使用 WebMessageEncodingBindingElement(Encoding) 建構函式。
這個建構函式會設定配置到集區,以及分別可用來處理傳入和傳出訊息 (在不配置新的讀取器或寫入器的情況下) 之讀取器及寫入器數目上限的預設值。 根據預設,會為 MaxReadPoolSize 屬性配置 64 個讀取器,而為 MaxWritePoolSize 屬性配置 16 個寫入器。
預設複雜度條件約束也是由位於與此訊息編碼相關之 XmlDictionaryReaderQuotas 上的建構函式使用 ReaderQuotas 屬性設定,以防止阻絕服務 (DOS) 類別攻擊試圖使用訊息複雜度困住端點處理資源。 表示這些條件約束及其預設值 (以位元組為單位) 的屬性包括:
MaxDepth = 32
MaxStringContentLength = 8192
MaxArrayLength = 16384
MaxBytesPerRead = 4096
MaxNameTableCharCount = 16384
適用於
WebMessageEncodingBindingElement(Encoding)
使用指定的寫入字元編碼,初始化 WebMessageEncodingBindingElement 類別的新執行個體。
public:
WebMessageEncodingBindingElement(System::Text::Encoding ^ writeEncoding);
public WebMessageEncodingBindingElement (System.Text.Encoding writeEncoding);
new System.ServiceModel.Channels.WebMessageEncodingBindingElement : System.Text.Encoding -> System.ServiceModel.Channels.WebMessageEncodingBindingElement
Public Sub New (writeEncoding As Encoding)
參數
例外狀況
writeEncoding
為 null
。
writeEncoding
不是支援的訊息文字編碼。
備註
支援的訊息文字編碼有 UTF-8、Unicode 和 Big-Endian Unicode。 如果指定其他文字編碼,則會擲回 ArgumentException。
這個建構函式會設定配置到集區,以及分別可用來處理傳入和傳出訊息 (在不配置新的讀取器或寫入器的情況下) 之讀取器及寫入器數目上限的預設值。 根據預設,會為 MaxReadPoolSize 屬性配置 64 個讀取器,而為 MaxWritePoolSize 屬性配置 16 個寫入器。
預設複雜度條件約束也是由位於與此訊息編碼相關之 XmlDictionaryReaderQuotas 上的建構函式使用 ReaderQuotas 屬性設定,以防止阻絕服務 (DOS) 類別攻擊試圖使用訊息複雜度困住端點處理資源。 表示這些條件約束及其預設值 (以位元組為單位) 的屬性包括:
MaxDepth = 32
MaxStringContentLength = 8192
MaxArrayLength = 16384
MaxBytesPerRead = 4096
MaxNameTableCharCount = 16384