語言

IClientChannel 介面

定義

定義用戶端應用程式所使用的輸出要求和要求/回復通道的行為。

public interface class IClientChannel : IDisposable, System::ServiceModel::IContextChannel, System::ServiceModel::IExtensibleObject<System::ServiceModel::IContextChannel ^>
public interface IClientChannel : IDisposable, System.ServiceModel.IContextChannel, System.ServiceModel.IExtensibleObject<System.ServiceModel.IContextChannel>
type IClientChannel = interface
    interface IDisposable
    interface IContextChannel
    interface IChannel
    interface ICommunicationObject
    interface IExtensibleObject<IContextChannel>
type IClientChannel = interface
    interface IDisposable
    interface IChannel
    interface ICommunicationObject
    interface IContextChannel
    interface IExtensibleObject<IContextChannel>
type IClientChannel = interface
    interface IContextChannel
    interface IChannel
    interface ICommunicationObject
    interface IExtensibleObject<IContextChannel>
    interface IDisposable
Public Interface IClientChannel
Implements IContextChannel, IDisposable, IExtensibleObject(Of IContextChannel)
衍生
實作

備註

介面 IClientChannel 定義了所有由呼叫回傳的 ChannelFactory<TChannel>.CreateChannel通道所支援的操作。 使用這些 IClientChannel 方法與屬性來檢查並修改外站的類型通道。 ServiceModel Metadata Utility Tool(Svcutil.exe)透過ClientBase<TChannel>建立一個承襲目標服務合約IClientChannel與 的合約介面,匯出類別與服務合約介面,使擴展合約能同時作為服務代理並存取用戶端通道。

欲了解更多資訊,請參閱 WCF 用戶端架構。 關於其在產生的用戶端程式碼檔案中的出現範例,請參見 「理解產生的用戶端程式碼」。

屬性

名稱 Description
AllowInitializationUI

取得或設定一個值,指示是否 DisplayInitializationUI() 嘗試呼叫 IInteractiveChannelInitializer 該屬性中的 InteractiveChannelInitializers 物件,或如果該集合非空時拋出。

AllowOutputBatching

取得或設定一個值,指示 Windows 通訊基礎(WCF)在將訊息交給傳輸前儲存一組訊息。

(繼承來源 IContextChannel)
DidInteractiveInitialization

會取得一個值,表示是否曾呼叫使用者介面以取得憑證資訊。

Extensions

會得到一組可擴充物件的擴充物件。

(繼承來源 IExtensibleObject<T>)
InputSession

取得該通道的輸入會話。

(繼承來源 IContextChannel)
LocalAddress

取得該頻道的本地端點。

(繼承來源 IContextChannel)
OperationTimeout

取得或設定操作必須完成或拋出例外的時間範圍。

(繼承來源 IContextChannel)
OutputSession

取得與該通道相關的輸出會話(如果有的話)。

(繼承來源 IContextChannel)
RemoteAddress

取得與頻道相關的遠端位址。

(繼承來源 IContextChannel)
SessionId

回傳目前會話的識別碼(若有的話)。

(繼承來源 IContextChannel)
State

取得通訊導向物件的目前狀態。

(繼承來源 ICommunicationObject)
Via

取得包含傳送位址的 URI,該位址用於用戶端通道傳送訊息。

方法

名稱 Description
Abort()

導致通訊物件立即從其目前狀態轉換成已關閉狀態。

(繼承來源 ICommunicationObject)
BeginClose(AsyncCallback, Object)

開始異步操作以關閉通訊物件。

(繼承來源 ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

開始異步操作,以關閉具有指定逾時的通訊物件。

(繼承來源 ICommunicationObject)
BeginDisplayInitializationUI(AsyncCallback, Object)

非同步呼叫,開始使用使用者介面取得憑證資訊。

BeginOpen(AsyncCallback, Object)

開始異步操作以開啟通訊物件。

(繼承來源 ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

開始異步操作,以在指定的時間間隔內開啟通訊物件。

(繼承來源 ICommunicationObject)
Close()

使通訊物件從其目前狀態轉換成已關閉狀態。

(繼承來源 ICommunicationObject)
Close(TimeSpan)

使通訊物件從其目前狀態轉換成已關閉狀態。

(繼承來源 ICommunicationObject)
DisplayInitializationUI()

呼叫使用者介面以取得憑證資訊。

Dispose()

執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。

(繼承來源 IDisposable)
EndClose(IAsyncResult)

完成異步操作以關閉通訊物件。

(繼承來源 ICommunicationObject)
EndDisplayInitializationUI(IAsyncResult)

通話結束後 BeginDisplayInitializationUI(AsyncCallback, Object) 才打電話。

EndOpen(IAsyncResult)

完成異步操作以開啟通訊物件。

(繼承來源 ICommunicationObject)
GetProperty<T>()

回傳一個從通道堆疊中適當層請求的類型物件(若存在)。

(繼承來源 IChannel)
Open()

使通訊物件從已建立的狀態轉換成開啟的狀態。

(繼承來源 ICommunicationObject)
Open(TimeSpan)

使通訊物件在指定的時間間隔內,從建立的狀態轉換成開啟的狀態。

(繼承來源 ICommunicationObject)

事件

名稱 Description
Closed

當通訊物件完成從關閉狀態轉換成關閉狀態時發生。

(繼承來源 ICommunicationObject)
Closing

當通訊物件第一次進入關閉狀態時發生。

(繼承來源 ICommunicationObject)
Faulted

當通訊物件第一次進入錯誤狀態時發生。

(繼承來源 ICommunicationObject)
Opened

當通訊物件完成從開啟狀態轉換成開啟狀態時發生。

(繼承來源 ICommunicationObject)
Opening

當通訊物件第一次進入開啟狀態時發生。

(繼承來源 ICommunicationObject)
UnknownMessageReceived

這是保留活動。

適用於