WebClient.UploadValuesTaskAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI als asynchrone bewerking met behulp van een taakobject. Deze methoden blokkeren de aanroepende thread niet.
Overloads
| Name | Description |
|---|---|
| UploadValuesTaskAsync(String, String, NameValueCollection) |
Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI als asynchrone bewerking met behulp van een taakobject. |
| UploadValuesTaskAsync(String, NameValueCollection) |
Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI als asynchrone bewerking met behulp van een taakobject. |
| UploadValuesTaskAsync(Uri, NameValueCollection) |
Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI als asynchrone bewerking met behulp van een taakobject. |
| UploadValuesTaskAsync(Uri, String, NameValueCollection) |
Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI als asynchrone bewerking met behulp van een taakobject. |
UploadValuesTaskAsync(String, String, NameValueCollection)
Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI als asynchrone bewerking met behulp van een taakobject.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::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);public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(string address, string method, System.Collections.Specialized.NameValueCollection data);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>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())Parameters
- address
- String
De URI van de resource om de verzameling te ontvangen.
- method
- String
De HTTP-methode die wordt gebruikt om de verzameling naar de resource te verzenden. Als null is, is de standaardwaarde POST voor http en STOR voor FTP.
- data
- NameValueCollection
De NameValueCollection te verzenden naar de resource.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt. De Result eigenschap op het taakobject retourneert een Byte matrix die het antwoord bevat dat door de server is verzonden.
- Kenmerken
Uitzonderingen
De URI gevormd door combinatie BaseAddressen address is ongeldig.
– of –
method kan niet worden gebruikt om inhoud te verzenden.
– of –
Er is geen reactie van de server die als host fungeert voor de resource.
– of –
Er is een fout opgetreden tijdens het openen van de stream.
– of –
De Content-type header is niet null of 'application/x-www-form-urlencoded'.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat de verzameling naam/waarde is geüpload naar de resource. De verzameling naam/waarde wordt asynchroon verzonden met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Als de onderliggende aanvraag niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.
Als de header Inhoudstype is null, wordt deze met deze methode ingesteld op 'application/x-www-form-urlencoded'.
Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.
Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.
Van toepassing op
UploadValuesTaskAsync(String, NameValueCollection)
Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI als asynchrone bewerking met behulp van een taakobject.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::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);public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(string address, System.Collections.Specialized.NameValueCollection data);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>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())Parameters
- address
- String
De URI van de resource om de verzameling te ontvangen.
- data
- NameValueCollection
De NameValueCollection te verzenden naar de resource.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt. De Result eigenschap op het taakobject retourneert een Byte matrix die het antwoord bevat dat door de server is verzonden.
- Kenmerken
Uitzonderingen
De URI gevormd door combinatie BaseAddressen address is ongeldig.
– of –
Er is geen reactie van de server die als host fungeert voor de resource.
– of –
Er is een fout opgetreden tijdens het openen van de stream.
– of –
De Content-type header is niet null of 'application/x-www-form-urlencoded'.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat de verzameling naam/waarde is geüpload naar de resource. De verzameling naam/waarde wordt asynchroon verzonden met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Als de onderliggende aanvraag niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.
Als de header Inhoudstype is null, wordt deze met deze methode ingesteld op 'application/x-www-form-urlencoded'.
Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.
Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.
Van toepassing op
UploadValuesTaskAsync(Uri, NameValueCollection)
Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI als asynchrone bewerking met behulp van een taakobject.
public:
System::Threading::Tasks::Task<cli::array <System::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);public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(Uri address, System.Collections.Specialized.NameValueCollection data);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>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())Parameters
- address
- Uri
De URI van de resource om de verzameling te ontvangen.
- data
- NameValueCollection
De NameValueCollection te verzenden naar de resource.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt. De Result eigenschap op het taakobject retourneert een Byte matrix die het antwoord bevat dat door de server is verzonden.
- Kenmerken
Uitzonderingen
De URI gevormd door combinatie BaseAddressen address is ongeldig.
– of –
Er is een fout opgetreden tijdens het openen van de stream.
– of –
Er is geen reactie van de server die als host fungeert voor de resource.
– of –
De Content-type headerwaarde is niet null en is niet application/x-www-form-urlencoded.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat de verzameling naam/waarde is geüpload naar de resource. De verzameling naam/waarde wordt asynchroon verzonden met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Als de onderliggende aanvraag niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.
Als de header Inhoudstype is null, wordt deze met deze methode ingesteld op 'application/x-www-form-urlencoded'.
Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.
Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.
Van toepassing op
UploadValuesTaskAsync(Uri, String, NameValueCollection)
Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI als asynchrone bewerking met behulp van een taakobject.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::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);public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(Uri address, string method, System.Collections.Specialized.NameValueCollection data);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>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())Parameters
- address
- Uri
De URI van de resource om de verzameling te ontvangen.
- method
- String
De HTTP-methode die wordt gebruikt om de verzameling naar de resource te verzenden. Als null is, is de standaardwaarde POST voor http en STOR voor FTP.
- data
- NameValueCollection
De NameValueCollection te verzenden naar de resource.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt. De Result eigenschap op het taakobject retourneert een Byte matrix die het antwoord bevat dat door de server is verzonden.
- Kenmerken
Uitzonderingen
De URI gevormd door combinatie BaseAddressen address is ongeldig.
– of –
method kan niet worden gebruikt om inhoud te verzenden.
– of –
Er is geen reactie van de server die als host fungeert voor de resource.
– of –
Er is een fout opgetreden tijdens het openen van de stream.
– of –
De Content-type header is niet null of 'application/x-www-form-urlencoded'.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat de verzameling naam/waarde is geüpload naar de resource. De verzameling naam/waarde wordt asynchroon verzonden met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Als de onderliggende aanvraag niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.
Als de header Inhoudstype is null, wordt deze met deze methode ingesteld op 'application/x-www-form-urlencoded'.
Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.
Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.