ClientBase<TChannel> Sınıf

Tanım

Ad Alanı:

System.ServiceModel

Bütünleştirilmiş Kod:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Kaynak:

ClientBase.cs

Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar.

generic <typename TChannel>
 where TChannel : classpublic ref class ClientBase abstract : IAsyncDisposable, IDisposable, System::ServiceModel::ICommunicationObject

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

type ClientBase<'Channel (requires 'Channel : null)> = class
    interface ICommunicationObject
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class ClientBase(Of TChannel)
Implements IAsyncDisposable, ICommunicationObject, IDisposable

Tür Parametreleri

TChannel

Hizmete bağlanmak için kullanılacak kanal.

Devralma

Object

ClientBase<TChannel>

Türetilmiş

System.ServiceModel.Activities.WorkflowControlClient

System.ServiceModel.Activities.WorkflowUpdateableControlClient

System.ServiceModel.DuplexClientBase<TChannel>

Uygulamalar

IDisposable ICommunicationObject IAsyncDisposable

Örnekler

Aşağıdaki kod örneği , ServiceModel Metadata Utility Tool'un (Svcutil.exe) sınıfını wcf istemci sınıfı oluşturmak için nasıl genişletir ClientBase<TChannel> gösterir.

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);
    }
}

<System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")> _
Partial Public Class SampleServiceClient
    Inherits System.ServiceModel.ClientBase(Of ISampleService)
    Implements ISampleService

    Public Sub New()
    End Sub

    Public Sub New(ByVal endpointConfigurationName As String)
        MyBase.New(endpointConfigurationName)
    End Sub

    Public Sub New(ByVal endpointConfigurationName As String, ByVal remoteAddress As String)
        MyBase.New(endpointConfigurationName, remoteAddress)
    End Sub

    Public Sub New(ByVal endpointConfigurationName As String, _
                   ByVal remoteAddress As System.ServiceModel.EndpointAddress)
        MyBase.New(endpointConfigurationName, remoteAddress)
    End Sub

    Public Sub New(ByVal binding As System.ServiceModel.Channels.Binding, _
                   ByVal remoteAddress As System.ServiceModel.EndpointAddress)
        MyBase.New(binding, remoteAddress)
    End Sub

    Public Function SampleMethod(ByVal msg As String) As String Implements ISampleService.SampleMethod
        Return MyBase.Channel.SampleMethod(msg)
    End Function
End Class

Açıklamalar

Sınıfını ClientBase<TChannel> genişleterek bir hizmete bağlanmak için kullanılabilecek özel bir WCF istemci nesnesi oluşturun. Genellikle, WCF istemci temel sınıfı sizin adınıza ServiceModel Meta Veri Yardımcı Programı Aracı (Svcutil.exe) gibi bir araç tarafından genişletilir. Örnek için Örnek bölümüne bakın.

sınıfı, ClientBase<TChannel> nesneleri arabirimlerin ve sınıfın kullanımına tercih eden geliştiriciler tarafından hızlı ve System.ServiceModel.ChannelFactory<TChannel> kolay bir şekilde kullanılabilir. Her durumda bu sınıf, sınıfın ve arabiriminin System.ServiceModel.ChannelFactory<TChannel> yöntemlerini ve işlevselliğini sarmalar veya System.ServiceModel.IClientChannel kullanıma sunar.

sınıfını System.ServiceModel.ServiceHost kullanırken olduğu gibi, sınıfını oluşturabilir ve herhangi bir çağrı yapmadan veya çağırmadan Openönce uç nokta, kanal fabrikası veya güvenlik bilgilerini değiştirebilirsiniz. Daha fazla bilgi için bkz . WCF İstemcisi'ne Genel Bakış ve WCF İstemcisi Kullanarak Hizmetlere Erişme.

Bu sınıftan türetilen Yönetilen C++ kullanıcıları için özel not:

• Temizleme kodunuzu bir yıkıcıya değil (Açık)(Başlangıç)Close (ve/veya OnAbort) içine yerleştirin.

• Yıkıcılardan kaçının: derleyicinin otomatik olarak oluşturmasına IDisposableneden olurlar.

• Başvuru olmayan üyelerden kaçının: derleyicinin otomatik olarak oluşturmasına IDisposableneden olabilirler.

• Sonlandırıcılardan kaçının; ancak bir tane eklerseniz, otomatik olarak oluşturulan IDisposable davranışa öykünmek için derleme uyarısını ve çağrısını SuppressFinalize(Object) ve sonlandırıcının kendisini (Açık)(Başlangıç)Kapat (ve/veya OnAbort) öğesinden gizlemeniz gerekir.

Oluşturucular

ClientBase<TChannel>()	Uygulama yapılandırma dosyasından ClientBase<TChannel> varsayılan hedef uç noktayı kullanarak sınıfının yeni bir örneğini başlatır.
ClientBase<TChannel>(Binding, EndpointAddress)	Belirtilen bağlamayı ve hedef adresi kullanarak sınıfının yeni bir örneğini ClientBase<TChannel> başlatır.
ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)	ClientBase<TChannel> sınıfının yeni bir örneğini başlatır.
ClientBase<TChannel>(ServiceEndpoint)	Belirtilen ServiceEndpointkullanarak sınıfının yeni bir örneğini ClientBase<TChannel> başlatır.

Özellikler

CacheSetting	Önbellek ayarını alır veya ayarlar.
Channel	Çeşitli yapılandırılmış hizmet uç noktalarına ileti göndermek için kullanılan iç kanalı alır.
ChannelFactory	Temel alınan ChannelFactory<TChannel> nesneyi alır.
ClientCredentials	bir işlemi çağırmak için kullanılan istemci kimlik bilgilerini alır.
Endpoint	WCF istemcisinin bağlanabileceği hizmetin hedef uç noktasını alır.
InnerChannel	Temel IClientChannel alınan uygulamayı alır.
State	Nesnenin geçerli durumunu ClientBase<TChannel> alır.

Yöntemler

Abort()	Nesnenin ClientBase<TChannel> geçerli durumundan kapalı duruma hemen geçmesine neden olur.
Close()	Nesnenin ClientBase<TChannel> geçerli durumundan kapalı duruma geçmesine neden olur.
CloseAsync()	Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar.
CreateChannel()	Hizmete yeni bir kanal döndürür.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetDefaultValueForInitialization<T>()	C# dilinde varsayılan anahtar sözcüğün davranışını çoğaltır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InvokeAsync(ClientBase<TChannel>.BeginOperationDelegate, Object[], ClientBase<TChannel>.EndOperationDelegate, SendOrPostCallback, Object)	Olay tabanlı zaman uyumsuz deseni uygulamak için destek sağlar. Bu düzen hakkında daha fazla bilgi için bkz. Olay Tabanlı Zaman Uyumsuz Desene Genel Bakış.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Open()	Nesnenin ClientBase<TChannel> oluşturulan durumdan açık duruma geçmesine neden olur.
OpenAsync()	Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IAsyncDisposable.DisposeAsync()	Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar.
ICommunicationObject.BeginClose(AsyncCallback, Object)	kapatmak için ClientBase<TChannel>zaman uyumsuz bir işlem başlatır.
ICommunicationObject.BeginClose(TimeSpan, AsyncCallback, Object)	Belirtilen zaman aşımıyla kapatmak ClientBase<TChannel> için zaman uyumsuz bir işlem başlatır.
ICommunicationObject.BeginOpen(AsyncCallback, Object)	Nesneyi açmak ClientBase<TChannel> için zaman uyumsuz bir işlem başlatır.
ICommunicationObject.BeginOpen(TimeSpan, AsyncCallback, Object)	Nesneyi belirli bir zaman aralığı içinde açmak ClientBase<TChannel> için zaman uyumsuz bir işlem başlatır.
ICommunicationObject.Close(TimeSpan)	Nesnenin ClientBase<TChannel> geçerli durumundan kapalı duruma geçmesine neden olur.
ICommunicationObject.Closed	Nesne geçerli durumundan kapalı duruma geçtiğinde ClientBase<TChannel> çağrılan olay işleyicisi.
ICommunicationObject.Closing	Nesne geçerli durumundan kapalı duruma geçtiğinde ClientBase<TChannel> çağrılan olay işleyicisi.
ICommunicationObject.EndClose(IAsyncResult)	Nesneyi kapatmak ClientBase<TChannel> için zaman uyumsuz bir işlemi tamamlar.
ICommunicationObject.EndOpen(IAsyncResult)	Nesneyi açmak ClientBase<TChannel> için zaman uyumsuz bir işlemi tamamlar.
ICommunicationObject.Faulted	Nesne üzerinde bir işlem gerçekleştirirken bir hata oluştuğunda çağrılan olay işleyicisi ClientBase<TChannel> .
ICommunicationObject.Open(TimeSpan)	Nesnenin ClientBase<TChannel> oluşturulan durumdan belirli bir zaman aralığı içinde açık duruma geçmesine neden olur.
ICommunicationObject.Opened	Nesne oluşturulan durumdan açık duruma geçtiğinde ClientBase<TChannel> çağrılan olay işleyicisi.
ICommunicationObject.Opening	Nesne oluşturulan durumdan açık duruma geçtiğinde ClientBase<TChannel> çağrılan olay işleyicisi.
IDisposable.Dispose()	yönteminin Dispose() açık uygulaması.

Uzantı Metotları

CloseHelperAsync(ICommunicationObject, TimeSpan)	Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar.
OpenHelperAsync(ICommunicationObject, TimeSpan)	Hizmetleri çağırabilen Windows Communication Foundation (WCF) istemci nesneleri oluşturmak için kullanılan temel uygulamayı sağlar.
ConfigureAwait(IAsyncDisposable, Boolean)	Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirildiğini yapılandıran.