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 客户端访问服务。

对于派生自此类的托管 C++ 用户的特殊说明：

• 将清理代码置于 （On）（Begin）Close（and/或 OnAbort），而不是析构函数中。
• 避免析构函数：它们会导致编译器自动生成 IDisposable。
• 避免非引用成员：它们可能导致编译器自动生成 IDisposable。
• 避免终结器;但是，如果包含一个，则应禁止生成警告和调用 SuppressFinalize(Object) 以及终结器本身从 （On）（Begin）Close （和/或 OnAbort） 模拟自动生成 IDisposable 的行为。