WebClient.OpenWriteAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebClient.dll

Otevře datový proud pro zápis dat do zadaného prostředku. Tyto metody neblokují volající vlákno.

Přetížení

Name	Description
OpenWriteAsync(Uri, String, Object)	Otevře datový proud pro zápis dat do zadaného prostředku pomocí zadané metody. Tato metoda neblokuje volající vlákno.
OpenWriteAsync(Uri, String)	Otevře datový proud pro zápis dat do zadaného prostředku. Tato metoda neblokuje volající vlákno.
OpenWriteAsync(Uri)	Otevře datový proud pro zápis dat do zadaného prostředku. Tato metoda neblokuje volající vlákno.

OpenWriteAsync(Uri, String, Object)

Zdroj:

WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku pomocí zadané metody. Tato metoda neblokuje volající vlákno.

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

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

Parametry

address

Uri

Identifikátor URI prostředku pro příjem dat.

method

String

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

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.

WebException

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

-nebo-

Při otevírání datového proudu došlo k chybě.

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 načte zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Stream se načte asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení, když je stream k dispozici, přidejte do události obslužnou rutinu OpenWriteCompleted události. Obsah datového proudu se odešle na server, když datový proud zavřete.

method Pokud parametr určuje metodu, která není serverem srozumitelná, základní třídy protokolu určují, co se stane. WebException Obvykle je vyvolán s Status vlastností nastavenou na indikaci chyby.

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

Tato metoda neblokuje volající vlákno při otevření datového proudu. Pokud chcete blokovat čekání na datový proud, použijte jednu z OpenWrite metod.

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.

OpenWriteAsync(Uri, String)

Zdroj:

WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku. Tato metoda neblokuje volající vlákno.

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method);

public void OpenWriteAsync(Uri address, string? method);

member this.OpenWriteAsync : Uri * string -> unit

Public Sub OpenWriteAsync (address As Uri, method As String)

Parametry

address

Uri

Identifikátor URI prostředku pro příjem dat.

method

String

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

Výjimky

ArgumentNullException

Parametr address je null.

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 načte zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Stream se načte pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení, když je stream k dispozici, přidejte do události obslužnou rutinu OpenWriteCompleted události. Když datový proud zavřete, vlákno zablokuje, dokud se požadavek odešle a address přijme odpověď.

Tato metoda neblokuje volající vlákno při otevření datového proudu. Pokud chcete blokovat čekání na datový proud, použijte jednu z OpenWrite metod.

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

OpenWriteAsync(Uri)

Zdroj:

WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku. Tato metoda neblokuje volající vlákno.

public:
 void OpenWriteAsync(Uri ^ address);

public void OpenWriteAsync(Uri address);

member this.OpenWriteAsync : Uri -> unit

Public Sub OpenWriteAsync (address As Uri)

Parametry

address

Uri

Identifikátor URI prostředku pro příjem dat.

Výjimky

ArgumentNullException

Parametr address je null.

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 načte zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Stream se načte pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení, když je stream k dispozici, přidejte do události obslužnou rutinu OpenWriteCompleted události. Když datový proud zavřete, vlákno zablokuje, dokud se požadavek odešle a address přijme odpověď.

Tato metoda neblokuje volající vlákno při otevření datového proudu. Pokud chcete blokovat čekání na datový proud, použijte jednu z OpenWrite metod.

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é OpenWrite(Uri).