ClientBase<TChannel> Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 |
ClientBase<TChannel>(InstanceContext) |
Inicializa uma nova instância do ClientBase<TChannel> classe usando o |
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.