WebClient.OpenWriteAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Öppnar en ström för att skriva data till den angivna resursen. Dessa metoder blockerar inte den anropande tråden.
Överlagringar
| Name | Description |
|---|---|
| OpenWriteAsync(Uri, String, Object) |
Öppnar en ström för att skriva data till den angivna resursen med den angivna metoden. Den här metoden blockerar inte den anropande tråden. |
| OpenWriteAsync(Uri, String) |
Öppnar en ström för att skriva data till den angivna resursen. Den här metoden blockerar inte den anropande tråden. |
| OpenWriteAsync(Uri) |
Öppnar en ström för att skriva data till den angivna resursen. Den här metoden blockerar inte den anropande tråden. |
OpenWriteAsync(Uri, String, Object)
Öppnar en ström för att skriva data till den angivna resursen med den angivna metoden. Den här metoden blockerar inte den anropande tråden.
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)Parametrar
- address
- Uri
Resursens URI för att ta emot data.
- method
- String
Den metod som används för att skicka data till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.
- userToken
- Object
Ett användardefinierat objekt som skickas till metoden som anropas när den asynkrona åtgärden slutförs.
Undantag
Parametern address är null.
Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.
-eller-
Ett fel uppstod när strömmen öppnades.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Den här metoden hämtar en skrivbar ström som används för att skicka data till en resurs. Strömmen hämtas asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen. Om du vill få ett meddelande när strömmen är tillgänglig lägger du till en händelsehanterare i OpenWriteCompleted händelsen. Innehållet i strömmen skickas till servern när du stänger strömmen.
Om parametern method anger en metod som inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.
I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.
Den här metoden blockerar inte den anropande tråden medan strömmen öppnas. Om du vill blockera i väntan på strömmen använder du någon av OpenWrite metoderna.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Gäller för
OpenWriteAsync(Uri, String)
Öppnar en ström för att skriva data till den angivna resursen. Den här metoden blockerar inte den anropande tråden.
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)Parametrar
- address
- Uri
Resursens URI för att ta emot data.
- method
- String
Den metod som används för att skicka data till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.
Undantag
Parametern address är null.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Den här metoden hämtar en skrivbar ström som används för att skicka data till en resurs. Strömmen hämtas med hjälp av trådresurser som automatiskt allokeras från trådpoolen. Om du vill få ett meddelande när strömmen är tillgänglig lägger du till en händelsehanterare i OpenWriteCompleted händelsen. När du stänger strömmen blockeras tråden tills begäran skickas till address och ett svar tas emot.
Den här metoden blockerar inte den anropande tråden medan strömmen öppnas. Om du vill blockera i väntan på strömmen använder du någon av OpenWrite metoderna.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av OpenWrite(Uri, String).
Gäller för
OpenWriteAsync(Uri)
Öppnar en ström för att skriva data till den angivna resursen. Den här metoden blockerar inte den anropande tråden.
public:
void OpenWriteAsync(Uri ^ address);public void OpenWriteAsync(Uri address);member this.OpenWriteAsync : Uri -> unitPublic Sub OpenWriteAsync (address As Uri)Parametrar
- address
- Uri
Resursens URI för att ta emot data.
Undantag
Parametern address är null.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Den här metoden hämtar en skrivbar ström som används för att skicka data till en resurs. Strömmen hämtas med hjälp av trådresurser som automatiskt allokeras från trådpoolen. Om du vill få ett meddelande när strömmen är tillgänglig lägger du till en händelsehanterare i OpenWriteCompleted händelsen. När du stänger strömmen blockeras tråden tills begäran skickas till address och ett svar tas emot.
Den här metoden blockerar inte den anropande tråden medan strömmen öppnas. Om du vill blockera i väntan på strömmen använder du någon av OpenWrite metoderna.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Den här metoden använder STOR-kommandot för att ladda upp en FTP-resurs. För en HTTP-resurs används POST-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av OpenWrite(Uri).