StreamSecurityUpgradeProvider 類別

定義

命名空間:: System.ServiceModel.Channels

組件:: System.ServiceModel.dll, System.ServiceModel.NetFramingBase.dll

組件:: System.ServiceModel.dll

套件:: System.ServiceModel.NetFramingBase v10.0.652802, System.ServiceModel.Primitives v10.0.652802

來源:: StreamSecurityUpgradeProvider.cs

來源:: StreamSecurityUpgradeProvider.cs

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

實作自屬的安全升級提供者，繼承自此 abstract 基底類別。

public ref class StreamSecurityUpgradeProvider abstract : System::ServiceModel::Channels::StreamUpgradeProvider

public abstract class StreamSecurityUpgradeProvider : System.ServiceModel.Channels.StreamUpgradeProvider

type StreamSecurityUpgradeProvider = class
    inherit StreamUpgradeProvider

Public MustInherit Class StreamSecurityUpgradeProvider
Inherits StreamUpgradeProvider

繼承: Object

CommunicationObject

StreamUpgradeProvider
StreamSecurityUpgradeProvider

備註

要新增安全升級，你需要實作一個由衍生出 StreamSecurityUpgradeProvider的類別。

升級流程包含以下步驟：

實作一個從 StreamSecurityUpgradeProvider 衍生的類別。
登記它。你可以為它建立一個綁定元素，並在自訂綁定中註冊提供者來達成這個目標。
你實作的衍生類別會建立一個的 StreamSecurityUpgradeInitiator實例，執行時會向連線另一端發起請求，以升級通道傳輸層。
你實作的衍生類別會建立一個的 StreamSecurityUpgradeAcceptor實例，執行時會接收前一步的升級請求，若可能，接受升級，並將升級後的串流回傳到連線的另一端。

安全升級請求可以是眾多類似請求之一。如果是這樣，請求會以明確的順序處理。如需詳細資訊，請參閱StreamUpgradeProvider。

建構函式

名稱	Description
StreamSecurityUpgradeProvider()	初始化 StreamSecurityUpgradeProvider 類別的新執行個體。
StreamSecurityUpgradeProvider(IDefaultCommunicationTimeouts)	初始化 StreamSecurityUpgradeProvider 類別的新執行個體。

屬性

名稱	Description
DefaultCloseTimeout	會觸發 DefaultCloseTimeout。 (繼承來源 StreamUpgradeProvider)
DefaultOpenTimeout	會觸發 defaultOpenTimeout。 (繼承來源 StreamUpgradeProvider)
Identity	取得用於安全升級的身份。
IsDisposed	會得到一個值，表示通訊物件是否已被處置。 (繼承來源 CommunicationObject)
State	會得到一個表示通訊物件當前狀態的值。 (繼承來源 CommunicationObject)
ThisLock	取得互斥鎖，保護類別實例在狀態轉換期間。 (繼承來源 CommunicationObject)

方法

名稱	Description
Abort()	會使通訊物件立即從當前狀態轉換到關閉狀態。 (繼承來源 CommunicationObject)
BeginClose(AsyncCallback, Object)	開始異步操作以關閉通訊物件。 (繼承來源 CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	開始異步操作，以關閉具有指定逾時的通訊物件。 (繼承來源 CommunicationObject)
BeginOpen(AsyncCallback, Object)	開始異步操作以開啟通訊物件。 (繼承來源 CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	開始異步操作，以在指定的時間間隔內開啟通訊物件。 (繼承來源 CommunicationObject)
Close()	使通訊物件從其目前狀態轉換成已關閉狀態。 (繼承來源 CommunicationObject)
Close(TimeSpan)	使通訊物件在指定時間間隔內從當前狀態轉換到封閉狀態。 (繼承來源 CommunicationObject)
CreateUpgradeAcceptor()	建立的實例 StreamUpgradeAcceptor。 (繼承來源 StreamUpgradeProvider)
CreateUpgradeInitiator(EndpointAddress, Uri)	建立的實例 StreamUpgradeInitiator。 (繼承來源 StreamUpgradeProvider)
EndClose(IAsyncResult)	完成異步操作以關閉通訊物件。 (繼承來源 CommunicationObject)
EndOpen(IAsyncResult)	完成異步操作以開啟通訊物件。 (繼承來源 CommunicationObject)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Fault()	會使通訊物件從當前狀態轉換到故障狀態。 (繼承來源 CommunicationObject)
GetCommunicationObjectType()	取得通訊對象的類型。 (繼承來源 CommunicationObject)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetProperty<T>()	當在衍生類別中實作時，會獲得當前串流的屬性，代表串流升級的發起者。 (繼承來源 StreamUpgradeProvider)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
OnAbort()	在通訊物件因呼叫同步中止操作而轉換至關閉狀態後，插入處理程序。 (繼承來源 CommunicationObject)
OnBeginClose(TimeSpan, AsyncCallback, Object)	在通訊物件因呼叫非同步關閉操作而轉換至關閉狀態後，插入處理。 (繼承來源 CommunicationObject)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	在通訊物件因呼叫非同步開啟操作而轉換至開啟狀態後，插入處理。 (繼承來源 CommunicationObject)
OnClose(TimeSpan)	在通訊物件因呼叫同步關閉操作而轉換至關閉狀態後，插入處理程序。 (繼承來源 CommunicationObject)
OnClosed()	在通訊物件轉換到關閉狀態時被呼叫。 (繼承來源 CommunicationObject)
OnClosing()	在通訊物件轉換到關閉狀態時被呼叫。 (繼承來源 CommunicationObject)
OnEndClose(IAsyncResult)	完成對通訊物件關閉的非同步操作。 (繼承來源 CommunicationObject)
OnEndOpen(IAsyncResult)	完成對通訊物件開啟的非同步操作。 (繼承來源 CommunicationObject)
OnFaulted()	在通訊物件因呼叫同步故障操作而轉換到故障狀態後，插入處理程序。 (繼承來源 CommunicationObject)
OnOpen(TimeSpan)	在通訊物件轉換進入開啟狀態後插入處理，該狀態必須在指定時間內完成。 (繼承來源 CommunicationObject)
OnOpened()	在通訊物件轉換到開啟狀態時被呼叫。 (繼承來源 CommunicationObject)
OnOpening()	在通訊物件轉換到開啟狀態時被呼叫。 (繼承來源 CommunicationObject)
Open()	使通訊物件從已建立的狀態轉換成開啟的狀態。 (繼承來源 CommunicationObject)
Open(TimeSpan)	使通訊物件在指定的時間間隔內，從建立的狀態轉換成開啟的狀態。 (繼承來源 CommunicationObject)
ThrowIfDisposed()	若通訊物件被丟棄，則拋出例外。 (繼承來源 CommunicationObject)
ThrowIfDisposedOrImmutable()	如果通訊物件該 State 屬性未設定為 Created 狀態，則會拋出例外。 (繼承來源 CommunicationObject)
ThrowIfDisposedOrNotOpen()	如果通訊物件不在該 Opened 狀態，會拋出例外。 (繼承來源 CommunicationObject)
ToString()	傳回表示目前物件的字串。 (繼承來源 Object)

事件

名稱	Description
Closed	當通訊物件轉換到封閉狀態時，會發生這種情況。 (繼承來源 CommunicationObject)
Closing	當通訊物件轉換到關閉狀態時，會發生這種情況。 (繼承來源 CommunicationObject)
Faulted	當通訊物件轉換到錯誤狀態時，會發生這種情況。 (繼承來源 CommunicationObject)
Opened	當通訊物件轉換進入開啟狀態時，會發生這種情況。 (繼承來源 CommunicationObject)
Opening	當通訊物件轉換到開啟狀態時，會發生這種情況。 (繼承來源 CommunicationObject)

適用於

另請參閱

自定義串流升級

意見反應

此頁面對您有幫助嗎？