ClientBase<TChannel> Класс

Определение

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

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

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

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

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

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

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

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

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

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

Public MustInherit Class ClientBase(Of TChannel)
Implements ICommunicationObject

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

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

Параметры типа

Наследование

Object

ClientBase<TChannel>

Производный

System.ServiceModel.Activities.WorkflowControlClient

System.ServiceModel.Activities.WorkflowUpdateableControlClient

System.ServiceModel.DuplexClientBase<TChannel>

Реализации

ICommunicationObject IAsyncDisposable IDisposable

Примеры

В следующем примере кода показано, как средство служебной программы метаданных ServiceModel (Svcutil.exe) расширяет ClientBase<TChannel> класс для создания клиентского класса WCF.

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

Комментарии

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/or OnAbort), а не в деструктор.
• Избегайте деструкторов: они вызывают автоматическое создание IDisposableкомпилятором.
• Избегайте элементов без ссылок: они могут привести к автоматическому созданию IDisposableкомпилятора.
• Избегайте завершения; но если включить его, следует отключить предупреждение и вызов SuppressFinalize(Object) сборки и вызвать и завершить работу из (On)(Begin)Close (and/or OnAbort), чтобы эмулировать то, что было бы автоматически создано IDisposable .