ClientBase<TChannel> 類別

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v8.0.0

來源:

ClientBase.cs

提供用來建立可呼叫服務的 Windows Communication Foundation （WCF） 客戶端物件的基底實作。

C#

public abstract class ClientBase<TChannel> : IAsyncDisposable, IDisposable, System.ServiceModel.ICommunicationObject where TChannel : class

類型參數

TChannel

要用來連線到服務的通道。

繼承

Object

ClientBase<TChannel>

衍生

System.ServiceModel.Activities.WorkflowControlClient

System.ServiceModel.Activities.WorkflowUpdateableControlClient

System.ServiceModel.DuplexClientBase<TChannel>

實作

ICommunicationObject IAsyncDisposable IDisposable

範例

下列程式代碼範例示範如何 ServiceModel 元數據公用程式工具 （Svcutil.exe） 擴充 ClientBase<TChannel> 類別來建立 WCF 用戶端類別。

C#

public partial class SampleServiceClient : System.ServiceModel.ClientBase<ISampleService>, ISampleService
{

    public SampleServiceClient()
    {
    }

    public SampleServiceClient(string endpointConfigurationName) :
            base(endpointConfigurationName)
    {
    }

    public SampleServiceClient(string endpointConfigurationName, string remoteAddress) :
            base(endpointConfigurationName, remoteAddress)
    {
    }

    public SampleServiceClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) :
            base(endpointConfigurationName, remoteAddress)
    {
    }

    public SampleServiceClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) :
            base(binding, remoteAddress)
    {
    }

    public string SampleMethod(string msg)
    {
        return base.Channel.SampleMethod(msg);
    }
}

備註

擴充 ClientBase<TChannel> 類別，以建立可用來連線至服務的自定義WCF客戶端物件。 一般而言，WCF 用戶端基類是由代表您 ServiceModel 元數據公用程式工具（Svcutil.exe） 之類的工具擴充。 如需範例，請參閱範例一節。

ClientBase<TChannel> 類別可供偏好物件使用介面和 System.ServiceModel.ChannelFactory<TChannel> 類別的開發人員快速且輕鬆地使用。 在所有情況下，這個類別都會包裝或公開 System.ServiceModel.ChannelFactory<TChannel> 類別和 System.ServiceModel.IClientChannel 介面的方法和功能。

如同使用 System.ServiceModel.ServiceHost 類別，您可以在進行任何呼叫或呼叫 Open之前，先建立 類別並修改端點、通道處理站或安全性資訊。 如需詳細資訊，請參閱 WCF 用戶端概觀 和使用 WCF 用戶端存取服務 。

衍生自此類別之 Managed C++使用者的特殊注意事項：

• 將您的清除程序代碼放在 （On）（Begin）Close （and/或 OnAbort），而不是解構函式中。

• 避免解構函式：它們會導致編譯程式自動產生 IDisposable。

• 避免非參考成員：它們可能會導致編譯程式自動產生 IDisposable。

• 避免完成項;但是，如果您包含一個，您應該隱藏組建警告，並從 （On）（Begin）Close （and/或 OnAbort） 呼叫 SuppressFinalize(Object) 和完成項本身，以模擬自動產生的 IDisposable 行為。

建構函式

ClientBase<TChannel>()	使用應用程式組態檔的預設目標端點，初始化 ClientBase<TChannel> 類別的新實例。
ClientBase<TChannel>(Binding, EndpointAddress)	使用指定的系結和目標位址，初始化 ClientBase<TChannel> 類別的新實例。
ClientBase<TChannel>(ServiceEndpoint)	使用指定的 ServiceEndpoint，初始化 ClientBase<TChannel> 類別的新實例。

屬性

CacheSetting	取得或設定快取設定。
Channel	取得用來將訊息傳送至各種設定服務端點的內部通道。
ChannelFactory	取得基礎 ChannelFactory<TChannel> 物件。
ClientCredentials	取得用來呼叫作業的客戶端認證。
Endpoint	取得 WCF 用戶端可以連線之服務的目標端點。
InnerChannel	取得基礎 IClientChannel 實作。
State	取得 ClientBase<TChannel> 物件的目前狀態。

方法

Abort()	讓 ClientBase<TChannel> 物件立即從其目前狀態轉換成已關閉狀態。
Close()	使 ClientBase<TChannel> 物件從目前狀態轉換成關閉狀態。
CloseAsync()	提供用來建立可呼叫服務的 Windows Communication Foundation （WCF） 客戶端物件的基底實作。
CreateChannel()	傳回服務的新通道。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetDefaultValueForInitialization<T>()	復寫 C# 中預設關鍵詞的行為。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
InvokeAsync(ClientBase<TChannel>.BeginOperationDelegate, Object[], ClientBase<TChannel>.EndOperationDelegate, SendOrPostCallback, Object)	提供實作事件架構異步模式的支援。 如需此模式的詳細資訊，請參閱 事件架構異步模式概觀。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
Open()	使 ClientBase<TChannel> 物件從已建立的狀態轉換成開啟的狀態。
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

明確介面實作

IAsyncDisposable.DisposeAsync()	提供用來建立可呼叫服務的 Windows Communication Foundation （WCF） 客戶端物件的基底實作。
ICommunicationObject.BeginClose(AsyncCallback, Object)	開始異步操作以關閉 ClientBase<TChannel>。
ICommunicationObject.BeginClose(TimeSpan, AsyncCallback, Object)	開始異步操作，以使用指定的逾時關閉 ClientBase<TChannel>。
ICommunicationObject.BeginOpen(AsyncCallback, Object)	開始異步操作，以開啟 ClientBase<TChannel> 物件。
ICommunicationObject.BeginOpen(TimeSpan, AsyncCallback, Object)	開始異步操作，以在指定的時間間隔內開啟 ClientBase<TChannel> 物件。
ICommunicationObject.Close()	使通訊物件從其目前狀態轉換成已關閉狀態。
ICommunicationObject.Close(TimeSpan)	使 ClientBase<TChannel> 物件從目前狀態轉換成關閉狀態。
ICommunicationObject.Closed	當 ClientBase<TChannel> 物件從目前狀態轉換為已關閉狀態時所叫用的事件處理程式。
ICommunicationObject.Closing	當 ClientBase<TChannel> 物件從目前狀態轉換為關閉狀態時所叫用的事件處理程式。
ICommunicationObject.EndClose(IAsyncResult)	完成異步操作以關閉 ClientBase<TChannel> 物件。
ICommunicationObject.EndOpen(IAsyncResult)	完成異步操作以開啟 ClientBase<TChannel> 物件。
ICommunicationObject.Faulted	在 ClientBase<TChannel> 對象上執行作業時發生錯誤時所叫用的事件處理程式。
ICommunicationObject.Open()	使通訊物件從已建立的狀態轉換成開啟的狀態。
ICommunicationObject.Open(TimeSpan)	使 ClientBase<TChannel> 物件在指定的時間間隔內，從建立的狀態轉換成開啟的狀態。
ICommunicationObject.Opened	當 ClientBase<TChannel> 物件從建立的狀態轉換為開啟狀態時所叫用的事件處理程式。
ICommunicationObject.Opening	當 ClientBase<TChannel> 物件從建立的狀態轉換為開啟狀態時所叫用的事件處理程式。
IDisposable.Dispose()	明確實作 Dispose() 方法。

擴充方法

ConfigureAwait(IAsyncDisposable, Boolean)

設定如何執行從異步可處置專案傳回的工作等候。

適用於