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 di canali.
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- Derivato
- Implementazioni
Commenti
Important
La chiamata di metodi da classi che implementano questa interfaccia con dati non attendibili è un rischio per la sicurezza. Chiamare i metodi dalle 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 l'oggetto
GetProperty metodo per l'interfaccia ICommunicationObject . Questo metodo fornisce un meccanismo per il recupero delle proprietà dallo stack di canali indipendentemente dalla posizione in cui si trovano tali proprietà nello stack. Il termine "property" nel nome del metodo fa riferimento a una parte di informazioni che appartiene a uno dei canali nello stack. Il tipo CLR per tale proprietà è determinato da T. Questo metodo di recupero viene usato anche nelle channel factory e nei listener di canale.
IChannel viene ereditato da ognuna delle interfacce del canale associate ai modelli di scambio di messaggi di base:
IInputChannel per la ricezione di 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à
| Nome | Descrizione |
|---|---|
| State |
Ottiene lo stato corrente dell'oggetto orientato alla comunicazione. (Ereditato da ICommunicationObject) |
Metodi
| Nome | Descrizione |
|---|---|
| Abort() |
Fa sì che un oggetto di comunicazione passi immediatamente dallo stato corrente allo stato chiuso. (Ereditato da ICommunicationObject) |
| BeginClose(AsyncCallback, Object) |
Avvia un'operazione asincrona per chiudere un oggetto di comunicazione. (Ereditato da ICommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Avvia un'operazione asincrona per chiudere un oggetto di comunicazione con un timeout specificato. (Ereditato da ICommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Avvia un'operazione asincrona per aprire un oggetto di comunicazione. (Ereditato da ICommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Avvia un'operazione asincrona per aprire un oggetto di comunicazione entro un intervallo di tempo specificato. (Ereditato da ICommunicationObject) |
| Close() |
Fa sì che un oggetto di comunicazione passi dallo stato corrente allo stato chiuso. (Ereditato da ICommunicationObject) |
| Close(TimeSpan) |
Fa sì che un oggetto di comunicazione passi dallo stato corrente allo stato chiuso. (Ereditato da ICommunicationObject) |
| EndClose(IAsyncResult) |
Completa un'operazione asincrona per chiudere un oggetto di comunicazione. (Ereditato da ICommunicationObject) |
| EndOpen(IAsyncResult) |
Completa un'operazione asincrona per aprire un oggetto di comunicazione. (Ereditato da ICommunicationObject) |
| GetProperty<T>() |
Restituisce un oggetto tipizzato richiesto, se presente, dal livello appropriato nello stack di canali. |
| Open() |
Fa sì che un oggetto di comunicazione passi dallo stato creato allo stato aperto. (Ereditato da ICommunicationObject) |
| Open(TimeSpan) |
Fa sì che un oggetto di comunicazione passi dallo stato creato allo stato aperto entro un intervallo di tempo specificato. (Ereditato da ICommunicationObject) |
Eventi
| Nome | Descrizione |
|---|---|
| Closed |
Si verifica quando l'oggetto di comunicazione completa la transizione dallo stato di chiusura allo stato chiuso. (Ereditato da ICommunicationObject) |
| Closing |
Si verifica quando l'oggetto di comunicazione entra per la prima volta nello stato di chiusura. (Ereditato da ICommunicationObject) |
| Faulted |
Si verifica quando l'oggetto di comunicazione entra per la prima volta nello stato di errore. (Ereditato da ICommunicationObject) |
| Opened |
Si verifica quando l'oggetto di comunicazione completa la transizione dallo stato di apertura allo stato aperto. (Ereditato da ICommunicationObject) |
| Opening |
Si verifica quando l'oggetto di comunicazione entra per la prima volta nello stato di apertura. (Ereditato da ICommunicationObject) |