WebClient.UploadFileAsync 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ý místní soubor do zadaného prostředku. Tyto metody neblokují volající vlákno.
Přetížení
UploadFileAsync(Uri, String) |
Nahraje zadaný místní soubor do zadaného prostředku pomocí metody POST. Tato metoda neblokuje volající vlákno. |
UploadFileAsync(Uri, String, String) |
Nahraje zadaný místní soubor do zadaného prostředku pomocí metody POST. Tato metoda neblokuje volající vlákno. |
UploadFileAsync(Uri, String, String, Object) |
Nahraje zadaný místní soubor do zadaného prostředku pomocí metody POST. Tato metoda neblokuje volající vlákno. |
UploadFileAsync(Uri, String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Nahraje zadaný místní soubor do zadaného prostředku pomocí metody POST. Tato metoda neblokuje volající vlákno.
public:
void UploadFileAsync(Uri ^ address, System::String ^ fileName);
public void UploadFileAsync (Uri address, string fileName);
member this.UploadFileAsync : Uri * string -> unit
Public Sub UploadFileAsync (address As Uri, fileName As String)
Parametry
- address
- Uri
Identifikátor URI prostředku, který má soubor přijmout. 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.
- fileName
- String
Soubor, který se má odeslat do prostředku.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddress a address
je neplatný.
-nebo-
fileName
is null
, is Empty, obsahuje neplatný znak nebo zadaná cesta k souboru neexistuje.
-nebo-
Při otevírání streamu došlo k chybě.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
-nebo-
Záhlaví Content-type
začíná na multipart
.
Poznámky
Soubor se odesílá asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení o dokončení nahrávání souboru, přidejte do události obslužnou rutinu UploadFileCompleted události.
Tato metoda neblokuje volající vlákno během odesílání souboru. Pokud chcete odeslat soubor a blokovat při čekání na odpověď serveru, použijte jednu z těchto UploadFile metod.
V rozhraních .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 (""), address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby se 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 nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem UploadFile(Uri, String).
Platí pro
UploadFileAsync(Uri, String, String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Nahraje zadaný místní soubor do zadaného prostředku pomocí metody POST. Tato metoda neblokuje volající vlákno.
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);
public void UploadFileAsync (Uri address, string? method, string fileName);
public void UploadFileAsync (Uri address, string method, string fileName);
member this.UploadFileAsync : Uri * string * string -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String)
Parametry
- address
- Uri
Identifikátor URI prostředku, který má soubor přijmout. 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 použitá k odeslání dat do prostředku. Pokud null
, výchozí hodnota je POST pro http a STOR pro ftp.
- fileName
- String
Soubor, který se má odeslat do prostředku.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddress a address
je neplatný.
-nebo-
fileName
is null
, is Empty, obsahuje neplatný znak nebo zadaná cesta k souboru neexistuje.
-nebo-
Při otevírání streamu došlo k chybě.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
-nebo-
Záhlaví Content-type
začíná na multipart
.
Poznámky
Soubor se odesílá asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení o dokončení nahrávání souboru, přidejte do události obslužnou rutinu UploadFileCompleted události.
Tato metoda neblokuje volající vlákno během odesílání souboru. Pokud chcete odeslat soubor a blokovat při čekání na odpověď serveru, použijte jednu z těchto UploadFile metod.
V rozhraních .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 (""), address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby se 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 nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem UploadFile(Uri, String, String).
Platí pro
UploadFileAsync(Uri, String, String, Object)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Nahraje zadaný místní soubor do zadaného prostředku pomocí metody POST. Tato metoda neblokuje volající vlákno.
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName, System::Object ^ userToken);
public void UploadFileAsync (Uri address, string? method, string fileName, object? userToken);
public void UploadFileAsync (Uri address, string method, string fileName, object userToken);
member this.UploadFileAsync : Uri * string * string * obj -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)
Parametry
- address
- Uri
Identifikátor URI prostředku, který má soubor přijmout. 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 použitá k odeslání dat do prostředku. Pokud null
, výchozí hodnota je POST pro http a STOR pro ftp.
- fileName
- String
Soubor, který se má odeslat do prostředku.
- userToken
- Object
Uživatelem definovaný objekt, který je předán metodě vyvolány po dokončení asynchronní operace.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddress a address
je neplatný.
-nebo-
fileName
is null
, is Empty, obsahuje neplatný znak nebo zadaná cesta k souboru neexistuje.
-nebo-
Při otevírání streamu došlo k chybě.
-nebo-
Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.
-nebo-
Záhlaví Content-type
začíná na multipart
.
Poznámky
Soubor se odesílá asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení o dokončení nahrávání souboru, přidejte do události obslužnou rutinu UploadFileCompleted události.
Tato metoda neblokuje volající vlákno během odesílání souboru. Pokud chcete odeslat soubor a blokovat při čekání na odpověď serveru, použijte jednu z těchto UploadFile metod.
V rozhraních .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 (""), address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby se 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.
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