ClientBase<TChannel> Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 |
ClientBase<TChannel>(InstanceContext) |
Inicializa una nueva instancia de la clase ClientBase<TChannel> utilizando |
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.