Comparteix a través de


ClientBase<TChannel> Constructores

Definición

Inicializa una nueva instancia de la clase ClientBase<TChannel>.

Sobrecargas

ClientBase<TChannel>()

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando el extremo de destino predeterminado del archivo de configuración de aplicación.

ClientBase<TChannel>(InstanceContext, String, String)

Inicializa una nueva instancia de la clase ClientBase<TChannel>.

ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)

Inicializa una nueva instancia de la clase ClientBase<TChannel>.

ClientBase<TChannel>(String, String)

Inicializa una nueva instancia de la clase ClientBase<TChannel>.

ClientBase<TChannel>(String, EndpointAddress)

Inicializa una nueva instancia de la clase ClientBase<TChannel> con la dirección de destino e información de extremo especificadas.

ClientBase<TChannel>(InstanceContext, String)

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando el servicio de devolución de llamada especificado y la información de configuración del extremo.

ClientBase<TChannel>(InstanceContext, String, EndpointAddress)

Inicializa una nueva instancia de la clase ClientBase<TChannel>.

ClientBase<TChannel>(Binding, EndpointAddress)

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando la dirección de enlace y de destino especificada.

ClientBase<TChannel>(String)

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando la información de configuración especificada por endpointConfigurationName en el archivo de configuración de aplicación.

ClientBase<TChannel>(InstanceContext)

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando callbackInstance como objeto de devolución de llamada en una conversación dúplex.

ClientBase<TChannel>(ServiceEndpoint)

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando la clase ServiceEndpoint especificada.

ClientBase<TChannel>(InstanceContext, ServiceEndpoint)

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando los objetos InstanceContext y ServiceEndpoint especificados.

Comentarios

Use para crear un objeto de cliente WCF a partir de la información del punto de conexión en el archivo de configuración de la aplicación. La función principal del constructor es crear System.ServiceModel.ChannelFactory<TChannel> donde el parámetro de tipo es el tipo del contrato de servicios de destino.

ClientBase<TChannel>()

Source:
ClientBase.cs
Source:
ClientBase.cs
Source:
ClientBase.cs

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando el extremo de destino predeterminado del archivo de configuración de aplicación.

protected:
 ClientBase();
protected ClientBase ();
Protected Sub New ()

Excepciones

No hay información de punto de conexión predeterminada en el archivo de configuración o hay más de un punto de conexión en el archivo o no hay ningún archivo de configuración.

Ejemplos

En el ejemplo de código siguiente se muestra cómo un cliente utiliza este constructor en una clase SampleServiceClient que extiende la clase 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

Comentarios

Use este constructor para crear un objeto de cliente WCF para invocar un servicio. Este constructor utiliza el parámetro de tipo como contrato de destino y enlace e información de dirección del archivo de configuración de la aplicación.

Se aplica a

ClientBase<TChannel>(InstanceContext, String, String)

Inicializa una nueva instancia de la clase 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)

Parámetros

callbackInstance
InstanceContext

El objeto de devolución de llamadas que el cliente utiliza para realizar escuchas de los mensajes procedentes del servicio conectado.

endpointConfigurationName
String

Nombre del punto de conexión en el archivo de configuración de la aplicación.

remoteAddress
String

Dirección del servicio.

Excepciones

La instancia de devolución de llamada es endpointConfigurationName, remoteAddress o null.

No se puede encontrar el punto de conexión o el contrato del punto de conexión no es válido.

Comentarios

Use este constructor para pasar un objeto de servicio que implemente el contrato de devolución de llamada para el servicio de destino y determinar la información del punto de conexión de destino del nombre del punto de conexión en un archivo de configuración de la aplicación (el valor de destino se encuentra buscando el name atributo del elemento de punto de conexión> de cliente<) y la dirección especificada.

Consulte también

Se aplica a

ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)

Source:
ClientBase.cs
Source:
ClientBase.cs
Source:
ClientBase.cs

Inicializa una nueva instancia de la clase 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)

Parámetros

callbackInstance
InstanceContext

El servicio de devolución de llamada.

binding
Binding

El enlace con el que llamar al servicio.

remoteAddress
EndpointAddress

La dirección del punto de conexión de servicio.

Excepciones

La instancia de devolución de llamada es binding, remoteAddress o null.

Se aplica a

ClientBase<TChannel>(String, String)

Source:
ClientBase.cs
Source:
ClientBase.cs

Inicializa una nueva instancia de la clase 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)

Parámetros

endpointConfigurationName
String

Nombre del punto de conexión en el archivo de configuración de la aplicación.

remoteAddress
String

Dirección del servicio.

Excepciones

endpointConfigurationName o remoteAddress es null.

No se puede encontrar el punto de conexión o el contrato del punto de conexión no es válido.

Comentarios

Use este constructor para determinar la información del punto de conexión de destino del nombre del punto de conexión en un archivo de configuración de la aplicación (el valor de destino se encuentra buscando el name atributo del elemento de punto de conexión> de cliente<) y la dirección especificada.

Consulte también

Se aplica a

ClientBase<TChannel>(String, EndpointAddress)

Source:
ClientBase.cs
Source:
ClientBase.cs

Inicializa una nueva instancia de la clase ClientBase<TChannel> con la dirección de destino e información de extremo especificadas.

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)

Parámetros

endpointConfigurationName
String

Nombre del punto de conexión en el archivo de configuración de la aplicación.

remoteAddress
EndpointAddress

Dirección del servicio.

Excepciones

endpointConfigurationName o remoteAddress es null.

No se puede encontrar el punto de conexión o el contrato del punto de conexión no es válido.

Comentarios

Use este constructor para determinar la información del punto de conexión de destino del nombre del punto de conexión en un archivo de configuración de la aplicación (el valor de destino se encuentra buscando el name atributo del elemento de punto de conexión> de cliente<) y la dirección especificada.

Se aplica a

ClientBase<TChannel>(InstanceContext, String)

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando el servicio de devolución de llamada especificado y la información de configuración del extremo.

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)

Parámetros

callbackInstance
InstanceContext

El objeto de devolución de llamadas que el cliente utiliza para realizar escuchas de los mensajes procedentes del servicio conectado.

endpointConfigurationName
String

Nombre del punto de conexión en el archivo de configuración de la aplicación.

Excepciones

La instancia de devolución de llamada es endpointConfigurationName o null.

No se puede encontrar el punto de conexión o el contrato del punto de conexión no es válido.

Comentarios

Utilice este constructor para pasar un objeto de servicio que implementa el contrato de devolución de llamada para el servicio de destino y determinar la información del extremo de destino procedente del archivo de configuración de la aplicación cliente. El valor de destino se encuentra buscando el name atributo del elemento de punto de conexión> de cliente<.

Se aplica a

ClientBase<TChannel>(InstanceContext, String, EndpointAddress)

Inicializa una nueva instancia de la clase 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)

Parámetros

callbackInstance
InstanceContext

El objeto de devolución de llamadas que el cliente utiliza para realizar escuchas de los mensajes procedentes del servicio conectado.

endpointConfigurationName
String

Nombre del punto de conexión en el archivo de configuración de la aplicación.

remoteAddress
EndpointAddress

Dirección del servicio.

Excepciones

La instancia de devolución de llamada es endpointConfigurationName, remoteAddress o null.

No se puede encontrar el punto de conexión o el contrato del punto de conexión no es válido.

Comentarios

Use este constructor para pasar un objeto de servicio que implemente el contrato de devolución de llamada para el servicio de destino y determinar la información del punto de conexión de destino del nombre del punto de conexión en un archivo de configuración de la aplicación (el valor de destino se encuentra buscando el name atributo del elemento de punto de conexión> de cliente<) y la dirección especificada.

Consulte también

Se aplica a

ClientBase<TChannel>(Binding, EndpointAddress)

Source:
ClientBase.cs
Source:
ClientBase.cs
Source:
ClientBase.cs

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando la dirección de enlace y de destino especificada.

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)

Parámetros

binding
Binding

El enlace con el que realizar llamadas al servicio.

remoteAddress
EndpointAddress

La dirección del punto de conexión de servicio.

Excepciones

binding o remoteAddress es null.

Se aplica a

ClientBase<TChannel>(String)

Source:
ClientBase.cs
Source:
ClientBase.cs

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando la información de configuración especificada por endpointConfigurationName en el archivo de configuración de aplicación.

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)

Parámetros

endpointConfigurationName
String

Nombre del punto de conexión en el archivo de configuración de la aplicación.

Excepciones

La información de punto de conexión especificada es null.

No se puede encontrar el punto de conexión o el contrato del punto de conexión no es válido.

Comentarios

Utilice este constructor cuando haya más de un punto de conexión de destino en el archivo de configuración de la aplicación. Este valor es el name atributo del elemento de punto de conexión> de cliente<.

Se aplica a

ClientBase<TChannel>(InstanceContext)

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando callbackInstance como objeto de devolución de llamada en una conversación dúplex.

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)

Parámetros

callbackInstance
InstanceContext

El objeto de devolución de llamada que la aplicación de cliente utiliza para realizar escuchas de mensajes procedentes del servicio conectado.

Excepciones

La instancia de devolución de llamada es null.

No hay información de punto de conexión predeterminada en el archivo de configuración o hay más de un punto de conexión en el archivo o no hay ningún archivo de configuración.

Ejemplos

El ejemplo de código siguiente muestra cómo utilizar este constructor con una clase SampleDuplexHelloClient para pasar un objeto de devolución de llamada que realiza escuchas de los mensajes procedentes del servicio.

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

Comentarios

Utilice este constructor cuando el contrato de servicios requiera una instancia de servicio de devolución de llamada. El extremo de destino se construye a partir del parámetro de tipo y de la información del archivo de configuración de la aplicación.

Consulte también

Se aplica a

ClientBase<TChannel>(ServiceEndpoint)

Source:
ClientBase.cs
Source:
ClientBase.cs
Source:
ClientBase.cs

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando la clase ServiceEndpoint especificada.

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)

Parámetros

endpoint
ServiceEndpoint

El punto de conexión de un servicio que permite a los clientes buscar y comunicarse con el servicio.

Se aplica a

ClientBase<TChannel>(InstanceContext, ServiceEndpoint)

Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando los objetos InstanceContext y ServiceEndpoint especificados.

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)

Parámetros

callbackInstance
InstanceContext

El objeto de devolución de llamada que la aplicación de cliente utiliza para realizar escuchas de mensajes procedentes del servicio conectado.

endpoint
ServiceEndpoint

El punto de conexión de un servicio que permite a los clientes buscar y comunicarse con el servicio.

Se aplica a