WebClient.OpenWriteAsync 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.
Hiermee opent u een stroom voor het schrijven van gegevens naar de opgegeven resource. Deze methoden blokkeren de aanroepende thread niet.
Overloads
| Name | Description |
|---|---|
| OpenWriteAsync(Uri, String, Object) |
Hiermee opent u een stroom voor het schrijven van gegevens naar de opgegeven resource met behulp van de opgegeven methode. Deze methode blokkeert de aanroepende thread niet. |
| OpenWriteAsync(Uri, String) |
Hiermee opent u een stroom voor het schrijven van gegevens naar de opgegeven resource. Deze methode blokkeert de aanroepende thread niet. |
| OpenWriteAsync(Uri) |
Hiermee opent u een stroom voor het schrijven van gegevens naar de opgegeven resource. Deze methode blokkeert de aanroepende thread niet. |
OpenWriteAsync(Uri, String, Object)
Hiermee opent u een stroom voor het schrijven van gegevens naar de opgegeven resource met behulp van de opgegeven methode. Deze methode blokkeert de aanroepende thread niet.
public:
void OpenWriteAsync(Uri ^ address, System::String ^ method, System::Object ^ userToken);public void OpenWriteAsync(Uri address, string method, object userToken);member this.OpenWriteAsync : Uri * string * obj -> unitPublic Sub OpenWriteAsync (address As Uri, method As String, userToken As Object)Parameters
- address
- Uri
De URI van de resource om de gegevens te ontvangen.
- method
- String
De methode die wordt gebruikt om de gegevens naar de resource te verzenden. Als null is, is de standaardwaarde POST voor http en STOR voor FTP.
- 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 address parameter is null.
De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.
– of –
Er is een fout opgetreden tijdens het openen van de stream.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Met deze methode wordt een beschrijfbare stroom opgehaald die wordt gebruikt om gegevens naar een resource te verzenden. De stream wordt asynchroon opgehaald met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep. Als u een melding wilt ontvangen wanneer de stream beschikbaar is, voegt u een gebeurtenis-handler toe aan de OpenWriteCompleted gebeurtenis. De inhoud van de stream wordt naar de server verzonden wanneer u de stream sluit.
Als de method parameter een methode opgeeft die niet door de server wordt begrepen, 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.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Deze methode blokkeert de aanroepende thread niet terwijl de stream wordt geopend. Als u wilt blokkeren terwijl u op de stream wacht, gebruikt u een van de OpenWrite methoden.
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.
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
OpenWriteAsync(Uri, String)
Hiermee opent u een stroom voor het schrijven van gegevens naar de opgegeven resource. Deze methode blokkeert de aanroepende thread niet.
public:
void OpenWriteAsync(Uri ^ address, System::String ^ method);public void OpenWriteAsync(Uri address, string method);member this.OpenWriteAsync : Uri * string -> unitPublic Sub OpenWriteAsync (address As Uri, method As String)Parameters
- address
- Uri
De URI van de resource om de gegevens te ontvangen.
- method
- String
De methode die wordt gebruikt om de gegevens naar de resource te verzenden. Als null is, is de standaardwaarde POST voor http en STOR voor FTP.
Uitzonderingen
De address parameter is null.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Met deze methode wordt een beschrijfbare stroom opgehaald die wordt gebruikt om gegevens naar een resource te verzenden. De stream wordt opgehaald met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep. Als u een melding wilt ontvangen wanneer de stream beschikbaar is, voegt u een gebeurtenis-handler toe aan de OpenWriteCompleted gebeurtenis. Wanneer u de stream sluit, wordt de thread geblokkeerd totdat de aanvraag wordt verzonden address en een antwoord wordt ontvangen.
Deze methode blokkeert de aanroepende thread niet terwijl de stream wordt geopend. Als u wilt blokkeren terwijl u op de stream wacht, gebruikt u een van de OpenWrite methoden.
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.
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 OpenWrite(Uri, String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
OpenWriteAsync(Uri)
Hiermee opent u een stroom voor het schrijven van gegevens naar de opgegeven resource. Deze methode blokkeert de aanroepende thread niet.
public:
void OpenWriteAsync(Uri ^ address);public void OpenWriteAsync(Uri address);member this.OpenWriteAsync : Uri -> unitPublic Sub OpenWriteAsync (address As Uri)Parameters
- address
- Uri
De URI van de resource om de gegevens te ontvangen.
Uitzonderingen
De address parameter is null.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Met deze methode wordt een beschrijfbare stroom opgehaald die wordt gebruikt om gegevens naar een resource te verzenden. De stream wordt opgehaald met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep. Als u een melding wilt ontvangen wanneer de stream beschikbaar is, voegt u een gebeurtenis-handler toe aan de OpenWriteCompleted gebeurtenis. Wanneer u de stream sluit, wordt de thread geblokkeerd totdat de aanvraag wordt verzonden address en een antwoord wordt ontvangen.
Deze methode blokkeert de aanroepende thread niet terwijl de stream wordt geopend. Als u wilt blokkeren terwijl u op de stream wacht, gebruikt u een van de OpenWrite methoden.
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.
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 OpenWrite(Uri)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.