ClientBase<TChannel> Klas

Definitie

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

Type parameters

Overname

Object

ClientBase<TChannel>

Afgeleid

System.ServiceModel.Activities.WorkflowControlClient

System.ServiceModel.Activities.WorkflowUpdateableControlClient

System.ServiceModel.DuplexClientBase<TChannel>

Implementeringen

ICommunicationObject IDisposable

Voorbeelden

In het volgende codevoorbeeld ziet u hoe het Hulpprogramma voor metagegevens van ServiceModel (Svcutil.exe) de ClientBase<TChannel> klasse uitbreidt om een WCF-clientklasse te maken.

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

Opmerkingen

Breid de ClientBase<TChannel> klasse uit om een aangepast WCF-clientobject te maken dat kan worden gebruikt om verbinding te maken met een service. Normaal gesproken wordt de WCF-clientbasisklasse uitgebreid met een hulpprogramma zoals het hulpprogramma ServiceModel Metadata Utility (Svcutil.exe) namens u. Zie de sectie Voorbeeld voor een voorbeeld.

De ClientBase<TChannel> klasse kan snel en eenvoudig worden gebruikt door ontwikkelaars die de voorkeur geven aan objecten voor het gebruik van de interfaces en de System.ServiceModel.ChannelFactory<TChannel> klasse. In alle gevallen worden de methoden en functionaliteit van de System.ServiceModel.ChannelFactory<TChannel> klasse en de System.ServiceModel.IClientChannel interface verpakt of weergegeven.

Net als bij het gebruik van de System.ServiceModel.ServiceHost klasse kunt u de klasse maken en het eindpunt, de kanaalfactory of de beveiligingsgegevens wijzigen voordat u aanroepen of aanroepen doet Open. Zie wcf-clientoverzicht en toegang tot services met behulp van een WCF-client voor meer informatie.

Speciale opmerking voor beheerde C++-gebruikers die zijn afgeleid van deze klasse:

• Plaats de opschooncode in (On)(Begin)Close (en/of OnAbort), niet in een destructor.
• Vermijd destructors: ze zorgen ervoor dat de compiler automatisch wordt gegenereerd IDisposable.
• Vermijd niet-referentieleden: ze kunnen ertoe leiden dat de compiler automatisch wordt gegenereerd IDisposable.
• Vermijd finalizers; maar als u er een opneemt, moet u de buildwaarschuwing en -aanroep SuppressFinalize(Object) onderdrukken en de finalizer zelf van (On)(Begin)Close (en/of OnAbort) om te emuleren wat het automatisch gegenereerde IDisposable gedrag zou zijn geweest.