WebClient.UploadFileTaskAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Feltölti a megadott helyi fájlt egy erőforrásba aszinkron műveletként egy tevékenységobjektum használatával. Ezek a metódusok nem tiltják le a hívó szálat.

Túlterhelések

Name	Description
UploadFileTaskAsync(Uri, String, String)	Feltölti a megadott helyi fájlt egy erőforrásba aszinkron műveletként egy tevékenységobjektum használatával.
UploadFileTaskAsync(String, String, String)	Feltölti a megadott helyi fájlt egy erőforrásba aszinkron műveletként egy tevékenységobjektum használatával.
UploadFileTaskAsync(String, String)	Feltölti a megadott helyi fájlt egy erőforrásba aszinkron műveletként egy tevékenységobjektum használatával.
UploadFileTaskAsync(Uri, String)	Feltölti a megadott helyi fájlt egy erőforrásba aszinkron műveletként egy tevékenységobjektum használatával.

UploadFileTaskAsync(Uri, String, String)

Forrás:

WebClient.cs

Feltölti a megadott helyi fájlt egy erőforrásba aszinkron műveletként egy tevékenységobjektum használatával.

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())

Paraméterek

address

Uri

A fájl fogadásához az erőforrás URI-ja. HTTP-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

method

String

Az adatok erőforrásba való küldéséhez használt módszer. Ha nullaz alapértelmezett érték a POST http és az ftp-hez tartozó STOR.

fileName

String

Az erőforrásnak küldendő helyi fájl.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result tevékenységobjektum tulajdonsága egy Byte tömböt ad vissza, amely tartalmazza az erőforrástól a fájl feltöltésekor kapott válasz törzsét.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A fileName paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

fileName az null, is Empty, érvénytelen karaktert tartalmaz, vagy a fájl megadott elérési útja nem létezik.

-vagy-

Hiba történt a stream megnyitása közben.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

-vagy-

A Content-type fejléc a következővel multipartkezdődik: .

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum a fájl erőforrásba való feltöltése után fejeződik be. A rendszer aszinkron módon küldi el a fájlt a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

Ha a BaseAddress tulajdonság nem üres sztring (""), address akkor relatív URI-nak kell lennie, amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Alapértelmezés szerint ez a metódus az STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadFileTaskAsync(String, String, String)

Forrás:

WebClient.cs

Feltölti a megadott helyi fájlt egy erőforrásba aszinkron műveletként egy tevékenységobjektum használatával.

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())

Paraméterek

address

String

A fájl fogadásához az erőforrás URI-ja. HTTP-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

method

String

Az adatok erőforrásba való küldéséhez használt módszer. Ha nullaz alapértelmezett érték a POST http és az ftp-hez tartozó STOR.

fileName

String

Az erőforrásnak küldendő helyi fájl.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result tevékenységobjektum tulajdonsága egy Byte tömböt ad vissza, amely tartalmazza az erőforrástól a fájl feltöltésekor kapott válasz törzsét.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A fileName paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

fileName az null, is Empty, érvénytelen karaktert tartalmaz, vagy a fájl megadott elérési útja nem létezik.

-vagy-

Hiba történt a stream megnyitása közben.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

-vagy-

A Content-type fejléc a következővel multipartkezdődik: .

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum a fájl erőforrásba való feltöltése után fejeződik be. A rendszer aszinkron módon küldi el a fájlt a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

Ha a BaseAddress tulajdonság nem üres sztring (""), address akkor relatív URI-nak kell lennie, amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Alapértelmezés szerint ez a metódus az STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadFileTaskAsync(String, String)

Forrás:

WebClient.cs

Feltölti a megadott helyi fájlt egy erőforrásba aszinkron műveletként egy tevékenységobjektum használatával.

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())

Paraméterek

address

String

A fájl fogadásához az erőforrás URI-ja. HTTP-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

fileName

String

Az erőforrásnak küldendő helyi fájl.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result tevékenységobjektum tulajdonsága egy Byte tömböt ad vissza, amely tartalmazza az erőforrástól a fájl feltöltésekor kapott válasz törzsét.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A fileName paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

fileName az null, is Empty, érvénytelen karaktert tartalmaz, vagy a fájl megadott elérési útja nem létezik.

-vagy-

Hiba történt a stream megnyitása közben.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

-vagy-

A Content-type fejléc a következővel multipartkezdődik: .

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum a fájl erőforrásba való feltöltése után fejeződik be. A rendszer aszinkron módon küldi el a fájlt a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

Ha a BaseAddress tulajdonság nem üres sztring (""), address akkor relatív URI-nak kell lennie, amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadFileTaskAsync(Uri, String)

Forrás:

WebClient.cs

Feltölti a megadott helyi fájlt egy erőforrásba aszinkron műveletként egy tevékenységobjektum használatával.

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())

Paraméterek

address

Uri

A fájl fogadásához az erőforrás URI-ja. HTTP-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

fileName

String

Az erőforrásnak küldendő helyi fájl.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result tevékenységobjektum tulajdonsága egy Byte tömböt ad vissza, amely tartalmazza az erőforrástól a fájl feltöltésekor kapott válasz törzsét.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A fileName paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

fileName az null, is Empty, érvénytelen karaktert tartalmaz, vagy a fájl megadott elérési útja nem létezik.

-vagy-

Hiba történt a stream megnyitása közben.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

-vagy-

A Content-type fejléc a következővel multipartkezdődik: .

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum a fájl erőforrásba való feltöltése után fejeződik be. A rendszer aszinkron módon küldi el a fájlt a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

Ha a BaseAddress tulajdonság nem üres sztring (""), address akkor relatív URI-nak kell lennie, amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.