NetHttpBinding 類別

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.dll, System.ServiceModel.Http.dll

套件:

System.ServiceModel.Http v10.0.652802, System.ServiceModel.Primitives v10.0.652802

來源:

NetHttpBinding.cs

指定 的 NetHttpBinding設定。

public ref class NetHttpBinding : System::ServiceModel::HttpBindingBase

public class NetHttpBinding : System.ServiceModel.HttpBindingBase

type NetHttpBinding = class
    inherit HttpBindingBase

Public Class NetHttpBinding
Inherits HttpBindingBase

繼承

Object

Binding

HttpBindingBase

NetHttpBinding

備註

NetHttpBinding 是專為取用 HTTP 或 WebSocket 服務而設計的系結，預設會使用二進位編碼。 注意：WebSockets 僅支援 Windows 8。 NetHttpBinding 會偵測它是與請求-回覆合約或雙工合約一起使用，並調整行為以匹配——它會使用 HTTP 作為請求-回覆，WebSockets 作為雙工（僅限於 Windows 8）。 此行為可透過將屬性設定 WebSocketTransportUsage 為以下其中之一來覆寫：

1. WhenDuplex-這是預設值，行為如上所述。

2. 絕不——這會阻止 WebSockets 的使用 嘗試搭配此設定使用雙工合約會導致例外狀況。

3. 始終 - 這強制使用 WebSockets 來執行請求-回覆合約。

NetHttpBinding 支援 HTTP 模式和 WebSocket 模式中的可靠會話。 在 WebSocket 模式中，會話是由傳輸提供的。

建構函式

名稱	Description
NetHttpBinding()	初始化 NetHttpBinding 類別的新執行個體。
NetHttpBinding(BasicHttpSecurityMode, Boolean)	初始化一個以指定安全模式的新類別實例 NetHttpBinding 。
NetHttpBinding(BasicHttpSecurityMode)	初始化一個以指定安全模式的新類別實例 NetHttpBinding 。

屬性

名稱	Description
AllowCookies	取得或設定一個值，指示客戶端是否接受 Cookie，並在未來請求中傳播。 (繼承來源 HttpBindingBase)
BypassProxyOnLocal	取得或設定一個值，指示是否繞過代理伺服器取得本地位址。 (繼承來源 HttpBindingBase)
CloseTimeout	取得或設定連接關閉的時間間隔，然後傳輸會提出例外。 (繼承來源 Binding)
EnvelopeVersion	取得用於此綁定處理訊息的 SOAP 版本。 (繼承來源 HttpBindingBase)
MaxBufferPoolSize	取得或設定分配給接收通道訊息緩衝區的管理者的最大記憶體容量（位元組）。 (繼承來源 HttpBindingBase)
MaxBufferSize	接收或設定接收通道訊息的緩衝區最大大小（以位元組為單位）。 (繼承來源 HttpBindingBase)
MaxReceivedMessageSize	接收或設定可在以此綁定設定的通道上接收訊息的最大大小（以位元組為單位）。 (繼承來源 HttpBindingBase)
MessageEncoding	取得或設定用於編碼訊息的訊息編碼類型。
MessageVersion	透過綁定設定，取得用戶端和服務使用的訊息版本。 (繼承來源 Binding)
Name	取得或設定綁定名稱。 (繼承來源 Binding)
Namespace	取得或設定綁定的 XML 命名空間。 (繼承來源 Binding)
OpenTimeout	取得或設定連線開啟的時間間隔，然後傳輸會提出例外。 (繼承來源 Binding)
ProxyAddress	取得或設定 HTTP 代理的 URI 位址。 (繼承來源 HttpBindingBase)
ReaderQuotas	取得或設定可由端點處理的 SOAP 訊息複雜度的限制。 (繼承來源 HttpBindingBase)
ReceiveTimeout	取得或設定連線可保持非活躍狀態（在此期間不接收任何應用程式訊息）的時間區間，然後才會被丟棄。 (繼承來源 Binding)
ReliableSession	取得或設定一個物件，指示通道端點間是否建立了可靠的會話。
Scheme	取得已設定此綁定的通道與監聽者的 URI 傳輸方案。 (繼承來源 HttpBindingBase)
Security	取得或設定與綁定服務相關的安全性。
SendTimeout	取得或設定寫入操作完成的時間間隔，然後傳輸會提出例外。 (繼承來源 Binding)
TextEncoding	取得或設定用於訊息文字的字元編碼。 (繼承來源 HttpBindingBase)
TransferMode	取得或設定一個值，表示訊息是緩衝還是串流傳送。 (繼承來源 HttpBindingBase)
UseDefaultWebProxy	取得或設定一個值，指示系統自動設定的 HTTP 代理是否應使用（若有的話）。 (繼承來源 HttpBindingBase)
WebSocketSettings	取得 websocket 的設定。

方法

名稱	Description
BuildChannelFactory<TChannel>(BindingParameterCollection)	在用戶端建立通道工廠堆疊，建立特定類型的通道，並滿足一組綁定參數所規定的功能。
BuildChannelFactory<TChannel>(Object[])	在用戶端建立通道工廠堆疊，建立特定類型的通道，並滿足物件陣列所指定的功能。 (繼承來源 Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	回傳一個值，表示目前綁定是否能在用戶端建立符合指定綁定參數集合的通道工廠堆疊。 (繼承來源 Binding)
CanBuildChannelFactory<TChannel>(Object[])	回傳一個值，指示目前綁定是否能在用戶端建立符合物件陣列要求的通道工廠堆疊。 (繼承來源 Binding)
CreateBindingElements()	建立包含該綁定元素的集合。
GetProperty<T>(BindingParameterCollection)	回傳一個從綁定堆疊中適當層請求的類型物件（若存在）。 (繼承來源 Binding)