WebChannelFactory<TChannel> Clase
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í.
Clase para tener acceso a los servicios Web Windows Communication Foundation (WCF) en un cliente.
generic <typename TChannel>
where TChannel : classpublic ref class WebChannelFactory : System::ServiceModel::ChannelFactory<TChannel>generic <typename TChannel>
public ref class WebChannelFactory : System::ServiceModel::ChannelFactory<TChannel>public class WebChannelFactory<TChannel> : System.ServiceModel.ChannelFactory<TChannel> where TChannel : classpublic class WebChannelFactory<TChannel> : System.ServiceModel.ChannelFactory<TChannel>type WebChannelFactory<'Channel (requires 'Channel : null)> = class
inherit ChannelFactory<'Channel (requires 'Channel : null)>type WebChannelFactory<'Channel> = class
inherit ChannelFactory<'Channel>Public Class WebChannelFactory(Of TChannel)
Inherits ChannelFactory(Of TChannel)Parámetros de tipo
- TChannel
El tipo de canal que se va a crear.
- Herencia
Ejemplos
En el código siguiente se muestra cómo usar la WebChannelFactory<TChannel> clase para llamar a un servicio WCF.
Uri baseAddress = new Uri("http://localhost:8000");
WebServiceHost host = new WebServiceHost(typeof(Service), baseAddress);
try
{
host.Open();
WebChannelFactory<IService> cf = new WebChannelFactory<IService>(baseAddress);
IService channel = cf.CreateChannel();
string s;
Console.WriteLine("Calling EchoWithGet via HTTP GET: ");
s = channel.EchoWithGet("Hello, world");
Console.WriteLine(" Output: {0}", s);
Console.WriteLine("");
Console.WriteLine("Calling EchoWithPost via HTTP POST: ");
s = channel.EchoWithPost("Hello, world");
Console.WriteLine(" Output: {0}", s);
Console.WriteLine("");
}
catch (CommunicationException ex)
{
Console.WriteLine("An exception occurred: " + ex.Message);
}
Dim baseAddress As New Uri("http://localhost:8000")
Dim host As New WebServiceHost(GetType(Service), baseAddress)
Try
host.Open()
Dim cf As New WebChannelFactory(Of IService)(baseAddress)
Dim channel As IService = cf.CreateChannel()
Dim s As String
Console.WriteLine("Calling EchoWithGet via HTTP GET: ")
s = channel.EchoWithGet("Hello, world")
Console.WriteLine(" Output: 0}", s)
Console.WriteLine("")
Console.WriteLine("Calling EchoWithPost via HTTP POST: ")
s = channel.EchoWithPost("Hello, world")
Console.WriteLine(" Output: 0}", s)
Console.WriteLine("")
Catch ex As CommunicationException
Console.WriteLine("An exception occurred: " + ex.Message)
End Try
Para obtener un ejemplo de código completo, vea Ejemplo básico de modelo de programación rest de WCF.
Comentarios
Esta clase es un ChannelFactory especial que agrega automáticamente el WebHttpBehavior al extremo si todavía no está presente. Además, agrega un WebHttpBinding predeterminado al punto de conexión si el enlace no está configurado explícitamente y la dirección es una dirección HTTP o HTTPS.
Si todas las operaciones del contrato no tienen ningún valor devuelto o tienen un valor devuelto de tipo Stream, WebChannelFactory<TChannel> configura el enlace para el tipo de contenido adecuado.
Constructores
Propiedades
| Credentials |
Obtiene las credenciales utilizadas por los clientes para comunicarse con un punto de conexión de servicio mediante los canales generados por el generador. (Heredado de ChannelFactory) |
| DefaultCloseTimeout |
Obtiene el intervalo de tiempo predeterminado proporcionado para que se complete una operación de cierre. (Heredado de ChannelFactory) |
| DefaultOpenTimeout |
Obtiene el intervalo de tiempo predeterminado proporcionado para que se complete una operación de apertura. (Heredado de ChannelFactory) |
| Endpoint |
Obtiene el extremo de servicio al que se conectan los canales generados por el generador. (Heredado de ChannelFactory) |
| IsDisposed |
Obtiene un valor que indica si el objeto de comunicación se ha eliminado. (Heredado de CommunicationObject) |
| State |
Obtiene un valor que indica el estado actual del objeto de comunicación. (Heredado de CommunicationObject) |
| ThisLock |
Obtiene el bloqueo mutuamente excluyente que protege la instancia de clase durante una transición de estado. (Heredado de CommunicationObject) |
Métodos
| Abort() |
Provoca que un objeto de comunicación pase inmediatamente de su estado actual al estado de cierre. (Heredado de CommunicationObject) |
| ApplyConfiguration(String) |
Inicializa el generador de canales con los comportamientos proporcionados por un archivo de configuración especificado y con los del punto de conexión de servicio del generador de canales. (Heredado de ChannelFactory) |
| BeginClose(AsyncCallback, Object) |
Comienza una operación asincrónica para cerrar un objeto de comunicación. (Heredado de CommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Comienza una operación asincrónica para cerrar un objeto de comunicación con un tiempo de espera especificado. (Heredado de CommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Comienza una operación asincrónica para abrir un objeto de comunicación. (Heredado de CommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Comienza una operación asincrónica para abrir un objeto de comunicación dentro de un intervalo de tiempo especificado. (Heredado de CommunicationObject) |
| Close() |
Provoca que un objeto de comunicación pase de su estado actual al estado cerrado. (Heredado de CommunicationObject) |
| Close(TimeSpan) |
Provoca que un objeto de comunicación pase su estado actual al estado cerrado dentro de un intervalo de tiempo especificado. (Heredado de CommunicationObject) |
| CreateChannel() |
Crea un canal de un tipo especificado a una dirección de punto de conexión especificada. (Heredado de ChannelFactory<TChannel>) |
| CreateChannel(EndpointAddress) |
Crea un canal que se utiliza para enviar mensajes a un servicio en una dirección de punto de conexión concreta. (Heredado de ChannelFactory<TChannel>) |
| CreateChannel(EndpointAddress, Uri) |
Crea un canal que se usa para enviar los mensajes a un servicio en una dirección de punto de conexión concreta a través de una dirección de transporte especificada. (Heredado de ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken) |
Crea un canal que se utiliza para enviar mensajes a un servicio con un token de seguridad "actuar como". (Heredado de ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken, EndpointAddress) |
Crea un canal que se utiliza para enviar mensajes a un servicio con un acto como un token de seguridad "en nombre de" en una dirección de extremo concreta. (Heredado de ChannelFactory<TChannel>) |
| CreateChannelWithActAsToken(SecurityToken, EndpointAddress, Uri) |
Crea un canal que se usa para enviar los mensajes a un servicio con un acto como un token de seguridad en una dirección de extremo concreta a través de una dirección de transporte especificada. (Heredado de ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken) |
Crea un canal que se utiliza para enviar mensajes a un servicio con un token de seguridad emitido. (Heredado de ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken, EndpointAddress) |
Crea un canal que se utiliza para enviar mensajes a un servicio con un acto como un token de seguridad "en nombre de" en una dirección de extremo concreta. (Heredado de ChannelFactory<TChannel>) |
| CreateChannelWithIssuedToken(SecurityToken, EndpointAddress, Uri) |
Crea un canal que se usa para enviar los mensajes a un servicio con un token de seguridad emitido en una dirección de extremo concreta a través de una dirección de transporte especificada. (Heredado de ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken) |
Crea un canal que se utiliza para enviar mensajes a un servicio con un token de seguridad "en nombre de". (Heredado de ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress) |
Crea un canal que se utiliza para enviar mensajes a un servicio con un token de seguridad "en nombre de" en una dirección de extremo concreta. (Heredado de ChannelFactory<TChannel>) |
| CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress, Uri) |
Crea un canal que se usa para enviar los mensajes a un servicio en nombre de un token de seguridad emitido en una dirección de extremo concreta a través de una dirección de transporte especificada. (Heredado de ChannelFactory<TChannel>) |
| CreateDescription() |
Crea una descripción del punto de conexión de servicio. (Heredado de ChannelFactory<TChannel>) |
| CreateFactory() |
Construye el generador de canales para el punto de conexión actual del generador. (Heredado de ChannelFactory) |
| EndClose(IAsyncResult) |
Completa una operación asincrónica para cerrar un objeto de comunicación. (Heredado de CommunicationObject) |
| EndOpen(IAsyncResult) |
Completa una operación asincrónica para abrir un objeto de comunicación. (Heredado de CommunicationObject) |
| EnsureOpened() |
Abre el generador de canales actual si todavía no está abierto. (Heredado de ChannelFactory) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| Fault() |
Provoca que un objeto de comunicación pase de su estado actual al estado de error. (Heredado de CommunicationObject) |
| GetCommunicationObjectType() |
Obtiene el tipo de objeto de comunicación. (Heredado de CommunicationObject) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetProperty<T>() |
Devuelve el objeto con tipo solicitado desde la capa adecuada en la pila del canal, si está presente, o |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| InitializeEndpoint(Binding, EndpointAddress) |
Inicializa el extremo de servicio del generador de canales con un enlace especificado y dirección. (Heredado de ChannelFactory) |
| InitializeEndpoint(ServiceEndpoint) |
Inicializa el punto de conexión de servicio del generador de canales con un punto de conexión especificado. (Heredado de ChannelFactory) |
| InitializeEndpoint(String, EndpointAddress) |
Inicializa el extremo de servicio del generador de canales con una dirección especificada y configuración. (Heredado de ChannelFactory) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| OnAbort() |
Finaliza el generador de canales interno del generador de canales actual. (Heredado de ChannelFactory) |
| OnBeginClose(TimeSpan, AsyncCallback, Object) |
Comienza una operación de cierre asincrónica en el generador de canales interno del generador de canales actual que tiene un objeto de estados asociado a él. (Heredado de ChannelFactory) |
| OnBeginOpen(TimeSpan, AsyncCallback, Object) |
Comienza una operación de apertura asincrónica en el generador de canales interno del generador de canales actual que tiene un objeto de estados asociado a él. (Heredado de ChannelFactory) |
| OnClose(TimeSpan) |
Llama el cierre en el generador de canales interno con un tiempo de espera especificado para la realización de la operación. (Heredado de ChannelFactory) |
| OnClosed() |
Se invoca durante la transición de un objeto de comunicación al estado de cierre. (Heredado de CommunicationObject) |
| OnClosing() |
Se invoca durante la transición de un objeto de comunicación al estado de cierre. (Heredado de CommunicationObject) |
| OnEndClose(IAsyncResult) |
Completa una operación de cierre asincrónica en el generador de canales interno del generador de canales actual. (Heredado de ChannelFactory) |
| OnEndOpen(IAsyncResult) |
Completa una operación de apertura asincrónica en el generador de canales interno del generador de canales actual. (Heredado de ChannelFactory) |
| OnFaulted() |
Inserta el procesamiento en un objeto de comunicación después de que éste pase al estado de error debido a la invocación de una operación sincrónica de error. (Heredado de CommunicationObject) |
| OnOpen(TimeSpan) |
Llama la apertura en el generador de canales interno del generador de canales actual con un tiempo de espera especificado para la realización de la operación. (Heredado de ChannelFactory) |
| OnOpened() |
Inicializa una copia de solo lectura del objeto ClientCredentials para el generador de canales. (Heredado de ChannelFactory) |
| OnOpening() |
Se llama a este método cuando se abre el WebChannelFactory<TChannel>. |
| Open() |
Hace que un objeto de comunicación pase del estado creado al estado abierto. (Heredado de CommunicationObject) |
| Open(TimeSpan) |
Hace que un objeto de comunicación pase del estado creado al estado abierto dentro de un intervalo de tiempo especificado. (Heredado de CommunicationObject) |
| ThrowIfDisposed() |
Produce una excepción si se elimina el objeto de comunicación. (Heredado de CommunicationObject) |
| ThrowIfDisposedOrImmutable() |
Produce una excepción si en el objeto de comunicación la propiedad State no está establecida en el estado Created. (Heredado de CommunicationObject) |
| ThrowIfDisposedOrNotOpen() |
Produce una excepción si el objeto de comunicación no está en el estado Opened. (Heredado de CommunicationObject) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Eventos
| Closed |
Se produce cuando un objeto de comunicación realiza una transición al estado de cerrado. (Heredado de CommunicationObject) |
| Closing |
Se produce cuando un objeto de comunicación realiza una transición al estado de cerrando. (Heredado de CommunicationObject) |
| Faulted |
Se produce cuando un objeto de comunicación realiza una transición al estado de error. (Heredado de CommunicationObject) |
| Opened |
Se produce cuando un objeto de comunicación realiza una transición al estado de abierto. (Heredado de CommunicationObject) |
| Opening |
Se produce cuando un objeto de comunicación realiza una transición al estado de abriendo. (Heredado de CommunicationObject) |
Implementaciones de interfaz explícitas
| IDisposable.Dispose() |
Cierra el generador de canales actual. (Heredado de ChannelFactory) |