WebClient.UploadValuesAsync 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.
Laddar upp den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n. Dessa metoder blockerar inte den anropande tråden.
Överlagringar
| Name | Description |
|---|---|
| UploadValuesAsync(Uri, NameValueCollection) |
Laddar upp data i den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n. Den här metoden blockerar inte den anropande tråden. |
| UploadValuesAsync(Uri, String, NameValueCollection) |
Laddar upp data i den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n med den angivna metoden. Den här metoden blockerar inte den anropande tråden. |
| UploadValuesAsync(Uri, String, NameValueCollection, Object) |
Laddar upp data i den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n med den angivna metoden. Den här metoden blockerar inte den anropande tråden och tillåter anroparen att skicka ett objekt till den metod som anropas när åtgärden slutförs. |
UploadValuesAsync(Uri, NameValueCollection)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Laddar upp data i den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n. Den här metoden blockerar inte den anropande tråden.
public:
void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);public void UploadValuesAsync(Uri address, System.Collections.Specialized.NameValueCollection data);member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unitPublic Sub UploadValuesAsync (address As Uri, data As NameValueCollection)Parametrar
- address
- Uri
Resursens URI för att ta emot samlingen. Den här URI:n måste identifiera en resurs som kan acceptera en begäran som skickas med standardmetoden.
- data
- NameValueCollection
Att NameValueCollection skicka till resursen.
Undantag
Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.
-eller-
Det fanns inget svar från servern som var värd för resursen.
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 skickar en sträng till en resurs. Strängen skickas asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen. Innan du laddar upp strängen konverterar den här metoden den till en Byte matris med hjälp av den kodning som anges i Encoding egenskapen. Om du vill få ett meddelande när stränguppladdningen är klar kan du lägga till en händelsehanterare i UploadStringCompleted händelsen.
Den här metoden blockerar inte den anropande tråden medan strängen skickas. Om du vill skicka en sträng och ett block i väntan på serverns svar använder du någon av UploadString metoderna.
I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.
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 UploadValues(Uri, NameValueCollection).
Gäller för
UploadValuesAsync(Uri, String, NameValueCollection)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Laddar upp data i den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n med den angivna metoden. Den här metoden blockerar inte den anropande tråden.
public:
void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);public void UploadValuesAsync(Uri address, string? method, System.Collections.Specialized.NameValueCollection data);public void UploadValuesAsync(Uri address, string method, System.Collections.Specialized.NameValueCollection data);member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unitPublic Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)Parametrar
- address
- Uri
Resursens URI för att ta emot samlingen. Den här URI:n måste identifiera en resurs som kan acceptera en begäran som skickas method med metoden.
- method
- String
Den metod som används för att skicka strängen till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.
- data
- NameValueCollection
Att NameValueCollection skicka till resursen.
Undantag
Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.
-eller-
Det fanns inget svar från servern som var värd för resursen.
-eller-
method kan inte användas för att skicka innehåll.
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 skickar data som finns i en NameValueCollection till resursen address . Använd den här metoden för att skicka formulärdata till en URI för bearbetning. Data skickas med hjälp av medietypen form-urlencoded. Huvudvärdet för innehållstyp måste vara inställt på "application/x-www-form-urlencoded". Huvudet är korrekt inställt som standard. Metoderna UploadValuesAsync genererar en WebException om du anropar den här metoden med ett annat rubrikvärde av innehållstyp som angetts Headers i samlingen.
method Om metoden 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.
NameValueCollection Skickas asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen. Om du vill få ett meddelande när uppladdningen är klar lägger du till en händelsehanterare i UploadValuesCompleted händelsen.
Den här metoden blockerar inte den anropande tråden medan strängen skickas. Om du vill skicka en sträng och ett block i väntan på serverns svar använder du någon av UploadValues metoderna.
I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.
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 tom 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 Nätverksspårning i .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 UploadValues(Uri, String, NameValueCollection).
Gäller för
UploadValuesAsync(Uri, String, NameValueCollection, Object)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Laddar upp data i den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n med den angivna metoden. Den här metoden blockerar inte den anropande tråden och tillåter anroparen att skicka ett objekt till den metod som anropas när åtgärden slutförs.
public:
void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);public void UploadValuesAsync(Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);public void UploadValuesAsync(Uri address, string method, System.Collections.Specialized.NameValueCollection data, object userToken);member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unitPublic Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)Parametrar
- address
- Uri
Resursens URI för att ta emot samlingen. Den här URI:n måste identifiera en resurs som kan acceptera en begäran som skickas method med metoden.
- method
- String
HTTP-metoden som används för att skicka strängen till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.
- data
- NameValueCollection
Att NameValueCollection skicka till resursen.
- userToken
- Object
Ett användardefinierat objekt som skickas till metoden som anropas när den asynkrona åtgärden slutförs.
Undantag
Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.
-eller-
Det fanns inget svar från servern som var värd för resursen.
-eller-
method kan inte användas för att skicka innehåll.
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 skickar data som finns i en NameValueCollection till resursen address . Använd den här metoden för att skicka formulärdata till en URI för bearbetning. Data skickas med hjälp av medietypen form-urlencoded. Huvudvärdet för innehållstyp måste vara inställt på "application/x-www-form-urlencoded". Huvudet är korrekt inställt som standard. Metoderna UploadValuesAsync genererar en WebException om du anropar den här metoden med ett annat rubrikvärde av innehållstyp som angetts Headers i samlingen.
method Om metoden 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.
NameValueCollection Skickas asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen. Om du vill få ett meddelande när uppladdningen är klar lägger du till en händelsehanterare i UploadValuesCompleted händelsen.
Den här metoden blockerar inte den anropande tråden medan strängen skickas. Om du vill skicka en sträng och ett block i väntan på serverns svar använder du någon av UploadValues metoderna.
I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.
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 tom 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 Nätverksspårning i .NET Framework.
