WebClient.UploadStringAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebClient.dll

Nahraje zadaný řetězec do zadaného prostředku. Tyto metody neblokují volající vlákno.

Přetížení

Name	Description
UploadStringAsync(Uri, String)	Nahraje zadaný řetězec do zadaného prostředku. Tato metoda neblokuje volající vlákno.
UploadStringAsync(Uri, String, String)	Nahraje zadaný řetězec do zadaného prostředku. Tato metoda neblokuje volající vlákno.
UploadStringAsync(Uri, String, String, Object)	Nahraje zadaný řetězec do zadaného prostředku. Tato metoda neblokuje volající vlákno.

UploadStringAsync(Uri, String)

Zdroj:

WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku. Tato metoda neblokuje volající vlákno.

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)

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.

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 metoda odešle řetězec do prostředku. Řetězec se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Před nahráním řetězce ji tato metoda převede na Byte pole pomocí kódování zadaného Encoding ve vlastnosti. Pokud chcete dostávat oznámení, když se řetězec nahraje, můžete do události přidat obslužnou rutinu UploadStringCompleted události.

Tato metoda neblokuje volající vlákno při odesílání řetězce. Pokud chcete odeslat řetězec a blokovat při čekání na odpověď serveru, použijte jednu z UploadString metod.

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

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

Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se použije metoda POST.

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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané UploadString(Uri, String).

UploadStringAsync(Uri, String, String)

Zdroj:

WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku. Tato metoda neblokuje volající vlákno.

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::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)

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.

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 metoda odešle řetězec do prostředku. Řetězec se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Před nahráním řetězce ji tato metoda převede na Byte pole pomocí kódování zadaného Encoding ve vlastnosti. Pokud chcete dostávat oznámení, když se řetězec nahraje, můžete do události přidat obslužnou rutinu UploadStringCompleted události.

Tato metoda neblokuje volající vlákno při odesílání řetězce. Pokud chcete odeslat řetězec a blokovat při čekání na odpověď serveru, použijte jednu z UploadString metod.

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

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen 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.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané UploadString(Uri, String, String).

UploadStringAsync(Uri, String, String, Object)

Zdroj:

WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku. Tato metoda neblokuje volající vlákno.

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);

member this.UploadStringAsync : Uri * string * string * obj -> unit

Public Sub UploadStringAsync (address As Uri, method As String, data As String, userToken As Object)

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.

userToken

Object

Uživatelem definovaný objekt, který se předá metodě vyvolá při dokončení asynchronní operace.

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 metoda odešle řetězec do prostředku. Řetězec se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Před nahráním řetězce ji tato metoda převede na Byte pole pomocí kódování zadaného Encoding ve vlastnosti. Pokud chcete dostávat oznámení, když se řetězec nahraje, můžete do události přidat obslužnou rutinu UploadStringCompleted události.

Tato metoda neblokuje volající vlákno při odesílání řetězce. Pokud chcete odeslat řetězec a blokovat při čekání na odpověď serveru, použijte jednu z UploadString metod.

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

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen 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.