WSFederationHttpBinding 類別

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.dll

支援聯合安全性的安全且可互通的繫結。

public ref class WSFederationHttpBinding : System::ServiceModel::WSHttpBindingBase

public class WSFederationHttpBinding : System.ServiceModel.WSHttpBindingBase

type WSFederationHttpBinding = class
    inherit WSHttpBindingBase

Public Class WSFederationHttpBinding
Inherits WSHttpBindingBase

繼承

Object

Binding

WSHttpBindingBase

WSFederationHttpBinding

衍生

System.ServiceModel.WS2007FederationHttpBinding

備註

聯合是在多個系統上共用識別以便進行驗證和授權的能力。 這些識別可以指向使用者或電腦。 聯合 HTTP 支援 SOAP 安全性以及混合模式安全性，但不支援獨立使用傳輸安全性。 此系結提供 windows Communication Foundation (WCF) 支援WS-Federation通訊協定。 使用這個繫結設定的服務必須使用 HTTP 傳輸。

繫結是由繫結項目的堆疊組成。 WSFederationHttpBinding 中繫結項目的堆疊，與 WSHttpBinding 設定為 Security 的預設值時 Message 所包含的堆疊相同。

WSFederationHttpBinding 會控制訊息安全性設定的詳細資料，其值可從由 FederatedMessageSecurityOverHttp 屬性傳回的 Message 的執行個體取得。

WSFederationHttpBinding 也會提供 PrivacyNoticeAt 屬性，在隱私權注意事項所在的位置設定及擷取 URI。

注意

從以 .NET Framework 3.5 或更早版本建置的 WCF 用戶端應用程式呼叫使用 .NET Framework 4.0 或更新版本建置的 WCF 服務時，svcutil.exe或從 Visual Studio 新增服務參考所產生的組態檔包含 establishSecurityContext 系結組態中的 屬性。 .NET Framework 3.5 執行時間無法辨識此屬性，而應用程式擲 ConfigurationErrorsException 回訊息為「無法辨識的屬性建立SecurityCoNtext」。 若要解決此問題，請從系 establishSecurityContext 結組態中移除 屬性。

建構函式

WSFederationHttpBinding()	初始化 WSFederationHttpBinding 類別的新執行個體。
WSFederationHttpBinding(String)	使用由組態名稱指定的繫結，初始化 WSFederationHttpBinding 類別的新執行個體。
WSFederationHttpBinding(WSFederationHttpSecurityMode)	使用由繫結所使用之安全性的指定類型，初始化 WSFederationHttpBinding 類別的新執行個體。
WSFederationHttpBinding(WSFederationHttpSecurityMode, Boolean)	使用由繫結所使用之安全性的指定類型以及表示是否啟用可靠工作階段的值，初始化 WSFederationHttpBinding 類別的新執行個體。

屬性

BypassProxyOnLocal	取得或設定值，這個值表示是否略過 Proxy 伺服器而改用本機位址。 (繼承來源 WSHttpBindingBase)
CloseTimeout	取得或設定針對連線所提供的時間間隔 (此連線要在傳輸引發例外狀況之前關閉)。 (繼承來源 Binding)
EnvelopeVersion	取得 SOAP 的版本，這個版本是用於由此繫結處理的訊息。 (繼承來源 WSHttpBindingBase)
HostNameComparisonMode	取得或設定值，這個值會指出在比對 URI 時此主機名稱是否會用來取用服務。 (繼承來源 WSHttpBindingBase)
MaxBufferPoolSize	取得或設定配置供訊息緩衝區管理員使用的最大記憶體量 (以位元組為單位)，緩衝區管理員管理使用此繫結之端點所需緩衝區。 (繼承來源 WSHttpBindingBase)
MaxReceivedMessageSize	取得或設定可由繫結處理之訊息的大小上限 (以位元組為單位)。 (繼承來源 WSHttpBindingBase)
MessageEncoding	取得或設定是否要使用 MTOM 或 Text/XML 來編碼 SOAP 訊息。 (繼承來源 WSHttpBindingBase)
MessageVersion	取得用戶端所使用的訊息版本及使用繫結所設定的服務。 (繼承來源 Binding)
Name	取得或設定繫結的名稱。 (繼承來源 Binding)
Namespace	取得或設定繫結的 XML 命名空間。 (繼承來源 Binding)
OpenTimeout	取得或設定針對連線所提供的時間間隔 (此連線要在傳輸引發例外狀況之前開啟)。 (繼承來源 Binding)
PrivacyNoticeAt	取得或設定隱私權注意事項所在的 URI。
PrivacyNoticeVersion	取得或設定繫結的隱私權注意事項版本號碼。
ProxyAddress	取得或設定 HTTP Proxy 的 URI 位址。 (繼承來源 WSHttpBindingBase)
ReaderQuotas	取得或設定 SOAP 訊息複雜性的條件約束，而這些條件約束可由以此繫結所設定的端點處理。 (繼承來源 WSHttpBindingBase)
ReceiveTimeout	取得或設定連線中斷之前，可以維持非作用狀態的時間間隔 (在此期間未接收應用程式訊息)。 (繼承來源 Binding)
ReliableSession	取得物件，這個物件可方便您存取可靠工作階段繫結項目的屬性，只要使用其中一個系統提供的繫結，就可以使用這些屬性。 (繼承來源 WSHttpBindingBase)
Scheme	取得使用這項繫結所設定之通道與接聽程式的 URI 傳輸配置。 (繼承來源 WSHttpBindingBase)
Security	取得或設定要搭配此繫結使用的安全性類型。
SendTimeout	取得或設定針對寫入作業所提供的時間間隔 (此作業要在傳輸引發例外狀況之前完成)。 (繼承來源 Binding)
TextEncoding	取得或設定用於訊息文字的字元編碼。 (繼承來源 WSHttpBindingBase)
TransactionFlow	取得或設定值，這個值會指出此繫結程序是否應支援流動 WS-Transactions。 (繼承來源 WSHttpBindingBase)
UseDefaultWebProxy	取得或設定值，這個值會指出是否應使用系統自動設定的 HTTP Proxy (如果有的話)。 (繼承來源 WSHttpBindingBase)

方法

BuildChannelFactory<TChannel>(BindingParameterCollection)	在用戶端上建置通道處理站堆疊，此堆疊會建立指定的通道型別，並滿足繫結參數集合所指定的功能。 (繼承來源 Binding)
BuildChannelFactory<TChannel>(Object[])	在用戶端上建置通道處理站堆疊，此堆疊會建立指定的通道型別，並滿足物件陣列所指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	在服務上建置通道接聽程式，此接聽程式會接受指定的通道型別，並滿足繫結參數集合所指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Object[])	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, Object[])	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	傳回值，這個值指出目前的繫結是否可以在用戶端上建置滿足指定之繫結參數集合的通道處理站堆疊。 (繼承來源 Binding)
CanBuildChannelFactory<TChannel>(Object[])	傳回值，這個值指出目前的繫結程序是否可以在用戶端上建置滿足物件陣列指定之需求的通道處理站堆疊。 (繼承來源 Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	傳回值，這個值指出目前的繫結是否可以在服務上建置滿足指定之繫結參數集合的通道接聽程式堆疊。 (繼承來源 Binding)
CanBuildChannelListener<TChannel>(Object[])	傳回值，這個值指出目前的繫結是否可以在服務上建置滿足物件陣列中指定之準則的通道接聽程式堆疊。 (繼承來源 Binding)
CreateBindingElements()	建立含有繫結之繫結項目的集合。
CreateMessageSecurity()	建立已啟用可靠工作階段的 SecurityBindingElement。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetProperty<T>(BindingParameterCollection)	從繫結堆疊的適當層次中，傳回要求的型別物件 (如果有)。 (繼承來源 Binding)
GetTransport()	從目前繫結傳回傳輸繫結項目。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ShouldSerializeName()	傳回繫結的名稱是否應該序列化。 (繼承來源 Binding)
ShouldSerializeNamespace()	傳回繫結的命名空間是否應該序列化。 (繼承來源 Binding)
ShouldSerializeReaderQuotas()	傳回值，這個值表示 ReaderQuotas 屬性是否已變更為非預設值且應該序列化。 (繼承來源 WSHttpBindingBase)
ShouldSerializeReliableSession()	傳回值，這個值表示 ReliableSession 屬性是否已變更為非預設值且應該序列化。 (繼承來源 WSHttpBindingBase)
ShouldSerializeSecurity()	傳回值，這個值表示 Security 屬性是否已變更為非預設值且應該序列化。
ShouldSerializeTextEncoding()	傳回值，這個值表示 TextEncoding 屬性是否已變更為非預設值且應該序列化。 (繼承來源 WSHttpBindingBase)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IBindingRuntimePreferences.ReceiveSynchronously

取得值，這個值會指出要以同步或非同步方式處理傳入要求。 (繼承來源 WSHttpBindingBase)