Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo HttpWebRequest.GetRequestStream (TransportContext)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Ottiene un oggetto Stream da usare per scrivere i dati della richiesta e restituisce l'oggetto TransportContext associato al flusso.

Spazio dei nomi:   System.Net
Assembly:  System (in System.dll)

public Stream GetRequestStream(
	out TransportContext context
)

Parametri

context
Type: System.Net.TransportContext

Oggetto TransportContext per l'oggetto Stream.

Valore restituito

Type: System.IO.Stream

Oggetto Stream da usare per scrivere i dati della richiesta.

Exception Condition
Exception

Il metodo GetRequestStream non è riuscito a ottenere l'oggetto Stream.

InvalidOperationException

Il metodo GetRequestStream viene chiamato più volte.

-oppure-

TransferEncoding è impostato su un valore e SendChunked è false.

NotSupportedException

Il validator della cache delle richieste ha indicato che la risposta per questa richiesta può essere fornita dalla cache, ma le richieste che scrivono dati non usano la cache. Questa eccezione può verificarsi se si usa un validator della cache personalizzato che è implementato in modo non corretto.

ProtocolViolationException

La proprietà Method è GET o HEAD.

-oppure-

KeepAlive è true, AllowWriteStreamBuffering è false, ContentLength è -1, SendChunked è false e Method è POST o PUT.

WebException

Abort è stato chiamato in precedenza.

-oppure-

Il periodo di timeout per la richiesta è scaduto.

-oppure-

Si è verificato un errore durante l'elaborazione della richiesta.

Il GetRequestStream metodo restituisce un flusso da utilizzare per inviare dati per il HttpWebRequest e restituisce il TransportContext associato al flusso. Dopo il Stream ha restituito oggetto, è possibile inviare i dati con il HttpWebRequest utilizzando il Stream.Write metodo.

Potrebbe essere necessario essere in grado di eseguire una query sul livello di trasporto utilizzato da alcune applicazioni che utilizzano l'autenticazione integrata di Windows con protezione estesa HttpWebRequest per recuperare il token di associazione di canale (CBT) dal canale TLS sottostante. Il GetRequestStream metodo fornisce l'accesso a queste informazioni per i metodi HTTP che hanno un corpo della richiesta (POST e PUT richieste). Questo è necessario solo se l'applicazione sta implementando l'autenticazione e deve avere accesso a CBT.

Se è necessario impostare il valore di un'applicazione di ContentLength proprietà, tale operazione deve essere eseguita prima del recupero del flusso.

È necessario chiamare il Stream.Close metodo per chiudere il flusso e rilasciare la connessione per il riutilizzo. Errore di chiudere il flusso causa l'applicazione di esaurire le connessioni.

System_CAPS_noteNota

L'applicazione è possibile combinare metodi sincroni e asincroni per una particolare richiesta. Se si chiama il GetRequestStream (metodo), è necessario utilizzare il GetResponse metodo per recuperare la risposta.

System_CAPS_noteNota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Tracciatura di rete in .NET Framework.

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: