WebClient.UploadValuesTaskAsync Metodo
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.
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
- Origine:
- WebClient.cs
- 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);public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string method, System.Collections.Specialized.NameValueCollection data);[System.Runtime.InteropServices.ComVisible(false)]
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[]>[<System.Runtime.InteropServices.ComVisible(false)>]
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
Oggetto attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice di Byte contenente la risposta inviata dal server.
- Attributi
Eccezioni
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.
Si applica a
UploadValuesTaskAsync(String, NameValueCollection)
- Origine:
- WebClient.cs
- Origine:
- WebClient.cs
- 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);[System.Runtime.InteropServices.ComVisible(false)]
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[]>[<System.Runtime.InteropServices.ComVisible(false)>]
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
Oggetto attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice di Byte contenente la risposta inviata dal server.
- Attributi
Eccezioni
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.
Si applica a
UploadValuesTaskAsync(Uri, NameValueCollection)
- Origine:
- WebClient.cs
- Origine:
- WebClient.cs
- 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);[System.Runtime.InteropServices.ComVisible(false)]
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[]>[<System.Runtime.InteropServices.ComVisible(false)>]
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
Oggetto attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice di Byte contenente la risposta inviata dal server.
- Attributi
Eccezioni
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.
Si applica a
UploadValuesTaskAsync(Uri, String, NameValueCollection)
- Origine:
- WebClient.cs
- Origine:
- WebClient.cs
- 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);public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);[System.Runtime.InteropServices.ComVisible(false)]
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[]>[<System.Runtime.InteropServices.ComVisible(false)>]
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
Oggetto attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice di Byte contenente la risposta inviata dal server.
- Attributi
Eccezioni
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.
