StreamUpgradeProvider Classe
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.
Implementa un provider di aggiornamento personalizzato, ereditato da questa abstract classe di base.
public ref class StreamUpgradeProvider abstract : System::ServiceModel::Channels::CommunicationObject
public abstract class StreamUpgradeProvider : System.ServiceModel.Channels.CommunicationObject
type StreamUpgradeProvider = class
inherit CommunicationObject
Public MustInherit Class StreamUpgradeProvider
Inherits CommunicationObject
- Ereditarietà
- Derivato
Commenti
Un esempio di aggiornamento del flusso consiste nel creare un flusso di compressione direttamente sopra il flusso di trasporto. Per aggiungere un aggiornamento della sicurezza, è anche necessario implementare una classe che deriva da StreamSecurityUpgradeProvider. È possibile implementare più aggiornamenti, ognuno dei quali esegue il wrapping di quello precedente.
Il processo di aggiornamento prevede i passaggi seguenti:
Implementare una classe che deriva da StreamUpgradeProvider.
Registrarlo. A tale scopo, creare un elemento di associazione e registrare il provider in un'associazione personalizzata.
La classe derivata implementata crea un'istanza di , che in fase di StreamUpgradeInitiatoresecuzione avvia una richiesta all'altra estremità della connessione per aggiornare il livello di trasporto del canale.
La classe derivata implementata crea un'istanza di , che in fase di StreamUpgradeAcceptoresecuzione riceve la richiesta di aggiornamento dal passaggio precedente e, se possibile, accetta l'aggiornamento e restituisce il flusso aggiornato all'altro lato della connessione.
Se sono presenti richieste di aggiornamento aggiuntive, vengono elaborate in sequenza, come descritto nei due passaggi precedenti.
Costruttori
| Nome | Descrizione |
|---|---|
| StreamUpgradeProvider() |
Inizializza una nuova istanza della classe StreamUpgradeProvider. |
| StreamUpgradeProvider(IDefaultCommunicationTimeouts) |
Inizializza una nuova istanza della classe StreamUpgradeProvider. |
Proprietà
| Nome | Descrizione |
|---|---|
| DefaultCloseTimeout |
Ottiene defaultCloseTimeout. |
| DefaultOpenTimeout |
Ottiene l'oggetto DefaultOpenTimeout. |
| IsDisposed |
Ottiene un valore che indica se l'oggetto di comunicazione è stato eliminato. (Ereditato da CommunicationObject) |
| State |
Ottiene un valore che indica lo stato corrente dell'oggetto di comunicazione. (Ereditato da CommunicationObject) |
| ThisLock |
Ottiene il blocco che protegge l'istanza della classe durante una transizione di stato. (Ereditato da CommunicationObject) |
Metodi
| Nome | Descrizione |
|---|---|
| Abort() |
Fa sì che un oggetto di comunicazione passi immediatamente dallo stato corrente allo stato di chiusura. (Ereditato da CommunicationObject) |
| BeginClose(AsyncCallback, Object) |
Avvia un'operazione asincrona per chiudere un oggetto di comunicazione. (Ereditato da CommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Avvia un'operazione asincrona per chiudere un oggetto di comunicazione con un timeout specificato. (Ereditato da CommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Avvia un'operazione asincrona per aprire un oggetto di comunicazione. (Ereditato da CommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Avvia un'operazione asincrona per aprire un oggetto di comunicazione entro un intervallo di tempo specificato. (Ereditato da CommunicationObject) |
| Close() |
Fa sì che un oggetto di comunicazione passi dallo stato corrente allo stato chiuso. (Ereditato da CommunicationObject) |
| Close(TimeSpan) |
Fa sì che un oggetto di comunicazione passi dallo stato corrente allo stato chiuso entro un intervallo di tempo specificato. (Ereditato da CommunicationObject) |
| CreateUpgradeAcceptor() |
Crea un'istanza di StreamUpgradeAcceptor. |
| CreateUpgradeInitiator(EndpointAddress, Uri) |
Crea un'istanza di StreamUpgradeInitiator. |
| EndClose(IAsyncResult) |
Completa un'operazione asincrona per chiudere un oggetto di comunicazione. (Ereditato da CommunicationObject) |
| EndOpen(IAsyncResult) |
Completa un'operazione asincrona per aprire un oggetto di comunicazione. (Ereditato da CommunicationObject) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| Fault() |
Fa sì che un oggetto di comunicazione passi dallo stato corrente allo stato di errore. (Ereditato da CommunicationObject) |
| GetCommunicationObjectType() |
Ottiene il tipo di oggetto di comunicazione. (Ereditato da CommunicationObject) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetProperty<T>() |
Se implementato in una classe derivata, ottiene una proprietà del flusso corrente che rappresenta un iniziatore di un aggiornamento del flusso. |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnAbort() |
Inserisce l'elaborazione su un oggetto di comunicazione dopo la transizione allo stato di chiusura a causa della chiamata di un'operazione di interruzione sincrona. (Ereditato da CommunicationObject) |
| OnBeginClose(TimeSpan, AsyncCallback, Object) |
Inserisce l'elaborazione dopo che un oggetto di comunicazione passa allo stato di chiusura a causa della chiamata di un'operazione di chiusura asincrona. (Ereditato da CommunicationObject) |
| OnBeginOpen(TimeSpan, AsyncCallback, Object) |
Inserisce l'elaborazione in un oggetto di comunicazione dopo la transizione allo stato di apertura a causa della chiamata di un'operazione di apertura asincrona. (Ereditato da CommunicationObject) |
| OnClose(TimeSpan) |
Inserisce l'elaborazione su un oggetto di comunicazione dopo la transizione allo stato di chiusura a causa della chiamata di un'operazione di chiusura sincrona. (Ereditato da CommunicationObject) |
| OnClosed() |
Richiamato durante la transizione di un oggetto di comunicazione nello stato di chiusura. (Ereditato da CommunicationObject) |
| OnClosing() |
Richiamato durante la transizione di un oggetto di comunicazione nello stato di chiusura. (Ereditato da CommunicationObject) |
| OnEndClose(IAsyncResult) |
Completa un'operazione asincrona sulla chiusura di un oggetto di comunicazione. (Ereditato da CommunicationObject) |
| OnEndOpen(IAsyncResult) |
Completa un'operazione asincrona all'apertura di un oggetto di comunicazione. (Ereditato da CommunicationObject) |
| OnFaulted() |
Inserisce l'elaborazione in un oggetto di comunicazione dopo la transizione allo stato di errore a causa della chiamata di un'operazione di errore sincrono. (Ereditato da CommunicationObject) |
| OnOpen(TimeSpan) |
Inserisce l'elaborazione in un oggetto di comunicazione dopo la transizione allo stato di apertura che deve essere completata entro un intervallo di tempo specificato. (Ereditato da CommunicationObject) |
| OnOpened() |
Richiamato durante la transizione di un oggetto di comunicazione nello stato aperto. (Ereditato da CommunicationObject) |
| OnOpening() |
Richiamato durante la transizione di un oggetto di comunicazione nello stato di apertura. (Ereditato da CommunicationObject) |
| Open() |
Fa sì che un oggetto di comunicazione passi dallo stato creato allo stato aperto. (Ereditato da CommunicationObject) |
| Open(TimeSpan) |
Fa sì che un oggetto di comunicazione passi dallo stato creato allo stato aperto entro un intervallo di tempo specificato. (Ereditato da CommunicationObject) |
| ThrowIfDisposed() |
Genera un'eccezione se l'oggetto di comunicazione viene eliminato. (Ereditato da CommunicationObject) |
| ThrowIfDisposedOrImmutable() |
Genera un'eccezione se l'oggetto di comunicazione la State proprietà non è impostata sullo Created stato . (Ereditato da CommunicationObject) |
| ThrowIfDisposedOrNotOpen() |
Genera un'eccezione se l'oggetto di comunicazione non è nello Opened stato . (Ereditato da CommunicationObject) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Eventi
| Nome | Descrizione |
|---|---|
| Closed |
Si verifica quando un oggetto di comunicazione passa allo stato chiuso. (Ereditato da CommunicationObject) |
| Closing |
Si verifica quando un oggetto di comunicazione passa allo stato di chiusura. (Ereditato da CommunicationObject) |
| Faulted |
Si verifica quando un oggetto di comunicazione passa allo stato di errore. (Ereditato da CommunicationObject) |
| Opened |
Si verifica quando un oggetto di comunicazione passa allo stato aperto. (Ereditato da CommunicationObject) |
| Opening |
Si verifica quando un oggetto di comunicazione passa allo stato di apertura. (Ereditato da CommunicationObject) |