WebMessageEncodingBindingElement 建構函式

  • 參考

定義

命名空間:
System.ServiceModel.Channels
組件:
System.ServiceModel.Web.dll

初始化 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) 類別攻擊試圖使用訊息複雜度困住端點處理資源。 表示這些條件約束及其預設值 (以位元組為單位) 的屬性包括：

適用於

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
Encoding

要在訊息中寫入字元時所使用的 Encoding。

例外狀況

ArgumentNullException

writeEncoding 為 null。

ArgumentException

writeEncoding 不是支援的訊息文字編碼。

備註

支援的訊息文字編碼有 UTF-8、Unicode 和 Big-Endian Unicode。 如果指定其他文字編碼，則會擲回 ArgumentException。

這個建構函式會設定配置到集區，以及分別可用來處理傳入和傳出訊息 (在不配置新的讀取器或寫入器的情況下) 之讀取器及寫入器數目上限的預設值。 根據預設，會為 MaxReadPoolSize 屬性配置 64 個讀取器，而為 MaxWritePoolSize 屬性配置 16 個寫入器。

預設複雜度條件約束也是由位於與此訊息編碼相關之 XmlDictionaryReaderQuotas 上的建構函式使用 ReaderQuotas 屬性設定，以防止阻絕服務 (DOS) 類別攻擊試圖使用訊息複雜度困住端點處理資源。 表示這些條件約束及其預設值 (以位元組為單位) 的屬性包括：

適用於