WebClient.UploadFileTaskAsync WebClient.UploadFileTaskAsync WebClient.UploadFileTaskAsync WebClient.UploadFileTaskAsync Method

Definizione

Carica nella risorsa il file locale specificato come operazione asincrona utilizzando un oggetto attività.Uploads the specified local file to a resource as an asynchronous operation using a task object. Questi metodi non bloccano il thread chiamante.These methods do not block the calling thread.

Overload

UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String)

Carica nella risorsa il file locale specificato come operazione asincrona utilizzando un oggetto attività.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String)

Carica nella risorsa il file locale specificato come operazione asincrona utilizzando un oggetto attività.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String)

Carica nella risorsa il file locale specificato come operazione asincrona utilizzando un oggetto attività.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String)

Carica nella risorsa il file locale specificato come operazione asincrona utilizzando un oggetto attività.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String)

Carica nella risorsa il file locale specificato come operazione asincrona utilizzando un oggetto attività.Uploads the specified local file to a resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);
[System.Runtime.InteropServices.ComVisible(false)]
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())

Parametri

address
Uri Uri Uri Uri

L'URI della risorsa per ricevere il file.The URI of the resource to receive the file. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String String String String

Il metodo utilizzato per inviare i dati alla risorsa.The method used to send the data to the resource. Se null l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

fileName
String String String String

Il file locale da inviare alla risorsa.The local file to send to the resource.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce una matrice Byte contenente il corpo della risposta ricevuta dalla risorsa dopo il caricamento del file.The Result property on the task object returns a Byte array containing the body of the response received from the resource when the file was uploaded.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- fileName è null, è Empty, contiene caratteri non validi oppure il percorso specificato del file non esiste.fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

In alternativa-or- Si è verificato un errore durante l'apertura del flusso.An error occurred while opening the stream.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- L'intestazione Content-type inizia con multipart.The Content-type header begins with multipart.

Commenti

Questa operazione non verrà bloccata.This operation will not block. L'oggetto restituito Task<TResult> oggetto verrà completato dopo che il file è stato caricato nella risorsa.The returned Task<TResult> object will complete after the file has been uploaded to the resource. Il file viene inviato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

Operazioni asincrone che non sono stati completati possono essere annullate utilizzando il CancelAsync (metodo).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Se il BaseAddress proprietà non è una stringa vuota (""), address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Per impostazione predefinita, questo metodo Usa il comando STOR per caricare una risorsa di FTP.BY default, this method uses the STOR command to upload an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo POST.For an HTTP resource, the POST method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String)

Carica nella risorsa il file locale specificato come operazione asincrona utilizzando un oggetto attività.Uploads the specified local file to a resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ method, System::String ^ fileName);
[System.Runtime.InteropServices.ComVisible(false)]
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())

Parametri

address
String String String String

L'URI della risorsa per ricevere il file.The URI of the resource to receive the file. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String String String String

Il metodo utilizzato per inviare i dati alla risorsa.The method used to send the data to the resource. Se null l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

fileName
String String String String

Il file locale da inviare alla risorsa.The local file to send to the resource.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce una matrice Byte contenente il corpo della risposta ricevuta dalla risorsa dopo il caricamento del file.The Result property on the task object returns a Byte array containing the body of the response received from the resource when the file was uploaded.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- fileName è null, è Empty, contiene caratteri non validi oppure il percorso specificato del file non esiste.fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

In alternativa-or- Si è verificato un errore durante l'apertura del flusso.An error occurred while opening the stream.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- L'intestazione Content-type inizia con multipart.The Content-type header begins with multipart.

Commenti

Questa operazione non verrà bloccata.This operation will not block. L'oggetto restituito Task<TResult> oggetto verrà completato dopo che il file è stato caricato nella risorsa.The returned Task<TResult> object will complete after the file has been uploaded to the resource. Il file viene inviato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

Operazioni asincrone che non sono stati completati possono essere annullate utilizzando il CancelAsync (metodo).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Se il BaseAddress proprietà non è una stringa vuota (""), address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Per impostazione predefinita, questo metodo Usa il comando STOR per caricare una risorsa di FTP.BY default, this method uses the STOR command to upload an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo POST.For an HTTP resource, the POST method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String)

Carica nella risorsa il file locale specificato come operazione asincrona utilizzando un oggetto attività.Uploads the specified local file to a resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ fileName);
[System.Runtime.InteropServices.ComVisible(false)]
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())

Parametri

address
String String String String

L'URI della risorsa per ricevere il file.The URI of the resource to receive the file. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

fileName
String String String String

Il file locale da inviare alla risorsa.The local file to send to the resource.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce una matrice Byte contenente il corpo della risposta ricevuta dalla risorsa dopo il caricamento del file.The Result property on the task object returns a Byte array containing the body of the response received from the resource when the file was uploaded.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- fileName è null, è Empty, contiene caratteri non validi oppure il percorso specificato del file non esiste.fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

In alternativa-or- Si è verificato un errore durante l'apertura del flusso.An error occurred while opening the stream.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- L'intestazione Content-type inizia con multipart.The Content-type header begins with multipart.

Commenti

Questa operazione non verrà bloccata.This operation will not block. L'oggetto restituito Task<TResult> oggetto verrà completato dopo che il file è stato caricato nella risorsa.The returned Task<TResult> object will complete after the file has been uploaded to the resource. Il file viene inviato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

Operazioni asincrone che non sono stati completati possono essere annullate utilizzando il CancelAsync (metodo).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Se il BaseAddress proprietà non è una stringa vuota (""), address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Questo metodo Usa il comando STOR per caricare una risorsa di FTP.This method uses the STOR command to upload an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo POST.For an HTTP resource, the POST method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String)

Carica nella risorsa il file locale specificato come operazione asincrona utilizzando un oggetto attività.Uploads the specified local file to a resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ fileName);
[System.Runtime.InteropServices.ComVisible(false)]
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())

Parametri

address
Uri Uri Uri Uri

L'URI della risorsa per ricevere il file.The URI of the resource to receive the file. Per le risorse HTTP, questo URI deve identificare una risorsa che può accettare una richiesta inviata con il metodo POST, ad esempio uno script o una pagina ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

fileName
String String String String

Il file locale da inviare alla risorsa.The local file to send to the resource.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce una matrice Byte contenente il corpo della risposta ricevuta dalla risorsa dopo il caricamento del file.The Result property on the task object returns a Byte array containing the body of the response received from the resource when the file was uploaded.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- fileName è null, è Empty, contiene caratteri non validi oppure il percorso specificato del file non esiste.fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

In alternativa-or- Si è verificato un errore durante l'apertura del flusso.An error occurred while opening the stream.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- L'intestazione Content-type inizia con multipart.The Content-type header begins with multipart.

Commenti

Questa operazione non verrà bloccata.This operation will not block. L'oggetto restituito Task<TResult> oggetto verrà completato dopo che il file è stato caricato nella risorsa.The returned Task<TResult> object will complete after the file has been uploaded to the resource. Il file viene inviato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

Operazioni asincrone che non sono stati completati possono essere annullate utilizzando il CancelAsync (metodo).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Se il BaseAddress proprietà non è una stringa vuota (""), address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Questo metodo Usa il comando STOR per caricare una risorsa di FTP.This method uses the STOR command to upload an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo POST.For an HTTP resource, the POST method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Si applica a