IChannel Interfaccia

Definizione

Spazio dei nomi:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v6.2.0

Source:

IChannel.cs

Definisce l'interfaccia di base che tutti gli oggetti canale devono implementare. Richiede che implementino l'interfaccia della macchina a stati condivisa da tutti gli oggetti di comunicazione e che implementino un metodo per recuperare oggetti dallo stack dei canali.

public interface class IChannel : System::ServiceModel::ICommunicationObject

public interface IChannel : System.ServiceModel.ICommunicationObject

type IChannel = interface
    interface ICommunicationObject

Public Interface IChannel
Implements ICommunicationObject

Derivato

System.ServiceModel.Channels.ChannelBase

System.ServiceModel.Channels.IAsyncInputChannel

System.ServiceModel.Channels.IAsyncOutputChannel

System.ServiceModel.Channels.IAsyncOutputSessionChannel

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputChannel

System.ServiceModel.Channels.IInputSessionChannel

System.ServiceModel.Channels.IOutputChannel

System.ServiceModel.Channels.IOutputSessionChannel

System.ServiceModel.Channels.IReplyChannel

System.ServiceModel.Channels.IReplySessionChannel

System.ServiceModel.Channels.IRequestChannel

System.ServiceModel.Channels.IRequestSessionChannel

System.ServiceModel.Channels.OutputChannel

System.ServiceModel.Channels.ServiceChannelProxy

System.ServiceModel.ClientBase<TChannel>.ChannelBase<T>

System.ServiceModel.Federation.WSTrustChannel

System.ServiceModel.IClientChannel

System.ServiceModel.IContextChannel

System.ServiceModel.IDuplexContextChannel

System.ServiceModel.IServiceChannel

System.ServiceModel.Security.WSTrustChannel

Implementazioni

ICommunicationObject

Commenti

Importante

La chiamata a metodi da classi che implementano questa interfaccia con dati non attendibili costituisce un rischio per la sicurezza. Chiamare i metodi da classi che implementano questa interfaccia solo con dati attendibili. Per altre informazioni, vedere Convalidare tutti gli input.

I canali devono soddisfare il contratto di una macchina a stati come definito dall'interfaccia ICommunicationObject.

L'interfaccia IChannel aggiunge il metodo

GetProperty per l'interfaccia ICommunicationObject . Questo metodo fornisce un meccanismo per il recupero di proprietà dallo stack dei canali indipendentemente dal punto dello stack in cui risiedono. Il termine "proprietà" nel nome del metodo si riferisce alle informazioni che appartengono a uno dei canali dello stack. Il tipo CLR per quella proprietà è determinato da T. Questo metodo di recupero è utilizzato anche nelle channel factory e nei listener del canale.

IChannel viene ereditato da ognuna delle interfacce del canale associate ai modelli di scambio di messaggi di base:

• IInputChannel per la ricezione dei messaggi.

• IOutputChannel per l'invio di messaggi.

• IRequestChannel per l'invio di una richiesta.

• IReplyChannel per l'invio di una risposta.

• IDuplexChannel per la messaggistica bidirezionale.

Proprietà

State

Ottiene lo stato corrente dell'oggetto orientato alla comunicazione. (Ereditato da ICommunicationObject)

Metodi

Abort()	Comporta la transizione immediata di un oggetto di comunicazione dallo stato corrente allo stato di chiusura. (Ereditato da ICommunicationObject)
BeginClose(AsyncCallback, Object)	Consente di iniziare un'operazione asincrona finalizzata a chiudere un oggetto di comunicazione. (Ereditato da ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Consente di iniziare un'operazione asincrona finalizzata a chiudere un oggetto di comunicazione entro un determinato intervallo di tempo. (Ereditato da ICommunicationObject)
BeginOpen(AsyncCallback, Object)	Consente di iniziare un'operazione asincrona finalizzata ad aprire un oggetto di comunicazione. (Ereditato da ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Consente di iniziare un'operazione asincrona finalizzata ad aprire un oggetto di comunicazione entro un determinato intervallo di tempo. (Ereditato da ICommunicationObject)
Close()	Comporta la transizione di un oggetto di comunicazione dallo stato corrente allo stato di chiusura. (Ereditato da ICommunicationObject)
Close(TimeSpan)	Comporta la transizione di un oggetto di comunicazione dallo stato corrente allo stato di chiusura. (Ereditato da ICommunicationObject)
EndClose(IAsyncResult)	Consente di completare un'operazione asincrona finalizzata a chiudere un oggetto di comunicazione. (Ereditato da ICommunicationObject)
EndOpen(IAsyncResult)	Consente di completare un'operazione asincrona finalizzata ad aprire un oggetto di comunicazione. (Ereditato da ICommunicationObject)
GetProperty<T>()	Se presente, restituisce un oggetto tipizzato richiesto dal livello appropriato nello stack dei canali.
Open()	Comporta la transizione di un oggetto di comunicazione dallo stato di creazione allo stato di apertura. (Ereditato da ICommunicationObject)
Open(TimeSpan)	Comporta la transizione di un oggetto di comunicazione dallo stato di creazione allo stato di apertura entro un determinato intervallo di tempo. (Ereditato da ICommunicationObject)

Eventi

Closed	Si verifica quando l'oggetto di comunicazione completa la transizione dallo stato di pre-chiusura allo stato di chiusura. (Ereditato da ICommunicationObject)
Closing	Si verifica quando l'oggetto di comunicazione passa per la prima volta allo stato di pre-chiusura. (Ereditato da ICommunicationObject)
Faulted	Si verifica quando l'oggetto di comunicazione passa per la prima volta allo stato di errore. (Ereditato da ICommunicationObject)
Opened	Si verifica quando l'oggetto di comunicazione completa la transizione dallo stato di pre-apertura allo stato di apertura. (Ereditato da ICommunicationObject)
Opening	Si verifica quando l'oggetto di comunicazione passa per la prima volta allo stato di pre-apertura. (Ereditato da ICommunicationObject)

Metodi di estensione

CloseHelperAsync(ICommunicationObject, TimeSpan)	Definisce l'interfaccia di base che tutti gli oggetti canale devono implementare. Richiede che implementino l'interfaccia della macchina a stati condivisa da tutti gli oggetti di comunicazione e che implementino un metodo per recuperare oggetti dallo stack dei canali.
OpenHelperAsync(ICommunicationObject, TimeSpan)	Definisce l'interfaccia di base che tutti gli oggetti canale devono implementare. Richiede che implementino l'interfaccia della macchina a stati condivisa da tutti gli oggetti di comunicazione e che implementino un metodo per recuperare oggetti dallo stack dei canali.