WebClient.UploadStringAsync 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í.
Nahraje zadaný řetězec do zadaného prostředku. Tyto metody neblokují volající vlákno.
Přetížení
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
- Zdroj:
- WebClient.cs
- 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, který má přijmout řetězec. 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
Identifikátor URI vytvořený kombinací BaseAddress a address
je neplatný.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
Poznámky
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 ho tato metoda převede na Byte pole pomocí kódování zadaného Encoding ve vlastnosti . Pokud chcete dostávat oznámení o dokončení nahrání řetězce, 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é se nedokončily, voláním CancelAsync metody .
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 UploadString(Uri, String).
Platí pro
UploadStringAsync(Uri, String, String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- 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);
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, který má přijmout řetězec. 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 null, výchozí hodnota je POST pro http a STOR pro ftp.
- data
- String
Řetězec, který se má nahrát.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddress a address
je neplatný.
-nebo-
method
nelze použít k odeslání obsahu.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
Poznámky
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 ho tato metoda převede na Byte pole pomocí kódování zadaného Encoding ve vlastnosti . Pokud chcete dostávat oznámení o dokončení nahrání řetězce, 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é se nedokončily, voláním CancelAsync metody .
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 UploadString(Uri, String, String).
Platí pro
UploadStringAsync(Uri, String, String, Object)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- 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);
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, který má přijmout řetězec. 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 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ý je předán metodě vyvolány při dokončení asynchronní operace.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddress a address
je neplatný.
-nebo-
method
nelze použít k odeslání obsahu.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
Poznámky
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 ho tato metoda převede na Byte pole pomocí kódování zadaného Encoding ve vlastnosti . Pokud chcete dostávat oznámení o dokončení nahrání řetězce, 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é se nedokončily, voláním CancelAsync metody .
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
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