WebClient.UploadFileAsync 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 het opgegeven lokale bestand naar de opgegeven resource. Deze methoden blokkeren de aanroepende thread niet.
Overloads
| Name | Description |
|---|---|
| UploadFileAsync(Uri, String) |
Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de POST-methode. Deze methode blokkeert de aanroepende thread niet. |
| UploadFileAsync(Uri, String, String) |
Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de POST-methode. Deze methode blokkeert de aanroepende thread niet. |
| UploadFileAsync(Uri, String, String, Object) |
Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de POST-methode. Deze methode blokkeert de aanroepende thread niet. |
UploadFileAsync(Uri, String)
Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de POST-methode. Deze methode blokkeert de aanroepende thread niet.
public:
void UploadFileAsync(Uri ^ address, System::String ^ fileName);public void UploadFileAsync(Uri address, string fileName);member this.UploadFileAsync : Uri * string -> unitPublic Sub UploadFileAsync (address As Uri, fileName As String)Parameters
- address
- Uri
De URI van de resource om het bestand te ontvangen. Voor HTTP-resources moet deze URI een resource identificeren die een aanvraag kan accepteren die is verzonden met de POST-methode, zoals een script of ASP-pagina.
- fileName
- String
Het bestand dat naar de resource moet worden verzonden.
Uitzonderingen
De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.
– of –
fileName is null, is Empty, bevat ongeldig teken of het opgegeven pad naar het bestand bestaat niet.
– 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 header begint met multipart.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Het bestand wordt asynchroon verzonden met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep. Als u een melding wilt ontvangen wanneer het uploaden van het bestand is voltooid, voegt u een gebeurtenis-handler toe aan de UploadFileCompleted gebeurtenis.
Met deze methode wordt de aanroepende thread niet geblokkeerd terwijl het bestand wordt verzonden. Als u een bestand wilt verzenden en blokkeren terwijl u wacht op het antwoord van de server, gebruikt u een van de UploadFile methoden.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Als de BaseAddress eigenschap geen lege tekenreeks ("") is, address moet 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.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door UploadFile(Uri, String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
UploadFileAsync(Uri, String, String)
Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de POST-methode. Deze methode blokkeert de aanroepende thread niet.
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);public void UploadFileAsync(Uri address, string method, string fileName);member this.UploadFileAsync : Uri * string * string -> unitPublic Sub UploadFileAsync (address As Uri, method As String, fileName As String)Parameters
- address
- Uri
De URI van de resource om het bestand te ontvangen. Voor HTTP-resources moet deze URI een resource identificeren die een aanvraag kan accepteren die is verzonden met de POST-methode, zoals een script of ASP-pagina.
- method
- String
De methode die wordt gebruikt om de gegevens naar de resource te verzenden. Als null, de standaard is POST voor http en STOR voor FTP.
- fileName
- String
Het bestand dat naar de resource moet worden verzonden.
Uitzonderingen
De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.
– of –
fileName is null, is Empty, bevat ongeldig teken of het opgegeven pad naar het bestand bestaat niet.
– 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 header begint met multipart.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Het bestand wordt asynchroon verzonden met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep. Als u een melding wilt ontvangen wanneer het uploaden van het bestand is voltooid, voegt u een gebeurtenis-handler toe aan de UploadFileCompleted gebeurtenis.
Met deze methode wordt de aanroepende thread niet geblokkeerd terwijl het bestand wordt verzonden. Als u een bestand wilt verzenden en blokkeren terwijl u wacht op het antwoord van de server, gebruikt u een van de UploadFile methoden.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Als de BaseAddress eigenschap geen lege tekenreeks ("") is, address moet 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.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door UploadFile(Uri, String, String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
UploadFileAsync(Uri, String, String, Object)
Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de POST-methode. Deze methode blokkeert de aanroepende thread niet.
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName, System::Object ^ userToken);public void UploadFileAsync(Uri address, string method, string fileName, object userToken);member this.UploadFileAsync : Uri * string * string * obj -> unitPublic Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)Parameters
- address
- Uri
De URI van de resource om het bestand te ontvangen. Voor HTTP-resources moet deze URI een resource identificeren die een aanvraag kan accepteren die is verzonden met de POST-methode, zoals een script of ASP-pagina.
- method
- String
De methode die wordt gebruikt om de gegevens naar de resource te verzenden. Als null, de standaard is POST voor http en STOR voor FTP.
- fileName
- String
Het bestand dat naar de resource moet worden verzonden.
- userToken
- Object
Een door de gebruiker gedefinieerd object dat wordt doorgegeven aan de methode die wordt aangeroepen wanneer de asynchrone bewerking is voltooid.
Uitzonderingen
De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.
– of –
fileName is null, is Empty, bevat ongeldig teken of het opgegeven pad naar het bestand bestaat niet.
– 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 header begint met multipart.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Het bestand wordt asynchroon verzonden met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep. Als u een melding wilt ontvangen wanneer het uploaden van het bestand is voltooid, voegt u een gebeurtenis-handler toe aan de UploadFileCompleted gebeurtenis.
Met deze methode wordt de aanroepende thread niet geblokkeerd terwijl het bestand wordt verzonden. Als u een bestand wilt verzenden en blokkeren terwijl u wacht op het antwoord van de server, gebruikt u een van de UploadFile methoden.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Als de BaseAddress eigenschap geen lege tekenreeks ("") is, address moet 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.