Partilhar via


WebChannelFactory<TChannel> Classe

Definição

Uma classe para acessar os serviços Web do WCF (Windows Communication Foundation) em um cliente.

generic <typename TChannel>
 where TChannel : classpublic ref class WebChannelFactory : System::ServiceModel::ChannelFactory<TChannel>
public class WebChannelFactory<TChannel> : System.ServiceModel.ChannelFactory<TChannel> where TChannel : class
type WebChannelFactory<'Channel (requires 'Channel : null)> = class
    inherit ChannelFactory<'Channel (requires 'Channel : null)>
Public Class WebChannelFactory(Of TChannel)
Inherits ChannelFactory(Of TChannel)

Parâmetros de tipo

TChannel

O tipo de canal a ser criado.

Herança

Exemplos

O código a seguir mostra como usar a WebChannelFactory<TChannel> classe para chamar um serviço 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 obter um exemplo de código completo, consulte Exemplo básico de modelo de programação REST do WCF.

Comentários

Essa classe é especial ChannelFactory que adiciona automaticamente o WebHttpBehavior ao ponto de extremidade se ele ainda não estiver presente. Além disso, ele adicionará um padrão ao ponto WebHttpBinding de extremidade se a associação não estiver configurada explicitamente e o endereço for um endereço HTTP ou HTTPS.

Se todas as operações do contrato não tiverem nenhum valor retornado ou tiverem um valor retornado do tipo Stream, o WebChannelFactory<TChannel> configurará a associação para o tipo de conteúdo apropriado.

Construtores

WebChannelFactory<TChannel>()

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

WebChannelFactory<TChannel>(Binding)

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

WebChannelFactory<TChannel>(Binding, Uri)

Inicializa uma nova instância da classe WebChannelFactory<TChannel> com a associação e o Uri especificados.

WebChannelFactory<TChannel>(ServiceEndpoint)

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

WebChannelFactory<TChannel>(String)

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

WebChannelFactory<TChannel>(String, Uri)

Inicializa uma nova instância da classe WebChannelFactory<TChannel> com a configuração de ponto de extremidade e o Uri especificados.

WebChannelFactory<TChannel>(Type)

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

WebChannelFactory<TChannel>(Uri)

Inicializa uma nova instância da classe WebChannelFactory<TChannel> com o Uri especificado.

Propriedades

Credentials

Obtém as credenciais usadas pelos clientes para comunicação com um ponto de extremidade de serviço pelos canais produzidos pela fábrica.

(Herdado de ChannelFactory)
DefaultCloseTimeout

Obtém o intervalo de tempo padrão fornecido para a conclusão de uma operação close.

(Herdado de ChannelFactory)
DefaultOpenTimeout

Obtém o intervalo de tempo padrão fornecido para a conclusão de uma operação open.

(Herdado de ChannelFactory)
Endpoint

Obtém o ponto de extremidade de serviço ao qual os canais produzidos pela fábrica se conectam.

(Herdado de ChannelFactory)
IsDisposed

Obtém um valor que indica se o objeto de comunicação foi descartado.

(Herdado de CommunicationObject)
State

Obtém um valor que indica o estado atual do objeto de comunicação.

(Herdado de CommunicationObject)
ThisLock

Obtém o bloqueio mutuamente exclusivo que protege a instância da classe durante uma transição de estado.

(Herdado de CommunicationObject)

Métodos

Abort()

Faz com que um objeto de comunicação faça a transição imediata do estado atual para o estado de fechamento.

(Herdado de CommunicationObject)
ApplyConfiguration(String)

Inicializa a fábrica de canais com os comportamentos fornecidos por um arquivo de configuração especificado e com aqueles no ponto de extremidade de serviço da fábrica de canais.

(Herdado de ChannelFactory)
BeginClose(AsyncCallback, Object)

Inicia uma operação assíncrona para fechar um objeto de comunicação.

(Herdado de CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

Inicia uma operação assíncrona para fechar um objeto de comunicação com um tempo limite especificado.

(Herdado de CommunicationObject)
BeginOpen(AsyncCallback, Object)

Inicia uma operação assíncrona para abrir um objeto de comunicação.

(Herdado de CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

Inicia uma operação assíncrona para abrir um objeto de comunicação dentro de um intervalo de tempo especificado.

(Herdado de CommunicationObject)
Close()

Faz com que um objeto de comunicação faça a transição do estado atual para o estado fechado.

(Herdado de CommunicationObject)
Close(TimeSpan)

Faz com que um objeto de comunicação faça a transição do estado atual para o estado fechado dentro de um intervalo de tempo especificado.

(Herdado de CommunicationObject)
CreateChannel()

Cria um canal de um tipo especificado para um endereço do ponto de extremidade especificado.

(Herdado de ChannelFactory<TChannel>)
CreateChannel(EndpointAddress)

Cria um canal que é usado para enviar mensagens para um serviço em um endereço específico de ponto de extremidade.

(Herdado de ChannelFactory<TChannel>)
CreateChannel(EndpointAddress, Uri)

Cria um canal que é usado para enviar mensagens para um serviço em um endereço do ponto de extremidade específico por meio de um endereço de transporte especificado.

(Herdado de ChannelFactory<TChannel>)
CreateChannelWithActAsToken(SecurityToken)

Cria um canal que é usado para enviar mensagens para um serviço com uma ação como token de segurança.

(Herdado de ChannelFactory<TChannel>)
CreateChannelWithActAsToken(SecurityToken, EndpointAddress)

Cria um canal que é usado para enviar mensagens para um serviço com uma ação como token de segurança em um endereço do ponto de extremidade específico.

(Herdado de ChannelFactory<TChannel>)
CreateChannelWithActAsToken(SecurityToken, EndpointAddress, Uri)

Cria um canal que é usado para enviar mensagens para um serviço com uma ação como um token de segurança em um endereço do ponto de extremidade específico por meio de um endereço de transporte especificado.

(Herdado de ChannelFactory<TChannel>)
CreateChannelWithIssuedToken(SecurityToken)

Cria um canal que é usado para enviar mensagens para um serviço com um token de segurança emitido.

(Herdado de ChannelFactory<TChannel>)
CreateChannelWithIssuedToken(SecurityToken, EndpointAddress)

Cria um canal que é usado para enviar mensagens para um serviço com um token de segurança emitido em um endereço do ponto de extremidade específico.

(Herdado de ChannelFactory<TChannel>)
CreateChannelWithIssuedToken(SecurityToken, EndpointAddress, Uri)

Cria um canal que é usado para enviar mensagens para um serviço com um token de segurança emitido em um endereço do ponto de extremidade específico por meio de um endereço de transporte especificado.

(Herdado de ChannelFactory<TChannel>)
CreateChannelWithOnBehalfOfToken(SecurityToken)

Cria um canal que é usado para enviar mensagens para um serviço em nome de um token de segurança.

(Herdado de ChannelFactory<TChannel>)
CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress)

Cria um canal que é usado para enviar mensagens para um serviço com um token de segurança em nome de em um endereço do ponto de extremidade específico.

(Herdado de ChannelFactory<TChannel>)
CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress, Uri)

Cria um canal que é usado para enviar mensagens para um serviço com um token de segurança em nome de em um endereço do ponto de extremidade específico por meio de um endereço de transporte especificado.

(Herdado de ChannelFactory<TChannel>)
CreateDescription()

Cria uma descrição do ponto de extremidade de serviço.

(Herdado de ChannelFactory<TChannel>)
CreateFactory()

Cria a fábrica de canais para o ponto de extremidade atual da fábrica.

(Herdado de ChannelFactory)
EndClose(IAsyncResult)

Conclui uma operação assíncrona para fechar um objeto de comunicação.

(Herdado de CommunicationObject)
EndOpen(IAsyncResult)

Conclui uma operação assíncrona para abrir um objeto de comunicação.

(Herdado de CommunicationObject)
EnsureOpened()

Abre a fábrica de canais atual se ela ainda não estiver aberta.

(Herdado de ChannelFactory)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Fault()

Faz com que um objeto de comunicação faça a transição do estado atual para o estado com falha.

(Herdado de CommunicationObject)
GetCommunicationObjectType()

Obtém o tipo de objeto de comunicação.

(Herdado de CommunicationObject)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetProperty<T>()

Retorna o objeto tipado solicitado, se presente, da camada apropriada na pilha de canais ou null, se ele não está presente.

(Herdado de ChannelFactory)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeEndpoint(Binding, EndpointAddress)

Inicializa o ponto de extremidade de serviço da fábrica de canais com uma associação e endereço especificados.

(Herdado de ChannelFactory)
InitializeEndpoint(ServiceEndpoint)

Inicializa o ponto de extremidade de serviço da fábrica de canais com um ponto de extremidade especificado.

(Herdado de ChannelFactory)
InitializeEndpoint(String, EndpointAddress)

Inicializa o ponto de extremidade de serviço da fábrica de canais com uma configuração e endereço especificados.

(Herdado de ChannelFactory)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
OnAbort()

Finaliza a fábrica de canais interna da fábrica de canais atual.

(Herdado de ChannelFactory)
OnBeginClose(TimeSpan, AsyncCallback, Object)

Inicia uma operação close assíncrona na fábrica de canais interna da fábrica de canais atual que tem um objeto de estado associado a ela.

(Herdado de ChannelFactory)
OnBeginOpen(TimeSpan, AsyncCallback, Object)

Inicia uma operação open assíncrona na fábrica de canais interna da fábrica de canais atual que tem um objeto de estado associado a ela.

(Herdado de ChannelFactory)
OnClose(TimeSpan)

Chama close na fábrica de canais interna com um tempo limite especificado para a conclusão da operação.

(Herdado de ChannelFactory)
OnClosed()

Chamada durante a transição de um objeto de comunicação para o estado de fechamento.

(Herdado de CommunicationObject)
OnClosing()

Chamada durante a transição de um objeto de comunicação para o estado de fechamento.

(Herdado de CommunicationObject)
OnEndClose(IAsyncResult)

Completa uma operação close assíncrona na fábrica de canais interna da fábrica de canais atual.

(Herdado de ChannelFactory)
OnEndOpen(IAsyncResult)

Completa uma operação open assíncrona na fábrica de canais interna da fábrica de canais atual.

(Herdado de ChannelFactory)
OnFaulted()

Insere o processamento em um objeto de comunicação depois que ela fez a transição para o estado de fechamento devido à invocação de uma operação fault síncrona.

(Herdado de CommunicationObject)
OnOpen(TimeSpan)

Chama open na fábrica de canais interna da fábrica de canais atual com um tempo limite especificado para a conclusão da operação.

(Herdado de ChannelFactory)
OnOpened()

Inicializa uma cópia somente leitura do objeto ClientCredentials para a fábrica de canais.

(Herdado de ChannelFactory)
OnOpening()

Este método é chamado quando a WebChannelFactory<TChannel> é aberta.

Open()

Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto.

(Herdado de CommunicationObject)
Open(TimeSpan)

Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto em um intervalo de tempo especificado.

(Herdado de CommunicationObject)
ThrowIfDisposed()

Gera uma exceção se o objeto de comunicação é descartado.

(Herdado de CommunicationObject)
ThrowIfDisposedOrImmutable()

Gera uma exceção se o objeto de comunicação da propriedade State não estiver definido para o estado Created.

(Herdado de CommunicationObject)
ThrowIfDisposedOrNotOpen()

Gera uma exceção se o objeto de comunicação não estiver no estado Opened.

(Herdado de CommunicationObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

Closed

Ocorre quando um objeto de comunicação entra no estado fechado.

(Herdado de CommunicationObject)
Closing

Ocorre quando um objeto de comunicação faz a transição para o estado fechado.

(Herdado de CommunicationObject)
Faulted

Ocorre quando um objeto de comunicação entra em um estado de falha.

(Herdado de CommunicationObject)
Opened

Ocorre quando um objeto de comunicação faz a transição para o estado aberto.

(Herdado de CommunicationObject)
Opening

Ocorre quando um objeto de comunicação faz a transição para o estado de abertura.

(Herdado de CommunicationObject)

Implantações explícitas de interface

IDisposable.Dispose()

Fecha a fábrica de canais atual.

(Herdado de ChannelFactory)

Aplica-se a