ChannelFactory<TChannel> Classe

Definição

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Pacote:

System.ServiceModel.Primitives v8.0.0

Origem:

ChannelFactory.cs

Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado.

generic <typename TChannel>
public ref class ChannelFactory : System::ServiceModel::ChannelFactory, System::ServiceModel::Channels::IChannelFactory<TChannel>

public class ChannelFactory<TChannel> : System.ServiceModel.ChannelFactory, System.ServiceModel.Channels.IChannelFactory<TChannel>

type ChannelFactory<'Channel> = class
    inherit ChannelFactory
    interface IChannelFactory<'Channel>
    interface IChannelFactory
    interface ICommunicationObject

Public Class ChannelFactory(Of TChannel)
Inherits ChannelFactory
Implements IChannelFactory(Of TChannel)

Parâmetros de tipo

TChannel

O tipo de canal produzido pela fábrica de canais. Esse tipo deve ser IOutputChannel ou IRequestChannel.

Herança

Object

CommunicationObject

ChannelFactory

ChannelFactory<TChannel>

Derivado

System.ServiceModel.Configuration.ConfigurationChannelFactory<TChannel>

System.ServiceModel.DuplexChannelFactory<TChannel>

System.ServiceModel.Federation.WSTrustChannelFactory

System.ServiceModel.Security.WSTrustChannelFactory

System.ServiceModel.Web.WebChannelFactory<TChannel>

Implementações

IChannelFactory IChannelFactory<TChannel> ICommunicationObject

Exemplos

O exemplo a seguir mostra como criar uma fábrica de canais e usá-la para criar e gerenciar canais.

    BasicHttpBinding binding = new BasicHttpBinding();
    EndpointAddress address = new EndpointAddress("http://localhost:8000/ChannelApp");

    ChannelFactory<IRequestChannel> factory =
        new ChannelFactory<IRequestChannel>(binding, address);

    IRequestChannel channel = factory.CreateChannel();
    channel.Open();
    Message request = Message.CreateMessage(MessageVersion.Soap11, "hello");
    Message reply = channel.Request(request);
    Console.Out.WriteLine(reply.Headers.Action);
    reply.Close();
    channel.Close();
    factory.Close();
}

O exemplo de código a seguir mostra como inserir programaticamente um comportamento do cliente antes da criação do objeto de canal pela fábrica.

public class Client
{
  public static void Main()
  {
    try
    {
      // Picks up configuration from the config file.
      ChannelFactory<ISampleServiceChannel> factory
        = new ChannelFactory<ISampleServiceChannel>("WSHttpBinding_ISampleService");

      // Add the client side behavior programmatically to all created channels.
      factory.Endpoint.Behaviors.Add(new EndpointBehaviorMessageInspector());

      ISampleServiceChannel wcfClientChannel = factory.CreateChannel();

      // Making calls.
      Console.WriteLine("Enter the greeting to send: ");
      string greeting = Console.ReadLine();
      Console.WriteLine("The service responded: " + wcfClientChannel.SampleMethod(greeting));

      Console.WriteLine("Press ENTER to exit:");
      Console.ReadLine();

      // Done with service.
      wcfClientChannel.Close();
      Console.WriteLine("Done!");
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine("The service operation timed out. " + timeProblem.Message);
      Console.Read();
    }
    catch (FaultException<SampleFault> fault)
    {
      Console.WriteLine("SampleFault fault occurred: {0}", fault.Detail.FaultMessage);
      Console.Read();
    }
    catch (CommunicationException commProblem)
    {
      Console.WriteLine("There was a communication problem. " + commProblem.Message);
      Console.Read();
    }
  }

Public Class Client
  Public Shared Sub Main()
    Try
      ' Picks up configuration from the config file.
      Dim factory As New ChannelFactory(Of ISampleServiceChannel)("WSHttpBinding_ISampleService")

      ' Add the client side behavior programmatically to all created channels.
      factory.Endpoint.Behaviors.Add(New EndpointBehaviorMessageInspector())

      Dim wcfClientChannel As ISampleServiceChannel = factory.CreateChannel()

      ' Making calls.
      Console.WriteLine("Enter the greeting to send: ")
            Dim greeting As String = Console.ReadLine()
      Console.WriteLine("The service responded: " & wcfClientChannel.SampleMethod(greeting))

      Console.WriteLine("Press ENTER to exit:")
      Console.ReadLine()

      ' Done with service. 
      wcfClientChannel.Close()
      Console.WriteLine("Done!")
    Catch timeProblem As TimeoutException
      Console.WriteLine("The service operation timed out. " & timeProblem.Message)
      Console.Read()
    Catch fault As FaultException(Of SampleFault)
      Console.WriteLine("SampleFault fault occurred: {0}", fault.Detail.FaultMessage)
      Console.Read()
    Catch commProblem As CommunicationException
      Console.WriteLine("There was a communication problem. " & commProblem.Message)
      Console.Read()
    End Try
  End Sub

Comentários

Essa classe genérica permite cenários mais avançados em que há um requisito para criar uma fábrica de canais que pode ser usada para criar mais de um tipo de canal.

Ao adicionar comportamentos programaticamente, o comportamento é adicionado à propriedade apropriada Behaviors no ChannelFactory antes da criação de qualquer canal. Consulte a seção de exemplo para obter um exemplo de código.

Frequentemente, aplicativos cliente ou de chamada (por exemplo, aplicativos de camada intermediária também são aplicativos cliente) usando esse tipo também têm necessidades complexas de gerenciamento de estado, bem como necessidades de desempenho. Para obter mais informações sobre esses cenários, consulte Aplicativos cliente de camada intermediária.

Construtores

ChannelFactory<TChannel>()	Inicializa uma nova instância da classe ChannelFactory<TChannel>.
ChannelFactory<TChannel>(Binding)	Inicializa uma nova instância da classe ChannelFactory<TChannel>.
ChannelFactory<TChannel>(Binding, EndpointAddress)	Inicializa uma nova instância da classe ChannelFactory<TChannel> com uma associação e um endereço do ponto de extremidade especificados.
ChannelFactory<TChannel>(Binding, String)	Inicializa uma nova instância da classe ChannelFactory<TChannel> com uma associação e um endereço remoto especificados.
ChannelFactory<TChannel>(ServiceEndpoint)	Inicializa uma nova instância da classe ChannelFactory<TChannel> que produz canais com um ponto de extremidade especificado.
ChannelFactory<TChannel>(Type)	Inicializa uma nova instância da classe ChannelFactory<TChannel>.

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.
CreateChannel(Binding, EndpointAddress)	Cria um canal de um tipo especificado que é usado para enviar mensagens a um ponto de extremidade de serviço configurado com uma associação especificada.
CreateChannel(Binding, EndpointAddress, Uri)	Cria um canal de um tipo especificado que é usado para enviar mensagens a um ponto de extremidade de serviço em um endereço de transporte configurado com uma associação especificada.
CreateChannel(EndpointAddress)	Cria um canal que é usado para enviar mensagens para um serviço em um endereço específico de ponto de extremidade.
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.
CreateDescription()	Cria uma descrição do ponto de extremidade de serviço.
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(EndpointAddress)	Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado. (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)
OnCloseAsync(TimeSpan)	Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado. (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)
OnOpenAsync(TimeSpan)	Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado. (Herdado de ChannelFactory)
OnOpened()	Inicializa uma cópia somente leitura do objeto ClientCredentials para a fábrica de canais. (Herdado de ChannelFactory)
OnOpening()	Cria a fábrica de canais interna da fábrica de canais atual. (Herdado de ChannelFactory)
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

IAsyncCommunicationObject.CloseAsync(TimeSpan)	Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado. (Herdado de CommunicationObject)
IAsyncCommunicationObject.OpenAsync(TimeSpan)	Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado. (Herdado de CommunicationObject)
IAsyncDisposable.DisposeAsync()	Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado. (Herdado de ChannelFactory)
IDisposable.Dispose()	Fecha a fábrica de canais atual. (Herdado de ChannelFactory)

Métodos de Extensão

CloseHelperAsync(ICommunicationObject, TimeSpan)	Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado.
OpenHelperAsync(ICommunicationObject, TimeSpan)	Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado.
GetInternalCloseTimeout(CommunicationObject)	Uma fábrica que cria canais de tipos diferentes que são usados pelos clientes para enviar mensagens a diversos pontos de extremidade de serviço configurado.
ConfigureAwait(IAsyncDisposable, Boolean)	Configura como as esperas nas tarefas retornadas de um descartável assíncrono são realizadas.

Acesso thread-safe

Este tipo é thread-safe.