Partager via


ClientBase<TChannel> Constructeurs

Définition

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, String, String)

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

ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)

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

ClientBase<TChannel>(String, String)

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

ClientBase<TChannel>(String, EndpointAddress)

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide des informations d'adresse cible et de point de terminaison spécifiées.

ClientBase<TChannel>(InstanceContext, String)

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide des informations du service de rappel et de configuration du point de terminaison spécifiées.

ClientBase<TChannel>(InstanceContext, String, 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>(String)

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide des informations de configuration spécifiées dans le fichier de configuration de l'application par endpointConfigurationName.

ClientBase<TChannel>(InstanceContext)

Initialise une nouvelle instance de la classe ClientBase<TChannel> en utilisant callbackInstance en tant qu'objet de rappel dans une conversation duplex.

ClientBase<TChannel>(ServiceEndpoint)

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

ClientBase<TChannel>(InstanceContext, ServiceEndpoint)

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide des objets InstanceContext et ServiceEndpoint spécifiés.

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
Source:
ClientBase.cs
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

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.

S’applique à

ClientBase<TChannel>(InstanceContext, String, String)

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

protected:
 ClientBase(System::ServiceModel::InstanceContext ^ callbackInstance, System::String ^ endpointConfigurationName, System::String ^ remoteAddress);
protected ClientBase (System.ServiceModel.InstanceContext callbackInstance, string endpointConfigurationName, string remoteAddress);
new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.InstanceContext * string * string -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>
Protected Sub New (callbackInstance As InstanceContext, endpointConfigurationName As String, remoteAddress As String)

Paramètres

callbackInstance
InstanceContext

Objet de rappel utilisé par le client pour écouter les messages du service connecté.

endpointConfigurationName
String

Nom du point de terminaison dans le fichier de configuration de l'application.

remoteAddress
String

Adresse du service.

Exceptions

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

Le point de terminaison est introuvable ou le contrat de point de terminaison n'est pas valide.

Remarques

Utilisez ce constructeur pour passer un objet de service qui implémente le contrat de rappel pour le service cible et déterminer les informations de point de terminaison cible à partir du nom du point de terminaison dans un fichier de configuration d’application (la valeur cible se trouve en recherchant l’attribut name de l’élément de point de terminaison> client<) et l’adresse spécifiée.

Voir aussi

S’applique à

ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)

Source:
ClientBase.cs
Source:
ClientBase.cs
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

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

S’applique à

ClientBase<TChannel>(String, String)

Source:
ClientBase.cs
Source:
ClientBase.cs

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

protected:
 ClientBase(System::String ^ endpointConfigurationName, System::String ^ remoteAddress);
protected ClientBase (string endpointConfigurationName, string remoteAddress);
new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : string * string -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>
Protected Sub New (endpointConfigurationName As String, remoteAddress As String)

Paramètres

endpointConfigurationName
String

Nom du point de terminaison dans le fichier de configuration de l'application.

remoteAddress
String

Adresse du service.

Exceptions

endpointConfigurationName ou remoteAddress est null.

Le point de terminaison est introuvable ou le contrat de point de terminaison n'est pas valide.

Remarques

Utilisez ce constructeur pour déterminer les informations de point de terminaison cible à partir du nom du point de terminaison dans un fichier de configuration d’application (la valeur cible se trouve en recherchant l’attribut name de l’élément de point de terminaison> client<) et l’adresse spécifiée.

Voir aussi

S’applique à

ClientBase<TChannel>(String, EndpointAddress)

Source:
ClientBase.cs
Source:
ClientBase.cs

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide des informations d'adresse cible et de point de terminaison spécifiées.

protected:
 ClientBase(System::String ^ endpointConfigurationName, System::ServiceModel::EndpointAddress ^ remoteAddress);
protected ClientBase (string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress);
new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : string * System.ServiceModel.EndpointAddress -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>
Protected Sub New (endpointConfigurationName As String, remoteAddress As EndpointAddress)

Paramètres

endpointConfigurationName
String

Nom du point de terminaison dans le fichier de configuration de l'application.

remoteAddress
EndpointAddress

Adresse du service.

Exceptions

endpointConfigurationName ou remoteAddress est null.

Le point de terminaison est introuvable ou le contrat de point de terminaison n'est pas valide.

Remarques

Utilisez ce constructeur pour déterminer les informations de point de terminaison cible à partir du nom du point de terminaison dans un fichier de configuration d’application (la valeur cible se trouve en recherchant l’attribut name de l’élément de point de terminaison> client<) et l’adresse spécifiée.

S’applique à

ClientBase<TChannel>(InstanceContext, String)

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide des informations du service de rappel et de configuration du point de terminaison spécifiées.

protected:
 ClientBase(System::ServiceModel::InstanceContext ^ callbackInstance, System::String ^ endpointConfigurationName);
protected ClientBase (System.ServiceModel.InstanceContext callbackInstance, string endpointConfigurationName);
new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.InstanceContext * string -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>
Protected Sub New (callbackInstance As InstanceContext, endpointConfigurationName As String)

Paramètres

callbackInstance
InstanceContext

Objet de rappel utilisé par le client pour écouter les messages du service connecté.

endpointConfigurationName
String

Nom du point de terminaison dans le fichier de configuration de l'application.

Exceptions

L’instance de rappel ou endpointConfigurationName est null.

Le point de terminaison est introuvable ou le contrat de point de terminaison n'est pas valide.

Remarques

Utilisez ce constructeur pour passer un objet de service qui implémente le contrat de rappel pour le service cible et déterminer les informations sur le point de terminaison cible à partir du fichier de configuration de l'application cliente. La valeur cible se trouve en recherchant l’attribut name de l’élément de point de terminaison> client<.

S’applique à

ClientBase<TChannel>(InstanceContext, String, EndpointAddress)

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

protected:
 ClientBase(System::ServiceModel::InstanceContext ^ callbackInstance, System::String ^ endpointConfigurationName, System::ServiceModel::EndpointAddress ^ remoteAddress);
protected ClientBase (System.ServiceModel.InstanceContext callbackInstance, string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress);
new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.InstanceContext * string * System.ServiceModel.EndpointAddress -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>
Protected Sub New (callbackInstance As InstanceContext, endpointConfigurationName As String, remoteAddress As EndpointAddress)

Paramètres

callbackInstance
InstanceContext

Objet de rappel utilisé par le client pour écouter les messages du service connecté.

endpointConfigurationName
String

Nom du point de terminaison dans le fichier de configuration de l'application.

remoteAddress
EndpointAddress

Adresse du service.

Exceptions

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

Le point de terminaison est introuvable ou le contrat de point de terminaison n'est pas valide.

Remarques

Utilisez ce constructeur pour passer un objet de service qui implémente le contrat de rappel pour le service cible et déterminer les informations de point de terminaison cible à partir du nom du point de terminaison dans un fichier de configuration d’application (la valeur cible se trouve en recherchant l’attribut name de l’élément de point de terminaison> client<) et l’adresse spécifiée.

Voir aussi

S’applique à

ClientBase<TChannel>(Binding, EndpointAddress)

Source:
ClientBase.cs
Source:
ClientBase.cs
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

binding ou remoteAddress est null.

S’applique à

ClientBase<TChannel>(String)

Source:
ClientBase.cs
Source:
ClientBase.cs

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide des informations de configuration spécifiées dans le fichier de configuration de l'application par endpointConfigurationName.

protected:
 ClientBase(System::String ^ endpointConfigurationName);
protected ClientBase (string endpointConfigurationName);
new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : string -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>
Protected Sub New (endpointConfigurationName As String)

Paramètres

endpointConfigurationName
String

Nom du point de terminaison dans le fichier de configuration de l'application.

Exceptions

Les informations du point de terminaison spécifié ont la valeur null.

Le point de terminaison est introuvable ou le contrat de point de terminaison n'est pas valide.

Remarques

Utilisez ce constructeur lorsque le fichier de configuration de l'application contient plusieurs points de terminaison cibles. Cette valeur est l’attribut name de l’élément de point de terminaison> client<.

S’applique à

ClientBase<TChannel>(InstanceContext)

Initialise une nouvelle instance de la classe ClientBase<TChannel> en utilisant callbackInstance en tant qu'objet de rappel dans une conversation duplex.

protected:
 ClientBase(System::ServiceModel::InstanceContext ^ callbackInstance);
protected ClientBase (System.ServiceModel.InstanceContext callbackInstance);
new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.InstanceContext -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>
Protected Sub New (callbackInstance As InstanceContext)

Paramètres

callbackInstance
InstanceContext

Objet de rappel utilisé par l'application cliente pour écouter les messages du service connecté.

Exceptions

L'instance de rappel a la valeur null.

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 comment utiliser ce constructeur avec une classe SampleDuplexHelloClient pour passer un objet de rappel qui écoute les messages du service.

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

namespace Microsoft.WCF.Documentation
{
  [CallbackBehaviorAttribute(
   IncludeExceptionDetailInFaults= true,
    UseSynchronizationContext=true,
    ValidateMustUnderstand=true
  )]
  public class Client : SampleDuplexHelloCallback
  {
    AutoResetEvent waitHandle;

    public Client()
    {
      waitHandle = new AutoResetEvent(false);
    }

    public void Run()
    {
      // Picks up configuration from the configuration file.
      SampleDuplexHelloClient wcfClient
        = new SampleDuplexHelloClient(new InstanceContext(this), "WSDualHttpBinding_SampleDuplexHello");
      try
      {
        Console.ForegroundColor = ConsoleColor.White;
        Console.WriteLine("Enter a greeting to send and press ENTER: ");
        Console.Write(">>> ");
        Console.ForegroundColor = ConsoleColor.Green;
        string greeting = Console.ReadLine();
        Console.ForegroundColor = ConsoleColor.White;
        Console.WriteLine("Called service with: \r\n\t" + greeting);
        wcfClient.Hello(greeting);
        Console.WriteLine("Execution passes service call and moves to the WaitHandle.");
        this.waitHandle.WaitOne();
        Console.ForegroundColor = ConsoleColor.Blue;
        Console.WriteLine("Set was called.");
        Console.Write("Press ");
        Console.ForegroundColor = ConsoleColor.Red;
        Console.Write("ENTER");
        Console.ForegroundColor = ConsoleColor.Blue;
        Console.Write(" to exit...");
        Console.ReadLine();
      }
      catch (TimeoutException timeProblem)
      {
        Console.WriteLine("The service operation timed out. " + timeProblem.Message);
        Console.ReadLine();
      }
      catch (CommunicationException commProblem)
      {
        Console.WriteLine("There was a communication problem. " + commProblem.Message);
        Console.ReadLine();
      }
    }
    public static void Main()
    {
      Client client = new Client();
      client.Run();
    }

    public void Reply(string response)
    {
      Console.WriteLine("Received output.");
      Console.WriteLine("\r\n\t" + response);
      this.waitHandle.Set();
    }
  }
}

Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports System.Threading

Namespace Microsoft.WCF.Documentation
  <CallbackBehaviorAttribute(IncludeExceptionDetailInFaults:= True, UseSynchronizationContext:=True, ValidateMustUnderstand:=True)> _
  Public Class Client
      Implements SampleDuplexHelloCallback
    Private waitHandle As AutoResetEvent

    Public Sub New()
      waitHandle = New AutoResetEvent(False)
    End Sub

    Public Sub Run()
      ' Picks up configuration from the configuration file.
      Dim wcfClient As New SampleDuplexHelloClient(New InstanceContext(Me), "WSDualHttpBinding_SampleDuplexHello")
      Try
        Console.ForegroundColor = ConsoleColor.White
        Console.WriteLine("Enter a greeting to send and press ENTER: ")
        Console.Write(">>> ")
        Console.ForegroundColor = ConsoleColor.Green
        Dim greeting As String = Console.ReadLine()
        Console.ForegroundColor = ConsoleColor.White
        Console.WriteLine("Called service with: " & Constants.vbCrLf & Constants.vbTab & greeting)
        wcfClient.Hello(greeting)
        Console.WriteLine("Execution passes service call and moves to the WaitHandle.")
        Me.waitHandle.WaitOne()
        Console.ForegroundColor = ConsoleColor.Blue
        Console.WriteLine("Set was called.")
        Console.Write("Press ")
        Console.ForegroundColor = ConsoleColor.Red
        Console.Write("ENTER")
        Console.ForegroundColor = ConsoleColor.Blue
        Console.Write(" to exit...")
        Console.ReadLine()
      Catch timeProblem As TimeoutException
        Console.WriteLine("The service operation timed out. " & timeProblem.Message)
        Console.ReadLine()
      Catch commProblem As CommunicationException
        Console.WriteLine("There was a communication problem. " & commProblem.Message)
        Console.ReadLine()
      End Try
    End Sub
    Public Shared Sub Main()
      Dim client As New Client()
      client.Run()
    End Sub

    Public Sub Reply(ByVal response As String) Implements SampleDuplexHelloCallback.Reply
      Console.WriteLine("Received output.")
      Console.WriteLine(Constants.vbCrLf & Constants.vbTab & response)
      Me.waitHandle.Set()
    End Sub
  End Class
End Namespace

Remarques

Utilisez ce constructeur lorsque le contrat de service requiert une instance de service de rappel. Le point de terminaison cible est construit à partir du paramètre de type et des informations contenues dans le fichier de configuration de l'application.

Voir aussi

S’applique à

ClientBase<TChannel>(ServiceEndpoint)

Source:
ClientBase.cs
Source:
ClientBase.cs
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.

S’applique à

ClientBase<TChannel>(InstanceContext, ServiceEndpoint)

Initialise une nouvelle instance de la classe ClientBase<TChannel> à l'aide des objets InstanceContext et ServiceEndpoint spécifiés.

protected:
 ClientBase(System::ServiceModel::InstanceContext ^ callbackInstance, System::ServiceModel::Description::ServiceEndpoint ^ endpoint);
protected ClientBase (System.ServiceModel.InstanceContext callbackInstance, System.ServiceModel.Description.ServiceEndpoint endpoint);
new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.InstanceContext * System.ServiceModel.Description.ServiceEndpoint -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>
Protected Sub New (callbackInstance As InstanceContext, endpoint As ServiceEndpoint)

Paramètres

callbackInstance
InstanceContext

Objet de rappel utilisé par l'application cliente pour écouter les messages du service connecté.

endpoint
ServiceEndpoint

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

S’applique à