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 WebClient.OpenWriteTaskAsync (Uri, String)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona mediante un oggetto di attività.

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

[ComVisibleAttribute(false)]
[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public Task<Stream> OpenWriteTaskAsync(
	Uri address,
	string method
)

Parametri

address
Type: System.Uri

L'URI della risorsa per ricevere i dati.

method
Type: System.String

Il metodo utilizzato per inviare i dati alla risorsa. Se null, il valore predefinito è POST per http e la archivia per ftp.

Valore restituito

Type: System.Threading.Tasks.Task<Stream>

Restituisce Task<TResult>.

Oggetto dell'attività che rappresenta l'operazione asincrona. Il Result proprietà nell'oggetto attività restituisce un Stream utilizzato per scrivere dati nella risorsa.

Exception Condition
ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI formato dalla combinazione BaseAddress e address non è valido.

-oppure-

Si è verificato un errore durante l'apertura del flusso.

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> oggetto verrà completata dopo l'un flusso scrivibile per la risorsa di dati è stata aperta. Questo metodo non blocca il thread chiamante durante l'apertura del flusso.

Questo metodo recupera un Stream utilizzato per scrivere i dati alla risorsa specificata dall'istanza di address parametro. Il flusso viene ottenuto utilizzando le risorse thread allocate automaticamente dal pool di thread.

System_CAPS_noteNota

È necessario chiamare Stream.Close quando si è finito con il Stream per evitare di esaurire le risorse di sistema.

Se il method parametro specifica un metodo che non è accettato dal server, le classi del protocollo sottostante determineranno quello che accade. In genere, un WebException viene generata un'eccezione con il Status impostata per indicare l'errore.

Operazioni asincrone che non sono state completate possono essere annullate utilizzando il CancelAsync metodo.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo viene combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.

Questo metodo utilizza il comando Archivia per caricare una risorsa FTP. Per una risorsa HTTP viene utilizzato il metodo POST.

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 4.5
Torna all'inizio
Mostra: