WebClient.OpenWriteTaskAsync 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 jako asynchronní operace pomocí objektu úkolu. Tyto metody neblokují volající vlákno.

Přetížení

OpenWriteTaskAsync(String)	Otevře datový proud pro zápis dat do zadaného prostředku jako asynchronní operace pomocí objektu úkolu.
OpenWriteTaskAsync(Uri)	Otevře datový proud pro zápis dat do zadaného prostředku jako asynchronní operace pomocí objektu úkolu.
OpenWriteTaskAsync(String, String)	Otevře datový proud pro zápis dat do zadaného prostředku jako asynchronní operace pomocí objektu úkolu.
OpenWriteTaskAsync(Uri, String)	Otevře datový proud pro zápis dat do zadaného prostředku jako asynchronní operace pomocí objektu úkolu.

OpenWriteTaskAsync(String)

Zdroj:

WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku jako asynchronní operace pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);

member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)

Parametry

address

String

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

Návraty

Task<Stream>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Stream sloužící k zápisu dat do prostředku.

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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po otevření zapisovatelného datového proudu do datového prostředku. Tato metoda neblokuje volající vlákno při otevření datového proudu.

Tato metoda načte instanci Stream sloužící k zápisu dat do prostředku určeného parametrem address. Stream se získá pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Poznámka

Po dokončení Stream musíte zavolat Stream.Close, abyste se vyhnuli výpadku systémových prostředků.

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

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.

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.

Viz také

• Stream

OpenWriteTaskAsync(Uri)

Zdroj:

WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku jako asynchronní operace pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);

member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)

Parametry

address

Uri

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

Návraty

Task<Stream>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Stream sloužící k zápisu dat do prostředku.

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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po otevření zapisovatelného datového proudu do datového prostředku. Tato metoda neblokuje volající vlákno při otevření datového proudu.

Tato metoda načte instanci Stream sloužící k zápisu dat do prostředku určeného parametrem address. Stream se získá pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Poznámka

Po dokončení Stream musíte zavolat Stream.Close, abyste se vyhnuli výpadku systémových prostředků.

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

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.

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.

OpenWriteTaskAsync(String, String)

Zdroj:

WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku jako asynchronní operace pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string? method);

member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)

Parametry

address

String

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.

Návraty

Task<Stream>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Stream sloužící k zápisu dat do prostředku.

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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po otevření zapisovatelného datového proudu do datového prostředku. Tato metoda neblokuje volající vlákno při otevření datového proudu.

Tato metoda načte instanci Stream sloužící k zápisu dat do prostředku určeného parametrem address. Stream se získá pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Poznámka

Po dokončení Stream musíte zavolat Stream.Close, abyste se vyhnuli výpadku systémových prostředků.

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.

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.

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.

Viz také

• Stream

OpenWriteTaskAsync(Uri, String)

Zdroj:

WebClient.cs

Otevře datový proud pro zápis dat do zadaného prostředku jako asynchronní operace pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string? method);

member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)

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.

Návraty

Task<Stream>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí Stream sloužící k zápisu dat do prostředku.

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 operace nebude blokovat. Vrácený Task<TResult> objekt se dokončí po otevření zapisovatelného datového proudu do datového prostředku. Tato metoda neblokuje volající vlákno při otevření datového proudu.

Tato metoda načte instanci Stream sloužící k zápisu dat do prostředku určeného parametrem address. Stream se získá pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Poznámka

Po dokončení Stream musíte zavolat Stream.Close, abyste se vyhnuli výpadku systémových prostředků.

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.

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.

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.

Viz také

• Stream