WebClient.OpenWriteAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

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í

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 OpenWriteCompleted obslužnou rutinu události. Obsah datového proudu se odešle na server, když datový proud zavřete.

Pokud parametr method určuje metodu, která není serverem srozumitelná, základní třídy protokolu určují, co se stane. Obvykle se WebException vyvolá s vlastností Status nastavenou tak, aby označí chybu.

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

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.

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.

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 OpenWriteCompleted obslužnou rutinu události. Když datový proud zavřete, vlákno zablokuje, dokud se požadavek odešle do address a přijme se 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.

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.

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ě. U 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 OpenWriteCompleted obslužnou rutinu události. Když datový proud zavřete, vlákno zablokuje, dokud se požadavek odešle do address a přijme se 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.

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.

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ě. U uložených výjimek se podívejte na výjimky vyvolané OpenWrite(Uri).