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

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Carica la stringa specificata per la risorsa specificata come un'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<string> UploadStringTaskAsync(
	Uri address,
	string method,
	string data
)

Parametri

address
Type: System.Uri

L'URI della risorsa per ricevere la stringa. Per le risorse HTTP, l'URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.

method
Type: System.String

Il metodo HTTP utilizzato per inviare il file della risorsa. Se null, il valore predefinito è POST per http e la archivia per ftp.

data
Type: System.String

La stringa da caricare.

Valore restituito

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

Restituisce Task<TResult>.

Oggetto dell'attività che rappresenta l'operazione asincrona. Il Result proprietà nell'oggetto attività restituisce un String contenente la risposta inviata dal server.

Exception Condition
ArgumentNullException

data è null.

ArgumentNullException

Il valore del parametro address è null.

-oppure-

Il valore del parametro data è null.

WebException

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

-oppure-

method non può essere utilizzato per inviare il contenuto.

-oppure-

Si è verificato alcuna risposta dal server che ospita la risorsa.

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> oggetto verrà completato dopo che la stringa è stata caricata per la risorsa. La stringa viene inviata in modo asincrono utilizzando le risorse thread allocate automaticamente dal pool di thread.

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

Prima di caricare la stringa, questo metodo converte un Byte utilizzando la codifica specificata nella Encoding proprietà. Questo metodo si blocca durante la trasmissione della stringa.

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.

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