WebClient.UploadStringAsync Metod

Definition

Namnområde:
System.Net
Sammansättningar:
netstandard.dll, System.Net.WebClient.dll
Sammansättning:
System.Net.WebClient.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Laddar upp den angivna strängen till den angivna resursen. Dessa metoder blockerar inte den anropande tråden.

Överlagringar

Name Description
UploadStringAsync(Uri, String)

Laddar upp den angivna strängen till den angivna resursen. Den här metoden blockerar inte den anropande tråden.
UploadStringAsync(Uri, String, String)

Laddar upp den angivna strängen till den angivna resursen. Den här metoden blockerar inte den anropande tråden.
UploadStringAsync(Uri, String, String, Object)

Laddar upp den angivna strängen till den angivna resursen. Den här metoden blockerar inte den anropande tråden.

UploadStringAsync(Uri, String)

Källa:
WebClient.cs
Källa:
WebClient.cs
Källa:
WebClient.cs
Källa:
WebClient.cs
Källa:
WebClient.cs

Laddar upp den angivna strängen till den angivna resursen. Den här metoden blockerar inte den anropande tråden.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ data);
public void UploadStringAsync(Uri address, string data);
member this.UploadStringAsync : Uri * string -> unit
Public Sub UploadStringAsync (address As Uri, data As String)

Parametrar

address
Uri

URI:n för resursen som ska ta emot strängen. För HTTP-resurser måste den här URI:n identifiera en resurs som kan acceptera en begäran som skickas med POST-metoden, till exempel ett skript eller en ASP-sida.

data
String

Strängen som ska laddas upp.

Undantag

ArgumentNullException

Parametern address är null.

-eller-

Parametern data är null.

WebException

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 UploadString(Uri, String).

Gäller för

UploadStringAsync(Uri, String, String)

Källa:
WebClient.cs
Källa:
WebClient.cs
Källa:
WebClient.cs
Källa:
WebClient.cs
Källa:
WebClient.cs

Laddar upp den angivna strängen till den angivna resursen. Den här metoden blockerar inte den anropande tråden.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data);
public void UploadStringAsync(Uri address, string? method, string data);
public void UploadStringAsync(Uri address, string method, string data);
member this.UploadStringAsync : Uri * string * string -> unit
Public Sub UploadStringAsync (address As Uri, method As String, data As String)

Parametrar

address
Uri

URI:n för resursen som ska ta emot strängen. För HTTP-resurser måste den här URI:n identifiera en resurs som kan acceptera en begäran som skickas med POST-metoden, till exempel ett skript eller en ASP-sida.

method
String

HTTP-metoden som används för att skicka filen till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.

data
String

Strängen som ska laddas upp.

Undantag

ArgumentNullException

Parametern address är null.

-eller-

Parametern data är null.

WebException

Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.

-eller-

method kan inte användas för att skicka innehåll.

-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 .

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 UploadString(Uri, String, String).

Gäller för

UploadStringAsync(Uri, String, String, Object)

Källa:
WebClient.cs
Källa:
WebClient.cs
Källa:
WebClient.cs
Källa:
WebClient.cs
Källa:
WebClient.cs

Laddar upp den angivna strängen till den angivna resursen. Den här metoden blockerar inte den anropande tråden.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data, System::Object ^ userToken);
public void UploadStringAsync(Uri address, string? method, string data, object? userToken);
public void UploadStringAsync(Uri address, string method, string data, object userToken);
member this.UploadStringAsync : Uri * string * string * obj -> unit
Public Sub UploadStringAsync (address As Uri, method As String, data As String, userToken As Object)

Parametrar

address
Uri

URI:n för resursen som ska ta emot strängen. För HTTP-resurser måste den här URI:n identifiera en resurs som kan acceptera en begäran som skickas med POST-metoden, till exempel ett skript eller en ASP-sida.

method
String

HTTP-metoden som används för att skicka filen till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.

data
String

Strängen som ska laddas upp.

userToken
Object

Ett användardefinierat objekt som skickas till metoden som anropas när den asynkrona åtgärden slutförs.

Undantag

ArgumentNullException

Parametern address är null.

-eller-

Parametern data är null.

WebException

Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.

-eller-

method kan inte användas för att skicka innehåll.

-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 .

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