IChannel Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
- Implementazioni
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) |