ClientBase<TChannel> Klass

Definition

generic <typename TChannel>
 where TChannel : classpublic ref class ClientBase abstract : 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> : IDisposable, System.ServiceModel.ICommunicationObject where TChannel : class

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

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

Public MustInherit Class ClientBase(Of TChannel)
Implements ICommunicationObject

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

Typparametrar

Arv

Object

ClientBase<TChannel>

Härledda

System.ServiceModel.Activities.WorkflowControlClient

System.ServiceModel.Activities.WorkflowUpdateableControlClient

System.ServiceModel.DuplexClientBase<TChannel>

Implementeringar

ICommunicationObject IDisposable

Exempel

Följande kodexempel visar hur Verktyget för ServiceModel-metadata (Svcutil.exe) utökar ClientBase<TChannel> klassen för att skapa en WCF-klientklass.

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

Kommentarer

ClientBase<TChannel> Utöka klassen för att skapa ett anpassat WCF-klientobjekt som kan användas för att ansluta till en tjänst. Vanligtvis utökas WCF-klientbasklassen av ett verktyg som ServiceModel Metadata Utility Tool (Svcutil.exe) för din räkning. Ett exempel finns i avsnittet Exempel.

Klassen ClientBase<TChannel> kan användas snabbt och enkelt av utvecklare som föredrar objekt framför användningen av gränssnitten System.ServiceModel.ChannelFactory<TChannel> och klassen. I samtliga fall omsluter eller exponerar den här klassen metoderna och funktionerna i System.ServiceModel.ChannelFactory<TChannel> klassen och System.ServiceModel.IClientChannel gränssnittet.

Precis som när du använder System.ServiceModel.ServiceHost klassen kan du skapa klassen och ändra slutpunkten, kanalfabriken eller säkerhetsinformationen innan du gör några anrop eller anropar Open. Mer information finns i Översikt över WCF-klient och åtkomst till tjänster med hjälp av en WCF-klient.

Särskild anmärkning för hanterade C++-användare som härleds från den här klassen:

• Placera din rensningskod i (På)(Begin)Close (och/eller OnAbort), inte i en destruktor.
• Undvik destructors: de gör att kompilatorn automatiskt genererar IDisposable.
• Undvik icke-referensmedlemmar: de kan göra så att kompilatorn automatiskt genererar IDisposable.
• Undvik finalizers; men om du inkluderar en bör du ignorera byggvarningen och anropet SuppressFinalize(Object) och själva slutföraren från (På)(Begin)Close (och/eller OnAbort) för att emulera vad som skulle ha varit det automatiskt genererade beteendet IDisposable .