Partilhar via


ClientBase<TChannel> Construtores

Definição

Inicializa uma nova instância da classe ClientBase<TChannel>.

Sobrecargas

ClientBase<TChannel>()

Inicializa uma nova instância da classe ClientBase<TChannel> usando o ponto de extremidade de destino padrão do arquivo de configuração de aplicativo.

ClientBase<TChannel>(InstanceContext, String, String)

Inicializa uma nova instância da classe ClientBase<TChannel>.

ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)

Inicializa uma nova instância da classe ClientBase<TChannel>.

ClientBase<TChannel>(String, String)

Inicializa uma nova instância da classe ClientBase<TChannel>.

ClientBase<TChannel>(String, EndpointAddress)

Inicializa uma nova instância da classe ClientBase<TChannel> usando as informações de endereço de destino e de ponto de extremidade especificadas.

ClientBase<TChannel>(InstanceContext, String)

Inicializa uma nova instância da classe ClientBase<TChannel> usando as informações de configuração de ponto de extremidade e de serviço de retorno de chamada especificadas.

ClientBase<TChannel>(InstanceContext, String, EndpointAddress)

Inicializa uma nova instância da classe ClientBase<TChannel>.

ClientBase<TChannel>(Binding, EndpointAddress)

Inicializa uma nova instância da classe ClientBase<TChannel> usando o endereço de associação e de destino especificado.

ClientBase<TChannel>(String)

Inicializa uma nova instância da classe ClientBase<TChannel> usando as informações de configuração especificadas no arquivo de configuração de aplicativo pelo endpointConfigurationName.

ClientBase<TChannel>(InstanceContext)

Inicializa uma nova instância do ClientBase<TChannel> classe usando o callbackInstance como o objeto de retorno de chamada em uma conversa duplex.

ClientBase<TChannel>(ServiceEndpoint)

Inicializa uma nova instância da classe ClientBase<TChannel> usando o ServiceEndpoint especificado.

ClientBase<TChannel>(InstanceContext, ServiceEndpoint)

Inicializa uma nova instância da classe ClientBase<TChannel> usando os objetos InstanceContext e ServiceEndpoint especificados.

Comentários

Use para criar um objeto cliente WCF com base nas informações do ponto de extremidade no arquivo de configuração do aplicativo. A função main do construtor é criar um em que System.ServiceModel.ChannelFactory<TChannel> o parâmetro de tipo é o tipo do contrato de serviço de destino.

ClientBase<TChannel>()

Origem:
ClientBase.cs
Origem:
ClientBase.cs
Origem:
ClientBase.cs

Inicializa uma nova instância da classe ClientBase<TChannel> usando o ponto de extremidade de destino padrão do arquivo de configuração de aplicativo.

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

Exceções

Ou não há nenhuma informação de ponto de extremidade padrão no arquivo de configuração ou há mais de um ponto de extremidade no arquivo de configuração, ou ainda, não há nenhum arquivo de configuração.

Exemplos

O exemplo de código a seguir mostra como um cliente usa esse construtor em uma SampleServiceClient classe que estende a ClientBase<TChannel> classe .

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

Comentários

Use esse construtor para criar um objeto cliente WCF para invocar um serviço. Esse construtor usa o parâmetro de tipo como o contrato de destino e as informações de associação e endereço do arquivo de configuração do aplicativo.

Aplica-se a

ClientBase<TChannel>(InstanceContext, String, String)

Inicializa uma nova instância da 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)

Parâmetros

callbackInstance
InstanceContext

O objeto de retorno de chamada que o cliente usa para escutar mensagens do serviço conectado.

endpointConfigurationName
String

O nome do ponto de extremidade no arquivo de configuração de aplicativo.

remoteAddress
String

O endereço do serviço.

Exceções

A instância de retorno de chamada, endpointConfigurationName ou remoteAddress é null.

Não foi possível encontrar o ponto de extremidade ou o contrato do ponto de extremidade é inválido.

Comentários

Use esse construtor para passar um objeto de serviço que implementa o contrato de retorno de chamada para o serviço de destino e determinar as informações de ponto de extremidade de destino do nome do ponto de extremidade em um arquivo de configuração de aplicativo (o valor de destino está localizado localizando o name atributo do elemento de ponto de extremidade> do cliente<) e o endereço especificado.

Confira também

Aplica-se a

ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)

Origem:
ClientBase.cs
Origem:
ClientBase.cs
Origem:
ClientBase.cs

Inicializa uma nova instância da 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)

Parâmetros

callbackInstance
InstanceContext

O serviço de retorno de chamada.

binding
Binding

A associação com a qual chamar o serviço.

remoteAddress
EndpointAddress

O endereço do ponto de extremidade de serviço.

Exceções

A instância de retorno de chamada, binding ou remoteAddress é null.

Aplica-se a

ClientBase<TChannel>(String, String)

Origem:
ClientBase.cs
Origem:
ClientBase.cs

Inicializa uma nova instância da 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)

Parâmetros

endpointConfigurationName
String

O nome do ponto de extremidade no arquivo de configuração de aplicativo.

remoteAddress
String

O endereço do serviço.

Exceções

endpointConfigurationName ou remoteAddress é null.

Não foi possível encontrar o ponto de extremidade ou o contrato do ponto de extremidade é inválido.

Comentários

Use esse construtor para determinar as informações de ponto de extremidade de destino do nome do ponto de extremidade em um arquivo de configuração de aplicativo (o valor de destino está localizado localizando o name atributo do elemento de ponto> de extremidade do cliente<) e o endereço especificado.

Confira também

Aplica-se a

ClientBase<TChannel>(String, EndpointAddress)

Origem:
ClientBase.cs
Origem:
ClientBase.cs

Inicializa uma nova instância da classe ClientBase<TChannel> usando as informações de endereço de destino e de ponto de extremidade 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

O nome do ponto de extremidade no arquivo de configuração de aplicativo.

remoteAddress
EndpointAddress

O endereço do serviço.

Exceções

endpointConfigurationName ou remoteAddress é null.

Não foi possível encontrar o ponto de extremidade ou o contrato do ponto de extremidade é inválido.

Comentários

Use esse construtor para determinar as informações de ponto de extremidade de destino do nome do ponto de extremidade em um arquivo de configuração de aplicativo (o valor de destino está localizado localizando o name atributo do elemento de ponto> de extremidade do cliente<) e o endereço especificado.

Aplica-se a

ClientBase<TChannel>(InstanceContext, String)

Inicializa uma nova instância da classe ClientBase<TChannel> usando as informações de configuração de ponto de extremidade e de serviço de retorno de chamada especificadas.

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

O objeto de retorno de chamada que o cliente usa para escutar mensagens do serviço conectado.

endpointConfigurationName
String

O nome do ponto de extremidade no arquivo de configuração de aplicativo.

Exceções

A instância de retorno de chamada ou endpointConfigurationName é null.

Não foi possível encontrar o ponto de extremidade ou o contrato do ponto de extremidade é inválido.

Comentários

Use esse construtor para passar um objeto de serviço que implementa o contrato de retorno de chamada para o serviço de destino e determinar as informações de ponto de extremidade de destino do arquivo de configuração do aplicativo cliente. O valor de destino está localizado localizando o name atributo do elemento de ponto> de extremidade do cliente<.

Aplica-se a

ClientBase<TChannel>(InstanceContext, String, EndpointAddress)

Inicializa uma nova instância da 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)

Parâmetros

callbackInstance
InstanceContext

O objeto de retorno de chamada que o cliente usa para escutar mensagens do serviço conectado.

endpointConfigurationName
String

O nome do ponto de extremidade no arquivo de configuração de aplicativo.

remoteAddress
EndpointAddress

O endereço do serviço.

Exceções

A instância de retorno de chamada, endpointConfigurationName ou remoteAddress é null.

Não foi possível encontrar o ponto de extremidade ou o contrato do ponto de extremidade é inválido.

Comentários

Use esse construtor para passar um objeto de serviço que implementa o contrato de retorno de chamada para o serviço de destino e determinar as informações de ponto de extremidade de destino do nome do ponto de extremidade em um arquivo de configuração de aplicativo (o valor de destino está localizado localizando o name atributo do elemento de ponto de extremidade> do cliente<) e o endereço especificado.

Confira também

Aplica-se a

ClientBase<TChannel>(Binding, EndpointAddress)

Origem:
ClientBase.cs
Origem:
ClientBase.cs
Origem:
ClientBase.cs

Inicializa uma nova instância da classe ClientBase<TChannel> usando o endereço de associação e de destino especificado.

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

A associação com a qual fazer chamadas para o serviço.

remoteAddress
EndpointAddress

O endereço do ponto de extremidade de serviço.

Exceções

binding ou remoteAddress é null.

Aplica-se a

ClientBase<TChannel>(String)

Origem:
ClientBase.cs
Origem:
ClientBase.cs

Inicializa uma nova instância da classe ClientBase<TChannel> usando as informações de configuração especificadas no arquivo de configuração de aplicativo pelo 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)

Parâmetros

endpointConfigurationName
String

O nome do ponto de extremidade no arquivo de configuração de aplicativo.

Exceções

As informações de ponto de extremidade especificadas são null.

Não foi possível encontrar o ponto de extremidade ou o contrato do ponto de extremidade é inválido.

Comentários

Use esse construtor quando houver mais de um ponto de extremidade de destino no arquivo de configuração do aplicativo. Esse valor é o name atributo do elemento de ponto> de extremidade do cliente<.

Aplica-se a

ClientBase<TChannel>(InstanceContext)

Inicializa uma nova instância do ClientBase<TChannel> classe usando o callbackInstance como o objeto de retorno de chamada em uma conversa 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)

Parâmetros

callbackInstance
InstanceContext

O objeto de retorno de chamada que o aplicativo cliente usa para escutar mensagens do serviço conectado.

Exceções

A instância de retorno de chamada é null.

Ou não há nenhuma informação de ponto de extremidade padrão no arquivo de configuração ou há mais de um ponto de extremidade no arquivo de configuração, ou ainda, não há nenhum arquivo de configuração.

Exemplos

O exemplo de código a seguir mostra como usar esse construtor com uma SampleDuplexHelloClient classe para passar um objeto de retorno de chamada que escuta mensagens do serviço.

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

Comentários

Use esse construtor quando o contrato de serviço exigir uma instância de serviço de retorno de chamada. O ponto de extremidade de destino é construído com base no parâmetro de tipo e nas informações no arquivo de configuração do aplicativo.

Confira também

Aplica-se a

ClientBase<TChannel>(ServiceEndpoint)

Origem:
ClientBase.cs
Origem:
ClientBase.cs
Origem:
ClientBase.cs

Inicializa uma nova instância da classe ClientBase<TChannel> usando o ServiceEndpoint especificado.

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

O ponto de extremidade em um serviço que permite que os clientes localizem e se comuniquem com o serviço.

Aplica-se a

ClientBase<TChannel>(InstanceContext, ServiceEndpoint)

Inicializa uma nova instância da classe ClientBase<TChannel> usando os objetos InstanceContext e 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

O objeto de retorno de chamada que o aplicativo cliente usa para escutar mensagens do serviço conectado.

endpoint
ServiceEndpoint

O ponto de extremidade em um serviço que permite que os clientes localizem e se comuniquem com o serviço.

Aplica-se a