ClientBase<TChannel> Construtores

Definição

Espaço de Nomes:: System.ServiceModel

Assemblagens:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Assemblagem:: System.ServiceModel.Primitives.dll

Assemblagem:: System.ServiceModel.dll

Pacote:: System.ServiceModel.Primitives v10.0.652802

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	Description
ClientBase<TChannel>()	Inicializa uma nova instância da ClientBase<TChannel> classe usando o endpoint alvo predefinido a partir do ficheiro de configuração da aplicação.
ClientBase<TChannel>(InstanceContext, String, String)	Inicializa uma nova instância da ClientBase<TChannel> classe.
ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)	Inicializa uma nova instância da ClientBase<TChannel> classe.
ClientBase<TChannel>(String, String)	Inicializa uma nova instância da ClientBase<TChannel> classe.
ClientBase<TChannel>(String, EndpointAddress)	Inicializa uma nova instância da ClientBase<TChannel> classe usando o endereço de destino especificado e a informação do endpoint.
ClientBase<TChannel>(InstanceContext, String)	Inicializa uma nova instância da ClientBase<TChannel> classe usando o serviço de callback especificado e a informação de configuração do endpoint.
ClientBase<TChannel>(InstanceContext, String, EndpointAddress)	Inicializa uma nova instância da ClientBase<TChannel> classe.
ClientBase<TChannel>(Binding, EndpointAddress)	Inicializa uma nova instância da ClientBase<TChannel> classe usando o endereço de ligação e destino especificados.
ClientBase<TChannel>(String)	Inicializa uma nova instância da ClientBase<TChannel> classe usando a informação de configuração especificada no ficheiro de configuração da aplicação por `endpointConfigurationName`.
ClientBase<TChannel>(InstanceContext)	Inicializa uma nova instância da ClientBase<TChannel> classe usando o `callbackInstance` como objeto de chamada de retorno numa conversa duplex.
ClientBase<TChannel>(ServiceEndpoint)	Inicializa uma nova instância da ClientBase<TChannel> classe usando o especificado ServiceEndpoint.
ClientBase<TChannel>(InstanceContext, ServiceEndpoint)	Inicializa uma nova instância da ClientBase<TChannel> classe usando os objetos e InstanceContext especificadosServiceEndpoint.

Observações

Use para criar um objeto cliente WCF a partir da informação do endpoint no ficheiro de configuração da aplicação. A principal função do construtor é criar um System.ServiceModel.ChannelFactory<TChannel> onde o parâmetro de tipo é o tipo do contrato de serviço alvo.

ClientBase<TChannel>()

Origem:: ClientBase.cs

Origem:: ClientBase.cs

Origem:: ClientBase.cs

Inicializa uma nova instância da ClientBase<TChannel> classe usando o endpoint alvo predefinido a partir do ficheiro de configuração da aplicação.

protected:
 ClientBase();

protected ClientBase();

Protected Sub New ()

Exceções

InvalidOperationException

Ou não há informação de endpoint padrão no ficheiro de configuração, mais do que um endpoint no ficheiro, ou não há ficheiro de configuração.

Exemplos

O exemplo de código seguinte mostra como um cliente usa este construtor numa 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

Observações

Use este construtor para criar um objeto cliente WCF para invocar um serviço. Este construtor utiliza o parâmetro de tipo como contrato de destino e a informação de ligação e endereço do ficheiro de configuração da aplicação.

Aplica-se a

ClientBase<TChannel>(InstanceContext, String, String)

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

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 callback que o cliente usa para ouvir mensagens do serviço ligado.

endpointConfigurationName: String

O nome do endpoint no ficheiro de configuração da aplicação.

remoteAddress: String

A morada do serviço.

Exceções

ArgumentNullException

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

InvalidOperationException

O endpoint não pode ser encontrado ou o contrato endpoint não é válido.

Observações

Use este construtor para passar um objeto de serviço que implemente o contrato de callback para o serviço alvo e determine a informação do endpoint alvo a partir do nome do endpoint num ficheiro de configuração de aplicação (O valor alvo é localizado ao encontrar o name atributo do elemento do endpoint> cliente<) e o endereço especificado.

Ver também

CallbackContract

Aplica-se a

ClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)

Origem:: ClientBase.cs

Origem:: ClientBase.cs

Origem:: ClientBase.cs

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

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.

binding: Binding

A ligação com que chamar o serviço.

remoteAddress: EndpointAddress

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

Exceções

ArgumentNullException

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

Aplica-se a

ClientBase<TChannel>(String, String)

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

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 endpoint no ficheiro de configuração da aplicação.

remoteAddress: String

A morada do serviço.

Exceções

ArgumentNullException

endpointConfigurationName ou remoteAddress é null.

InvalidOperationException

O endpoint não pode ser encontrado ou o contrato endpoint não é válido.

Observações

Use este construtor para determinar a informação do endpoint destino a partir do nome do endpoint num ficheiro de configuração de aplicação (O valor alvo é localizado ao encontrar o name atributo do elemento do endpoint> cliente<) e o endereço especificado.

Ver também

CallbackContract

Aplica-se a

ClientBase<TChannel>(String, EndpointAddress)

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

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 endpoint no ficheiro de configuração da aplicação.

remoteAddress: EndpointAddress

A morada do serviço.

Exceções

ArgumentNullException

endpointConfigurationName ou remoteAddress é null.

InvalidOperationException

O endpoint não pode ser encontrado ou o contrato endpoint não é válido.

Observações

Aplica-se a

ClientBase<TChannel>(InstanceContext, String)

Inicializa uma nova instância da ClientBase<TChannel> classe usando o serviço de callback especificado e a informação de configuração do endpoint.

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 callback que o cliente usa para ouvir mensagens do serviço ligado.

endpointConfigurationName: String

O nome do endpoint no ficheiro de configuração da aplicação.

Exceções

ArgumentNullException

A instância de callback ou endpointConfigurationName é null.

InvalidOperationException

O endpoint não pode ser encontrado ou o contrato endpoint não é válido.

Observações

Use este construtor para passar um objeto de serviço que implementa o contrato de callback para o serviço alvo e determinar a informação do endpoint alvo a partir do ficheiro de configuração da aplicação cliente. O valor alvo é localizado ao encontrar o name atributo do elemento endpoint> do cliente<.

Aplica-se a

ClientBase<TChannel>(InstanceContext, String, EndpointAddress)

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

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 callback que o cliente usa para ouvir mensagens do serviço ligado.

endpointConfigurationName: String

O nome do endpoint no ficheiro de configuração da aplicação.

remoteAddress: EndpointAddress

A morada do serviço.

Exceções

ArgumentNullException

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

InvalidOperationException

O endpoint não pode ser encontrado ou o contrato endpoint não é válido.

Observações

Ver também

CallbackContract

Aplica-se a

ClientBase<TChannel>(Binding, EndpointAddress)

Origem:: ClientBase.cs

Origem:: ClientBase.cs

Origem:: ClientBase.cs

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

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 vinculação com que fazer chamadas para o serviço.

remoteAddress: EndpointAddress

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

Exceções

ArgumentNullException

binding ou remoteAddress é null.

Aplica-se a

ClientBase<TChannel>(String)

Inicializa uma nova instância da ClientBase<TChannel> classe usando a informação de configuração especificada no ficheiro de configuração da aplicação por 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 endpoint no ficheiro de configuração da aplicação.

Exceções

ArgumentNullException

A informação especificada do endpoint é null.

InvalidOperationException

O endpoint não pode ser encontrado ou o contrato endpoint não é válido.

Observações

Use este construtor quando houver mais do que um endpoint alvo no ficheiro de configuração da aplicação. Este valor é o name atributo do elemento endpoint> do cliente<.

Aplica-se a

ClientBase<TChannel>(InstanceContext)

Origem:: ClientBase.cs

Origem:: ClientBase.cs

Inicializa uma nova instância da ClientBase<TChannel> classe usando o callbackInstance como objeto de chamada de retorno numa 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 callback que a aplicação cliente utiliza para ouvir mensagens do serviço ligado.

Exceções

ArgumentNullException

A instância de callback é null.

InvalidOperationException

Ou não há informação de endpoint padrão no ficheiro de configuração, mais do que um endpoint no ficheiro, ou não há ficheiro de configuração.

Exemplos

O exemplo de código seguinte mostra como usar este construtor com uma SampleDuplexHelloClient classe para passar um objeto de callback 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

Observações

Use este construtor quando o contrato de serviço exige uma instância de serviço de callback. O endpoint alvo é construído a partir do parâmetro de tipo e da informação no ficheiro de configuração da aplicação.

Ver também

CallbackContract

Aplica-se a

ClientBase<TChannel>(ServiceEndpoint)

Origem:: ClientBase.cs

Origem:: ClientBase.cs

Origem:: ClientBase.cs

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

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 endpoint de um serviço que permite aos clientes encontrar e comunicar com o serviço.

Aplica-se a

ClientBase<TChannel>(InstanceContext, ServiceEndpoint)

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

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 callback que a aplicação cliente utiliza para ouvir mensagens do serviço ligado.

endpoint: ServiceEndpoint

O endpoint de um serviço que permite aos clientes encontrar e comunicar com o serviço.

Aplica-se a

Comentários

Esta página foi útil?