WebClient.OpenWriteAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- Zdroj:
- WebClient.cs
- 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);
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 null, výchozí hodnota je POST pro http a STOR pro ftp.
- userToken
- Object
Uživatelem definovaný objekt, který je předán metodě vyvolány při dokončení asynchronní operace.
Výjimky
Parametr address
je null
.
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
Tato metoda načte zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Datový proud se načítá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Pokud chcete dostávat oznámení, když je datový proud dostupný, přidejte do události obslužnou rutinu OpenWriteCompleted události. Když datový proud zavřete, obsah datového proudu se odešle na server.
method
Pokud parametr určuje metodu, která není serveru srozumitelná, třídy podkladových protokolů určují, co se stane. Obvykle WebException je vyvolán s vlastností nastavenou Status k označení chyby.
V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které se nedokončily, voláním CancelAsync metody .
Tato metoda neblokuje volající vlákno při otevření datového proudu. K blokování při č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, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat.
QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.
Platí pro
OpenWriteAsync(Uri, String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- 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);
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 null, výchozí hodnota je POST pro http a STOR pro ftp.
Výjimky
Parametr address
je null
.
Poznámky
Tato metoda načte zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Datový proud se načte pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Pokud chcete dostávat oznámení, když je datový proud dostupný, přidejte do události obslužnou rutinu OpenWriteCompleted události. Když datový proud zavřete, vlákno se zablokuje, dokud se požadavek odešle do address
a neobdrží odpověď.
Tato metoda neblokuje volající vlákno při otevření datového proudu. K blokování při č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, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat.
QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem OpenWrite(Uri, String).
Platí pro
OpenWriteAsync(Uri)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- 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
Parametr address
je null
.
Poznámky
Tato metoda načte zapisovatelný datový proud, který se používá k odesílání dat do prostředku. Datový proud se načte pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken. Pokud chcete dostávat oznámení, když je datový proud dostupný, přidejte do události obslužnou rutinu OpenWriteCompleted události. Když datový proud zavřete, vlákno se zablokuje, dokud se požadavek odešle do address
a neobdrží odpověď.
Tato metoda neblokuje volající vlákno při otevření datového proudu. K blokování při č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, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat.
QueryString Pokud 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žívá metoda POST.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem OpenWrite(Uri).
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro