IInputChannel Interfaccia

Definizione

Definisce l'interfaccia che un canale deve implementare per ricevere un messaggio.Defines the interface that a channel must implement to receive a message.

public interface class IInputChannel : System::ServiceModel::Channels::IChannel
public interface IInputChannel : System.ServiceModel.Channels.IChannel
type IInputChannel = interface
    interface IChannel
    interface ICommunicationObject
Public Interface IInputChannel
Implements IChannel
Derivato
Implementazioni

Commenti

Importante

La chiamata a metodi da classi che implementano questa interfaccia con dati non attendibili costituisce un rischio per la sicurezza.Calling methods from classes that implement this interface with untrusted data is a security risk. Chiamare i metodi da classi che implementano questa interfaccia solo con dati attendibili.Call the methods from classes that implement this interface only with trusted data. Per altre informazioni, vedere Data Validation (Convalida dei dati).For more information, see Data Validation.

Il contratto IInputChannel include varianti sincrone e asincrone della funzionalità di ricezione, tentativo di ricezione e attesa di un messaggio.The IInputChannel contract includes synchronous and asynchronous variants of receive, try-to-receive and wait-for-a-message functionality.

Il modello pull viene usato in genere con IInputChannel per ricevere messaggi: viene chiamato Receive (per "effettuare il pull" di un messaggio dal canale) e quindi si attende l'arrivo di un messaggio.The pull model is used typically with an IInputChannel to receive messages: you call Receive (to "pull" a message out of the channel) and then wait for a message to arrive. Un modello di utilizzo alternativo consiste nel chiamare BeginWaitForMessage(TimeSpan, AsyncCallback, Object) o BeginWaitForMessage(TimeSpan, AsyncCallback, Object) e quindi Receive(TimeSpan).An alternative usage pattern is to call BeginWaitForMessage(TimeSpan, AsyncCallback, Object) or BeginWaitForMessage(TimeSpan, AsyncCallback, Object), and then call Receive(TimeSpan). Questo approccio è comune per gli utilizzi transazionali in cui viene avviata la transazione tra le chiamate a WaitForMessage(TimeSpan) e Receive.This approach is common for transactional usages where you start the transaction between the calls to WaitForMessage(TimeSpan) and Receive.

Un'interfaccia IInputChannel non è associata necessariamente a un solo mittente.An IInputChannel is not necessarily bound to a single sender. Altri canali e interfacce di canale possono fornire una correlazione tra specifici mittenti e IInputChannel, ma il contratto di base non implica tale restrizione.Other channels and channel interfaces can provide a correlation between particular senders and an IInputChannel, but the base contract makes no such restriction. Un'implementazione può creare un nuovo IInputChannel per ogni messaggio o può riutilizzare stesso IInputChannel per più messaggi e mittenti.An implementation can create a new IInputChannel for each message or reuse the same IInputChannel for multiple messages and senders.

Proprietà

LocalAddress

Ottiene l'indirizzo sul quale il canale di input riceve i messaggi.Gets the address on which the input channel receives messages.

State

Ottiene lo stato corrente dell'oggetto orientato alla comunicazione.Gets the current state of the communication-oriented object.

(Ereditato da ICommunicationObject)

Metodi

Abort()

Comporta 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 closed state.

(Ereditato da ICommunicationObject)
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 ICommunicationObject)
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 ICommunicationObject)
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 ICommunicationObject)
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 ICommunicationObject)
BeginReceive(AsyncCallback, Object)

Inizia un'operazione asincrona per ricevere un messaggio al quale è associato un oggetto di stato.Begins an asynchronous operation to receive a message that has a state object associated with it.

BeginReceive(TimeSpan, AsyncCallback, Object)

Avvia un'operazione asincrona per ricevere un messaggio al quale sono associati un timeout e un oggetto di stato specificati.Begins an asynchronous operation to receive a message that has a specified time out and state object associated with it.

BeginTryReceive(TimeSpan, AsyncCallback, Object)

Avvia un'operazione asincrona per ricevere un messaggio al quale sono associati un timeout e un oggetto di stato specificati.Begins an asynchronous operation to receive a message that has a specified time out and state object associated with it.

BeginWaitForMessage(TimeSpan, AsyncCallback, Object)

Avvia un'operazione asincrona di attesa dell'arrivo di un messaggio al quale sono associati un timeout e un oggetto di stato specificati.Begins an asynchronous wait-for-a-message-to-arrive operation that has a specified time out and state object associated with it.

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 ICommunicationObject)
Close(TimeSpan)

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 ICommunicationObject)
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 ICommunicationObject)
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 ICommunicationObject)
EndReceive(IAsyncResult)

Completa un'operazione asincrona per ricevere un messaggio.Completes an asynchronous operation to receive a message.

EndTryReceive(IAsyncResult, Message)

Completa l'operazione asincrona specificata per ricevere un messaggio.Completes the specified asynchronous operation to receive a message.

EndWaitForMessage(IAsyncResult)

Completa l'operazione asincrona specificata di attesa di un messaggio.Completes the specified asynchronous wait-for-a-message operation.

GetProperty<T>()

Se presente, restituisce un oggetto tipizzato richiesto dal livello appropriato nello stack dei canali.Returns a typed object requested, if present, from the appropriate layer in the channel stack.

(Ereditato da IChannel)
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 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.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Ereditato da ICommunicationObject)
Receive()

Se disponibile, restituisce il messaggio ricevuto.Returns the message received, if one is available. Se un messaggio non è disponibile, il thread si blocca per un intervallo di tempo predefinito.If a message is not available, blocks for a default interval of time.

Receive(TimeSpan)

Se disponibile, restituisce il messaggio ricevuto.Returns the message received, if one is available. Se un messaggio non è disponibile, il thread si blocca per l'intervallo di tempo specificato.If a message is not available, blocks for a specified interval of time.

TryReceive(TimeSpan, Message)

Tenta di ricevere un messaggio entro l'intervallo di tempo specificato.Tries to receive a message within a specified interval of time.

WaitForMessage(TimeSpan)

Restituisce un valore che indica se un messaggio è arrivato entro l'intervallo di tempo specificato.Returns a value that indicates whether a message has arrived within a specified interval of time.

Eventi

Closed

Si verifica quando l'oggetto di comunicazione completa la transizione dallo stato di pre-chiusura allo stato di chiusura.Occurs when the communication object completes its transition from the closing state into the closed state.

(Ereditato da ICommunicationObject)
Closing

Si verifica quando l'oggetto di comunicazione passa per la prima volta allo stato di pre-chiusura.Occurs when the communication object first enters the closing state.

(Ereditato da ICommunicationObject)
Faulted

Si verifica quando l'oggetto di comunicazione passa per la prima volta allo stato di errore.Occurs when the communication object first enters the faulted state.

(Ereditato da ICommunicationObject)
Opened

Si verifica quando l'oggetto di comunicazione completa la transizione dallo stato di pre-apertura allo stato di apertura.Occurs when the communication object completes its transition from the opening state into the opened state.

(Ereditato da ICommunicationObject)
Opening

Si verifica quando l'oggetto di comunicazione passa per la prima volta allo stato di pre-apertura.Occurs when the communication object first enters the opening state.

(Ereditato da ICommunicationObject)

Si applica a