WebClient.UploadValuesTaskAsync Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato come operazione asincrona usando un oggetto attività. Questi metodi non bloccano il thread chiamante.

Overload

UploadValuesTaskAsync(String, String, NameValueCollection)	Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato come operazione asincrona usando un oggetto attività.
UploadValuesTaskAsync(String, NameValueCollection)	Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato come operazione asincrona usando un oggetto attività.
UploadValuesTaskAsync(Uri, NameValueCollection)	Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato come operazione asincrona usando un oggetto attività.
UploadValuesTaskAsync(Uri, String, NameValueCollection)	Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato come operazione asincrona usando un oggetto attività.

UploadValuesTaskAsync(String, String, NameValueCollection)

Origine:

WebClient.cs

Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato come operazione asincrona usando un oggetto attività.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, method As String, data As NameValueCollection) As Task(Of Byte())

Parametri

address

String

URI della risorsa da ricevere la raccolta.

method

String

Metodo HTTP usato per inviare la raccolta alla risorsa. Se null, il valore predefinito è POST per http e STOR per ftp.

data

NameValueCollection

Il NameValueCollection da inviare alla risorsa.

Restituisce

Task<Byte[]>

Oggetto attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice di Byte contenente la risposta inviata dal server.

Eccezioni

ArgumentNullException

Il parametro address è null.

-o-

Il parametro data è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

method non può essere usato per inviare contenuto.

-o-

Non è stata ricevuta alcuna risposta dal server che ospita la risorsa.

-o-

Errore durante l'apertura del flusso.

-o-

L'intestazione Content-type non è null o "application/x-www-form-urlencoded".

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo il caricamento della raccolta nome/valore nella risorsa. La raccolta nome/valore viene inviata in modo asincrono usando le risorse del thread allocate automaticamente dal pool di thread.

In .NET Framework e .NET Core 1.0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il metodo CancelAsync.

Se la richiesta sottostante non viene riconosciuta dal server, le classi di protocollo sottostanti determinano cosa si verifica. In genere, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

Se l'intestazione Content-type è null, questo metodo lo imposta su "application/x-www-form-urlencoded".

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

Questo metodo usa il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo POST.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

UploadValuesTaskAsync(String, NameValueCollection)

Origine:

WebClient.cs

Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato come operazione asincrona usando un oggetto attività.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, data As NameValueCollection) As Task(Of Byte())

Parametri

address

String

URI della risorsa da ricevere la raccolta.

data

NameValueCollection

Il NameValueCollection da inviare alla risorsa.

Restituisce

Task<Byte[]>

Oggetto attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice di Byte contenente la risposta inviata dal server.

Eccezioni

ArgumentNullException

Il parametro address è null.

-o-

Il parametro data è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

Non è stata ricevuta alcuna risposta dal server che ospita la risorsa.

-o-

Errore durante l'apertura del flusso.

-o-

L'intestazione Content-type non è null o "application/x-www-form-urlencoded".

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo il caricamento della raccolta nome/valore nella risorsa. La raccolta nome/valore viene inviata in modo asincrono usando le risorse del thread allocate automaticamente dal pool di thread.

In .NET Framework e .NET Core 1.0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il metodo CancelAsync.

Se la richiesta sottostante non viene riconosciuta dal server, le classi di protocollo sottostanti determinano cosa si verifica. In genere, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

Se l'intestazione Content-type è null, questo metodo lo imposta su "application/x-www-form-urlencoded".

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

Questo metodo usa il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo POST.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

UploadValuesTaskAsync(Uri, NameValueCollection)

Origine:

WebClient.cs

Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato come operazione asincrona usando un oggetto attività.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, data As NameValueCollection) As Task(Of Byte())

Parametri

address

Uri

URI della risorsa da ricevere la raccolta.

data

NameValueCollection

Il NameValueCollection da inviare alla risorsa.

Restituisce

Task<Byte[]>

Oggetto attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice di Byte contenente la risposta inviata dal server.

Eccezioni

ArgumentNullException

Il parametro address è null.

-o-

Il parametro data è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

Errore durante l'apertura del flusso.

-o-

Non è stata ricevuta alcuna risposta dal server che ospita la risorsa.

-o-

Il valore dell'intestazione Content-type non è null e non è application/x-www-form-urlencoded.

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo il caricamento della raccolta nome/valore nella risorsa. La raccolta nome/valore viene inviata in modo asincrono usando le risorse del thread allocate automaticamente dal pool di thread.

In .NET Framework e .NET Core 1.0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il metodo CancelAsync.

Se la richiesta sottostante non viene riconosciuta dal server, le classi di protocollo sottostanti determinano cosa si verifica. In genere, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

Se l'intestazione Content-type è null, questo metodo lo imposta su "application/x-www-form-urlencoded".

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

Questo metodo usa il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo POST.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

UploadValuesTaskAsync(Uri, String, NameValueCollection)

Origine:

WebClient.cs

Carica la raccolta nome/valore specificata nella risorsa identificata dall'URI specificato come operazione asincrona usando un oggetto attività.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, method As String, data As NameValueCollection) As Task(Of Byte())

Parametri

address

Uri

URI della risorsa da ricevere la raccolta.

method

String

Metodo HTTP usato per inviare la raccolta alla risorsa. Se null, il valore predefinito è POST per http e STOR per ftp.

data

NameValueCollection

Il NameValueCollection da inviare alla risorsa.

Restituisce

Task<Byte[]>

Oggetto attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice di Byte contenente la risposta inviata dal server.

Eccezioni

ArgumentNullException

Il parametro address è null.

-o-

Il parametro data è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

method non può essere usato per inviare contenuto.

-o-

Non è stata ricevuta alcuna risposta dal server che ospita la risorsa.

-o-

Errore durante l'apertura del flusso.

-o-

L'intestazione Content-type non è null o "application/x-www-form-urlencoded".

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo il caricamento della raccolta nome/valore nella risorsa. La raccolta nome/valore viene inviata in modo asincrono usando le risorse del thread allocate automaticamente dal pool di thread.

In .NET Framework e .NET Core 1.0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il metodo CancelAsync.

Se la richiesta sottostante non viene riconosciuta dal server, le classi di protocollo sottostanti determinano cosa si verifica. In genere, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

Se l'intestazione Content-type è null, questo metodo lo imposta su "application/x-www-form-urlencoded".

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

Questo metodo usa il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo POST.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.