ChannelFactory<TChannel> Classe

Definizione

Factory che crea canali di tipi diversi usati dai client per inviare messaggi a endpoint di servizio configurati in vari modi.A factory that creates channels of different types that are used by clients to send messages to variously configured service endpoints.

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)

Parametri di tipo

TChannel

Tipo di canale prodotto dalla channel factory.The type of channel produced by the channel factory. Questo tipo deve essere IOutputChannel o IRequestChannel.This type must be either IOutputChannel or IRequestChannel.

Ereditarietà
ChannelFactory<TChannel>
Derivato
Implementazioni

Esempi

Nell'esempio seguente viene illustrato come creare una channel factory e come utilizzarla per creare e gestire canali.The following sample shows how to create a channel factory and use it to create and manage channels.

    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();
}	   

Nell'esempio di codice seguente viene illustrato come inserire un comportamento client a livello di codice prima che la factory crei l'oggetto channel.The following code example shows how to insert programmatically a client behavior prior to the creation of the channel object by the factory.

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

Commenti

Questa classe generica consente di implementare scenari più avanzati in cui è necessario creare una channel factory utilizzabile per creare più di un tipo di canale.This generic class enables more advanced scenarios where there is a requirement to create a channel factory that can be used to create more than one type of channel.

Quando si aggiungono comportamenti a livello di codice, il comportamento viene aggiunto alla proprietà Behaviors appropriata in ChannelFactory prima della creazione di qualsiasi canale.When adding behaviors programmatically, the behavior is added to the appropriate Behaviors property on the ChannelFactory prior to the creation of any channel. Per un esempio di codice, vedere la sezione relativa agli esempi.See the example section for a code sample.

Alle applicazioni chiamanti o client che utilizzano questo tipo sono spesso associate esigenze di gestione dello stato complesse, nonché esigenze in termini di prestazioni. Le applicazioni di livello intermedio sono ad esempio applicazioni client.Frequently client or calling applications (for example, middle-tier applications are client applications, too) using this type also have complex state management needs as well as performance needs. Per altre informazioni su questi scenari, vedere applicazioni client di livello intermedio.For more information about these scenarios, please see Middle-Tier Client Applications.

Costruttori

ChannelFactory<TChannel>()

Inizializza una nuova istanza della classe ChannelFactory<TChannel>.Initializes a new instance of the ChannelFactory<TChannel> class.

ChannelFactory<TChannel>(Binding)

Inizializza una nuova istanza della classe ChannelFactory<TChannel>.Initializes a new instance of the ChannelFactory<TChannel> class.

ChannelFactory<TChannel>(Binding, EndpointAddress)

Consente di inizializzare una nuova istanza della classe ChannelFactory<TChannel> con l'associazione e l'indirizzo endpoint specificati.Initializes a new instance of the ChannelFactory<TChannel> class with a specified binding and endpoint address.

ChannelFactory<TChannel>(Binding, String)

Consente di inizializzare una nuova istanza della classe ChannelFactory<TChannel> con l'associazione e l'indirizzo remoto specificati.Initializes a new instance of the ChannelFactory<TChannel> class with a specified binding and remote address.

ChannelFactory<TChannel>(ServiceEndpoint)

Consente di inizializzare una nuova istanza della classe ChannelFactory<TChannel> che crea canali con l'endpoint specificato.Initializes a new instance of the ChannelFactory<TChannel> class that produces channels with a specified endpoint.

ChannelFactory<TChannel>(String)

Consente di inizializzare una nuova istanza della classe ChannelFactory<TChannel> con il nome della configurazione dell'endpoint specificato.Initializes a new instance of the ChannelFactory<TChannel> class with a specified endpoint configuration name.

ChannelFactory<TChannel>(String, EndpointAddress)

Consente di inizializzare una nuova istanza della classe ChannelFactory<TChannel> associata al nome specificato della configurazione dell'endpoint e dell'indirizzo remoto.Initializes a new instance of the ChannelFactory<TChannel> class associated with a specified name for the endpoint configuration and remote address.

ChannelFactory<TChannel>(Type)

Inizializza una nuova istanza della classe ChannelFactory<TChannel>.Initializes a new instance of the ChannelFactory<TChannel> class.

Proprietà

Credentials

Ottiene le credenziali utilizzate dai client per comunicare con un endpoint del servizio sui canali prodotti dalla factory.Gets the credentials used by clients to communicate a service endpoint over the channels produced by the factory.

(Ereditato da ChannelFactory)
DefaultCloseTimeout

Ottiene l'intervallo di tempo predefinito fornito per il completamento di un'operazione di chiusura.Gets the default interval of time provided for a close operation to complete.

(Ereditato da ChannelFactory)
DefaultOpenTimeout

Ottiene l'intervallo di tempo predefinito fornito per il completamento di un'operazione di apertura.Gets the default interval of time provided for an open operation to complete.

(Ereditato da ChannelFactory)
Endpoint

Ottiene l'endpoint del servizio al quale si connettono i canali prodotti dalla factory.Gets the service endpoint to which the channels produced by the factory connect.

(Ereditato da ChannelFactory)
IsDisposed

Ottiene un valore che indica se l'oggetto di comunicazione è stato eliminato.Gets a value that indicates whether the communication object has been disposed.

(Ereditato da CommunicationObject)
State

Ottiene un valore che indica lo stato corrente dell'oggetto di comunicazione.Gets a value that indicates the current state of the communication object.

(Ereditato da CommunicationObject)
ThisLock

Ottiene il blocco a esclusione reciproca che protegge l'istanza della classe durante una transizione di stato.Gets the mutually exclusive lock that protects the class instance during a state transition.

(Ereditato da CommunicationObject)

Metodi

Abort()

Determina la transizione immediata di un oggetto di comunicazione dallo stato corrente allo stato di chiusura.Causes a communication object to transition immediately from its current state into the closing state.

(Ereditato da CommunicationObject)
ApplyConfiguration(String)

Inizializza la channel factory con i comportamenti forniti da un file di configurazione specificato e con quelli specificati nell'endpoint del servizio della channel factory.Initializes the channel factory with the behaviors provided by a specified configuration file and with those in the service endpoint of the channel factory.

(Ereditato da ChannelFactory)
BeginClose(AsyncCallback, Object)

Consente di iniziare un'operazione asincrona finalizzata a chiudere un oggetto di comunicazione.Begins an asynchronous operation to close a communication object.

(Ereditato da CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

Consente di iniziare un'operazione asincrona finalizzata a chiudere un oggetto di comunicazione entro un determinato intervallo di tempo.Begins an asynchronous operation to close a communication object with a specified timeout.

(Ereditato da CommunicationObject)
BeginOpen(AsyncCallback, Object)

Consente di iniziare un'operazione asincrona finalizzata ad aprire un oggetto di comunicazione.Begins an asynchronous operation to open a communication object.

(Ereditato da CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

Consente di iniziare un'operazione asincrona finalizzata ad aprire un oggetto di comunicazione entro un determinato intervallo di tempo.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Ereditato da CommunicationObject)
Close()

Comporta la transizione di un oggetto di comunicazione dallo stato corrente allo stato di chiusura.Causes a communication object to transition from its current state into the closed state.

(Ereditato da CommunicationObject)
Close(TimeSpan)

Determina la transizione di un oggetto di comunicazione dallo stato corrente allo stato Closed entro un intervallo di tempo specificato.Causes a communication object to transition from its current state into the closed state within a specified interval of time.

(Ereditato da CommunicationObject)
CreateChannel()

Consente di creare un canale di un determinato tipo relativo all'indirizzo endpoint specificato.Creates a channel of a specified type to a specified endpoint address.

CreateChannel(Binding, EndpointAddress)

Consente di creare un canale di un determinato tipo utilizzato per inviare messaggi a un endpoint di servizio configurato con l'associazione specificata.Creates a channel of a specified type that is used to send messages to a service endpoint that is configured with a specified binding.

CreateChannel(Binding, EndpointAddress, Uri)

Consente di creare un canale di un determinato tipo utilizzato per inviare messaggi a un endpoint di servizio presso un dato indirizzo di trasporto configurato con l'associazione specificata.Creates a channel of a specified type that is used to send messages to a service endpoint at a specified transport address that is configured with a specified binding.

CreateChannel(EndpointAddress)

Consente di creare un canale utilizzato per inviare messaggi a un servizio presso un indirizzo endpoint specifico.Creates a channel that is used to send messages to a service at a specific endpoint address.

CreateChannel(EndpointAddress, Uri)

Consente di creare un canale utilizzato per inviare messaggi a un servizio presso un determinato indirizzo endpoint tramite l'indirizzo di trasporto specificato.Creates a channel that is used to send messages to a service at a specific endpoint address through a specified transport address.

CreateChannel(String)

Consente di creare un canale utilizzato per inviare messaggi a un servizio il cui endpoint presenta una configurazione specifica.Creates a channel that is used to send messages to a service whose endpoint is configured in a specified way.

CreateChannelWithActAsToken(SecurityToken)

Consente di creare un canale utilizzato per inviare messaggi a un servizio con un token di sicurezza ActAs.Creates a channel that is used to send messages to a service with an act as security token.

CreateChannelWithActAsToken(SecurityToken, EndpointAddress)

Crea un canale utilizzato per inviare messaggi a un servizio con un token di sicurezza a un determinato indirizzo endpoint.Creates a channel that is used to send messages to a service with an act as security token at a specific endpoint address.

CreateChannelWithActAsToken(SecurityToken, EndpointAddress, Uri)

Crea un canale utilizzato per inviare messaggi a un servizio che funge da token di sicurezza presso un determinato indirizzo endpoint tramite l'indirizzo di trasporto specificato.Creates a channel that is used to send messages to a service with an act as security token at a specific endpoint address through a specified transport address.

CreateChannelWithIssuedToken(SecurityToken)

Consente di creare un canale utilizzato per inviare messaggi a un servizio con un token di sicurezza rilasciato.Creates a channel that is used to send messages to a service with an issued security token.

CreateChannelWithIssuedToken(SecurityToken, EndpointAddress)

Crea un canale utilizzato per inviare messaggi a un servizio con un token di sicurezza emesso a un determinato indirizzo endpoint.Creates a channel that is used to send messages to a service with an issued security token at a specific endpoint address.

CreateChannelWithIssuedToken(SecurityToken, EndpointAddress, Uri)

Crea un canale utilizzato per inviare messaggi a un servizio con un token di sicurezza emesso presso un determinato indirizzo endpoint tramite l'indirizzo di trasporto specificato.Creates a channel that is used to send messages to a service with an issued security token at a specific endpoint address through a specified transport address.

CreateChannelWithOnBehalfOfToken(SecurityToken)

Consente di creare un canale utilizzato per inviare messaggi a un servizio con un token di sicurezza OnBehalfOf.Creates a channel that is used to send messages to a service with an on behalf of security token.

CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress)

Crea un canale utilizzato per inviare messaggi a un servizio con un token di sicurezza OnBehalfOf a un determinato indirizzo endpoint.Creates a channel that is used to send messages to a service with an on behalf of security token at a specific endpoint address.

CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress, Uri)

Crea un canale utilizzato per inviare messaggi a un servizio con un token di sicurezza presso un determinato indirizzo endpoint tramite l'indirizzo di trasporto specificato.Creates a channel that is used to send messages to a service with an on behalf of security token at a specific endpoint address through a specified transport address.

CreateDescription()

Consente di creare una descrizione dell'endpoint di servizio.Creates a description of the service endpoint.

CreateFactory()

Compila la channel factory per l'endpoint corrente della factory.Builds the channel factory for the current endpoint of the factory.

(Ereditato da ChannelFactory)
EndClose(IAsyncResult)

Consente di completare un'operazione asincrona finalizzata a chiudere un oggetto di comunicazione.Completes an asynchronous operation to close a communication object.

(Ereditato da CommunicationObject)
EndOpen(IAsyncResult)

Consente di completare un'operazione asincrona finalizzata ad aprire un oggetto di comunicazione.Completes an asynchronous operation to open a communication object.

(Ereditato da CommunicationObject)
EnsureOpened()

Apre la channel factory corrente se non è ancora aperta.Opens the current channel factory if it is not yet opened.

(Ereditato da ChannelFactory)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Fault()

Determina la transizione di un oggetto di comunicazione dallo stato corrente allo stato Faulted.Causes a communication object to transition from its current state into the faulted state.

(Ereditato da CommunicationObject)
GetCommunicationObjectType()

Ottiene il tipo di oggetto di comunicazione.Gets the type of communication object.

(Ereditato da CommunicationObject)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetProperty<T>()

Se presente, restituisce l'oggetto tipizzato richiesto dal livello appropriato nello stack dei canali; se non è presente, restituisce null.Returns the typed object requested, if present, from the appropriate layer in the channel stack, or null if not present.

(Ereditato da ChannelFactory)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeEndpoint(Binding, EndpointAddress)

Inizializza l'endpoint del servizio della channel factory con un'associazione e un indirizzo specificati.Initializes the service endpoint of the channel factory with a specified binding and address.

(Ereditato da ChannelFactory)
InitializeEndpoint(ServiceEndpoint)

Inizializza l'endpoint del servizio della channel factory con un endpoint sepcificato.Initializes the service endpoint of the channel factory with a specified endpoint.

(Ereditato da ChannelFactory)
InitializeEndpoint(String, EndpointAddress)

Inizializza l'endpoint del servizio della channel factory con un indirizzo e una configurazione specificati.Initializes the service endpoint of the channel factory with a specified address and configuration.

(Ereditato da ChannelFactory)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnAbort()

Termina la channel factory interna della channel factory corrente.Terminates the inner channel factory of the current channel factory.

(Ereditato da ChannelFactory)
OnBeginClose(TimeSpan, AsyncCallback, Object)

Consente di avviare un'operazione di chiusura asincrona sulla channel factory interna della channel factory corrente a cui è associato un oggetto di stato.Begins an asynchronous close operation on the inner channel factory of the current channel factory that has a state object associated with it.

(Ereditato da ChannelFactory)
OnBeginOpen(TimeSpan, AsyncCallback, Object)

Consente di avviare un'operazione di apertura asincrona sulla channel factory interna della channel factory corrente a cui è associato un oggetto di stato.Begins an asynchronous open operation on the inner channel factory of the current channel factory that has a state object associated with it.

(Ereditato da ChannelFactory)
OnClose(TimeSpan)

Chiama la chiusura sulla channel factory interna con un timeout specificato per il completamento dell'operazione.Calls close on the inner channel factory with a specified time-out for the completion of the operation.

(Ereditato da ChannelFactory)
OnClosed()

Viene chiamato durante la transizione di un oggetto di comunicazione allo stato di chiusura.Invoked during the transition of a communication object into the closing state.

(Ereditato da CommunicationObject)
OnClosing()

Viene chiamato durante la transizione di un oggetto di comunicazione allo stato di chiusura.Invoked during the transition of a communication object into the closing state.

(Ereditato da CommunicationObject)
OnEndClose(IAsyncResult)

Completa un'operazione di chiusura asincrona sulla channel factory interna della channel factory corrente.Completes an asynchronous close operation on the inner channel factory of the current channel factory.

(Ereditato da ChannelFactory)
OnEndOpen(IAsyncResult)

Completa un'operazione di apertura asincrona sulla channel factory interna della channel factory corrente.Completes an asynchronous open operation on the inner channel factory of the current channel factory.

(Ereditato da ChannelFactory)
OnFaulted()

Inserisce l'elaborazione in un oggetto di comunicazione dopo che ha eseguito la transizione allo stato Faulted in seguito alla chiamata di un'operazione di errore sincrona.Inserts processing on a communication object after it transitions to the faulted state due to the invocation of a synchronous fault operation.

(Ereditato da CommunicationObject)
OnOpen(TimeSpan)

Chiama l'apertura sulla channel factory interna della channel factory corrente con un timeout specificato per il completamento dell'operazione.Calls open on the inner channel factory of the current channel factory with a specified time-out for the completion of the operation.

(Ereditato da ChannelFactory)
OnOpened()

Inizializza una copia di sola lettura dell'oggetto ClientCredentials per la channel factory.Initializes a read-only copy of the ClientCredentials object for the channel factory.

(Ereditato da ChannelFactory)
OnOpening()

Compila la channel factory interna per il canale corrente.Builds the inner channel factory for the current channel.

(Ereditato da ChannelFactory)
Open()

Comporta la transizione di un oggetto di comunicazione dallo stato di creazione allo stato di apertura.Causes a communication object to transition from the created state into the opened state.

(Ereditato da CommunicationObject)
Open(TimeSpan)

Comporta la transizione di un oggetto di comunicazione dallo stato di creazione allo stato di apertura entro un determinato intervallo di tempo.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Ereditato da CommunicationObject)
ThrowIfDisposed()

Se l'oggetto di comunicazione è stato eliminato, genera un'eccezione.Throws an exception if the communication object is disposed.

(Ereditato da CommunicationObject)
ThrowIfDisposedOrImmutable()

Se la proprietà State dell'oggetto di comunicazione non è impostata su Created, genera un'eccezione.Throws an exception if the communication object the State property is not set to the Created state.

(Ereditato da CommunicationObject)
ThrowIfDisposedOrNotOpen()

Se l'oggetto di comunicazione non si trova nello stato Opened, genera un'eccezione.Throws an exception if the communication object is not in the Opened state.

(Ereditato da CommunicationObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Eventi

Closed

Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Closed.Occurs when a communication object transitions into the closed state.

(Ereditato da CommunicationObject)
Closing

Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Closing.Occurs when a communication object transitions into the closing state.

(Ereditato da CommunicationObject)
Faulted

Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Faulted.Occurs when a communication object transitions into the faulted state.

(Ereditato da CommunicationObject)
Opened

Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Opened.Occurs when a communication object transitions into the opened state.

(Ereditato da CommunicationObject)
Opening

Si verifica quando un oggetto di comunicazione esegue la transizione allo stato Opening.Occurs when a communication object transitions into the opening state.

(Ereditato da CommunicationObject)

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose()

Chiude la channel factory corrente.Closes the current channel factory.

(Ereditato da ChannelFactory)

Si applica a

Thread safety

Questo tipo è thread-safe.This type is thread safe.