ClientBase<TChannel> Constructeurs

Définition

Espace de noms:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v8.0.0

Initialise une nouvelle instance de la classe ClientBase<TChannel>.

Surcharges

ClientBase<TChannel>()	Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide du point de terminaison cible par défaut du fichier de configuration de l'application.
ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)	Initialise une nouvelle instance de la classe ClientBase<TChannel>.
ClientBase<TChannel>(Binding, EndpointAddress)	Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide de la liaison et de l'adresse cible spécifiées.
ClientBase<TChannel>(ServiceEndpoint)	Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide du ServiceEndpoint spécifié.

Remarques

Utilisez pour créer un objet client WCF à partir des informations de point de terminaison dans le fichier de configuration de l’application. Ce constructeur a pour fonction principale de créer un System.ServiceModel.ChannelFactory<TChannel> où le paramètre de type est le type du contrat de service cible.

ClientBase<TChannel>()

Source:

ClientBase.cs

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide du point de terminaison cible par défaut du fichier de configuration de l'application.

protected:
 ClientBase();

protected ClientBase ();

Protected Sub New ()

Exceptions

InvalidOperationException

Trois cas sont possibles : le fichier de configuration ne contient pas d'informations sur le point de terminaison par défaut, le fichier contient plusieurs points de terminaison ou il n'existe pas de fichier de configuration.

Exemples

L'exemple de code suivant montre de quelle manière un client utilise ce constructeur dans une classe SampleServiceClient qui étend la classe ClientBase<TChannel>.

using System;
using System.ServiceModel;
using System.ServiceModel.Channels;

public class Client
{
  public static void Main()
  {
    // Picks up configuration from the config file.
    SampleServiceClient wcfClient = new SampleServiceClient();
    try
    {
        // Making calls.
        Console.WriteLine("Enter the greeting to send: ");
        string greeting = Console.ReadLine();
        Console.WriteLine("The service responded: " + wcfClient.SampleMethod(greeting));

        Console.WriteLine("Press ENTER to exit:");
        Console.ReadLine();

        // Done with service.
        wcfClient.Close();
        Console.WriteLine("Done!");
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine("The service operation timed out. " + timeProblem.Message);
      wcfClient.Abort();
      Console.Read();
    }
    catch(CommunicationException commProblem)
    {
      Console.WriteLine("There was a communication problem. " + commProblem.Message);
      wcfClient.Abort();
      Console.Read();
    }
  }
}

Imports System.ServiceModel
Imports System.ServiceModel.Channels

Public Class Client
  Public Shared Sub Main()
    ' Picks up configuration from the config file.
    Dim wcfClient As New SampleServiceClient()
    Try
        ' Making calls.
        Console.WriteLine("Enter the greeting to send: ")
            Dim greeting = Console.ReadLine()
        Console.WriteLine("The service responded: " & wcfClient.SampleMethod(greeting))

        Console.WriteLine("Press ENTER to exit:")
        Console.ReadLine()

        ' Done with service. 
        wcfClient.Close()
        Console.WriteLine("Done!")
    Catch timeProblem As TimeoutException
      Console.WriteLine("The service operation timed out. " & timeProblem.Message)
      wcfClient.Abort()
      Console.Read()
    Catch commProblem As CommunicationException
      Console.WriteLine("There was a communication problem. " & commProblem.Message)
      wcfClient.Abort()
      Console.Read()
    End Try
  End Sub
End Class

Remarques

Utilisez ce constructeur pour créer un objet client WCF afin d’appeler un service. Ce constructeur utilise le paramètre de type en guise de contrat cible et les informations de liaison et d’adresse du fichier de configuration de l’application.

ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)

Source:

ClientBase.cs

Initialise une nouvelle instance de la classe ClientBase<TChannel>.

protected:
 ClientBase(System::ServiceModel::InstanceContext ^ callbackInstance, System::ServiceModel::Channels::Binding ^ binding, System::ServiceModel::EndpointAddress ^ remoteAddress);

protected ClientBase (System.ServiceModel.InstanceContext callbackInstance, System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress);

new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.InstanceContext * System.ServiceModel.Channels.Binding * System.ServiceModel.EndpointAddress -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>

Protected Sub New (callbackInstance As InstanceContext, binding As Binding, remoteAddress As EndpointAddress)

Paramètres

callbackInstance

InstanceContext

Service de rappel.

binding

Binding

Liaison avec laquelle appeler le service.

remoteAddress

EndpointAddress

Adresse du point de terminaison de service.

Exceptions

ArgumentNullException

L’instance de rappel, binding, ou remoteAddress est null.

ClientBase<TChannel>(Binding, EndpointAddress)

Source:

ClientBase.cs

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide de la liaison et de l'adresse cible spécifiées.

protected:
 ClientBase(System::ServiceModel::Channels::Binding ^ binding, System::ServiceModel::EndpointAddress ^ remoteAddress);

protected ClientBase (System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress);

new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.Channels.Binding * System.ServiceModel.EndpointAddress -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>

Protected Sub New (binding As Binding, remoteAddress As EndpointAddress)

Paramètres

binding

Binding

Liaison avec laquelle lancer des appels au service.

remoteAddress

EndpointAddress

Adresse du point de terminaison de service.

Exceptions

ArgumentNullException

binding ou remoteAddress est null.

ClientBase<TChannel>(ServiceEndpoint)

Source:

ClientBase.cs

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide du ServiceEndpoint spécifié.

protected:
 ClientBase(System::ServiceModel::Description::ServiceEndpoint ^ endpoint);

protected ClientBase (System.ServiceModel.Description.ServiceEndpoint endpoint);

new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.Description.ServiceEndpoint -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>

Protected Sub New (endpoint As ServiceEndpoint)

Paramètres

endpoint

ServiceEndpoint

Point de terminaison pour un service qui permet aux clients de rechercher et de communiquer avec celui-ci.