WebClient.UploadStringTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Nahraje zadaný řetězec do zadaného prostředku jako asynchronní operaci pomocí objektu úkolu. Tyto metody neblokují volající vlákno.

Přetížení

UploadStringTaskAsync(Uri, String, String)	Nahraje zadaný řetězec do zadaného prostředku jako asynchronní operaci pomocí objektu úkolu.
UploadStringTaskAsync(String, String, String)	Nahraje zadaný řetězec do zadaného prostředku jako asynchronní operaci pomocí objektu úkolu.
UploadStringTaskAsync(String, String)	Nahraje zadaný řetězec do zadaného prostředku jako asynchronní operaci pomocí objektu úkolu.
UploadStringTaskAsync(Uri, String)	Nahraje zadaný řetězec do zadaného prostředku jako asynchronní operaci pomocí objektu úkolu.

UploadStringTaskAsync(Uri, String, String)

Zdroj:

WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string? method, string data);

member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, method As String, data As String) As Task(Of String)

Parametry

address

Uri

Identifikátor URI prostředku pro příjem řetězce. U prostředků HTTP musí tento identifikátor URI identifikovat prostředek, který může přijmout požadavek odeslaný metodou POST, jako je skript nebo stránka ASP.

method

String

Metoda HTTP použitá k odeslání souboru do prostředku. Pokud má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

data

String

Řetězec, který se má nahrát.

Návraty

Task<String>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí String obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

method nelze použít k odesílání obsahu.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Tato operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po nahrání řetězce do prostředku. Řetězec se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním metody CancelAsync.

Před nahráním řetězce ji tato metoda převede na pole Byte pomocí kódování zadaného ve vlastnosti Encoding. Tato metoda blokuje během přenosu řetězce.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

UploadStringTaskAsync(String, String, String)

Zdroj:

WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string? method, string data);

member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, method As String, data As String) As Task(Of String)

Parametry

address

String

Identifikátor URI prostředku pro příjem řetězce. U prostředků HTTP musí tento identifikátor URI identifikovat prostředek, který může přijmout požadavek odeslaný metodou POST, jako je skript nebo stránka ASP.

method

String

Metoda HTTP použitá k odeslání souboru do prostředku. Pokud má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

data

String

Řetězec, který se má nahrát.

Návraty

Task<String>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí String obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

method nelze použít k odesílání obsahu.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Tato operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po nahrání řetězce do prostředku. Řetězec se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním metody CancelAsync.

Před nahráním řetězce ji tato metoda převede na pole Byte pomocí kódování zadaného ve vlastnosti Encoding. Tato metoda blokuje během přenosu řetězce.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

UploadStringTaskAsync(String, String)

Zdroj:

WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);

member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)

Parametry

address

String

Identifikátor URI prostředku pro příjem řetězce. U prostředků HTTP musí tento identifikátor URI identifikovat prostředek, který může přijmout požadavek odeslaný metodou POST, jako je skript nebo stránka ASP.

data

String

Řetězec, který se má nahrát.

Návraty

Task<String>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí String obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Tato operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po nahrání řetězce do prostředku. Řetězec se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním metody CancelAsync.

Před nahráním řetězce ji tato metoda převede na pole Byte pomocí kódování zadaného ve vlastnosti Encoding. Tato metoda blokuje během přenosu řetězce.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

UploadStringTaskAsync(Uri, String)

Zdroj:

WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);

member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of String)

Parametry

address

Uri

Identifikátor URI prostředku pro příjem řetězce. U prostředků HTTP musí tento identifikátor URI identifikovat prostředek, který může přijmout požadavek odeslaný metodou POST, jako je skript nebo stránka ASP.

data

String

Řetězec, který se má nahrát.

Návraty

Task<String>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí String obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Tato operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po nahrání řetězce do prostředku. Řetězec se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním metody CancelAsync.

Před nahráním řetězce ji tato metoda převede na pole Byte pomocí kódování zadaného ve vlastnosti Encoding. Tato metoda blokuje během přenosu řetězce.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.