WebClient.UploadFileTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Nahraje zadaný místní soubor do prostředku jako asynchronní operaci pomocí objektu úkolu. Tyto metody neblokují volající vlákno.

Přetížení

UploadFileTaskAsync(Uri, String, String)	Nahraje zadaný místní soubor do prostředku jako asynchronní operaci pomocí objektu úkolu.
UploadFileTaskAsync(String, String, String)	Nahraje zadaný místní soubor do prostředku jako asynchronní operaci pomocí objektu úkolu.
UploadFileTaskAsync(String, String)	Nahraje zadaný místní soubor do prostředku jako asynchronní operaci pomocí objektu úkolu.
UploadFileTaskAsync(Uri, String)	Nahraje zadaný místní soubor do prostředku jako asynchronní operaci pomocí objektu úkolu.

UploadFileTaskAsync(Uri, String, String)

Zdroj:

WebClient.cs

Nahraje zadaný místní soubor do prostředku jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string? method, string fileName);

member this.UploadFileTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As Uri, method As String, fileName As String) As Task(Of Byte())

Parametry

address

Uri

Identifikátor URI prostředku pro příjem souboru. 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

Místní soubor, který se má odeslat do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující tělo odpovědi přijaté z prostředku při nahrání souboru.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr fileName je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

fileName je null, je Empty, obsahuje neplatný znak nebo zadaná cesta k souboru neexistuje.

-nebo-

Při otevírání datového proudu došlo k chybě.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

-nebo-

Záhlaví Content-type začíná multipart.

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 nahrání souboru do prostředku. Soubor se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 (""), 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.

Ve výchozím nastavení 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.

UploadFileTaskAsync(String, String, String)

Zdroj:

WebClient.cs

Nahraje zadaný místní soubor do prostředku jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ method, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string? method, string fileName);

member this.UploadFileTaskAsync : string * string * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As String, method As String, fileName As String) As Task(Of Byte())

Parametry

address

String

Identifikátor URI prostředku pro příjem souboru. 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

Místní soubor, který se má odeslat do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující tělo odpovědi přijaté z prostředku při nahrání souboru.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr fileName je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

fileName je null, je Empty, obsahuje neplatný znak nebo zadaná cesta k souboru neexistuje.

-nebo-

Při otevírání datového proudu došlo k chybě.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

-nebo-

Záhlaví Content-type začíná multipart.

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 nahrání souboru do prostředku. Soubor se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 (""), 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.

Ve výchozím nastavení 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.

UploadFileTaskAsync(String, String)

Zdroj:

WebClient.cs

Nahraje zadaný místní soubor do prostředku jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string fileName);

member this.UploadFileTaskAsync : string * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As String, fileName As String) As Task(Of Byte())

Parametry

address

String

Identifikátor URI prostředku pro příjem souboru. 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

Místní soubor, který se má odeslat do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující tělo odpovědi přijaté z prostředku při nahrání souboru.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr fileName je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

fileName je null, je Empty, obsahuje neplatný znak nebo zadaná cesta k souboru neexistuje.

-nebo-

Při otevírání datového proudu došlo k chybě.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

-nebo-

Záhlaví Content-type začíná multipart.

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 nahrání souboru do prostředku. Soubor se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 (""), 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.

UploadFileTaskAsync(Uri, String)

Zdroj:

WebClient.cs

Nahraje zadaný místní soubor do prostředku jako asynchronní operaci pomocí objektu úkolu.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string fileName);

member this.UploadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As Uri, fileName As String) As Task(Of Byte())

Parametry

address

Uri

Identifikátor URI prostředku pro příjem souboru. 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

Místní soubor, který se má odeslat do prostředku.

Návraty

Task<Byte[]>

Objekt úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole Byte obsahující tělo odpovědi přijaté z prostředku při nahrání souboru.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr fileName je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

fileName je null, je Empty, obsahuje neplatný znak nebo zadaná cesta k souboru neexistuje.

-nebo-

Při otevírání datového proudu došlo k chybě.

-nebo-

Ze serveru, který je hostitelem prostředku, nebyla žádná odpověď.

-nebo-

Záhlaví Content-type začíná multipart.

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 nahrání souboru do prostředku. Soubor se odesílá asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny z fondu vláken.

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 (""), 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.