WebClient.UploadDataAsync Metodo

Definizione

Carica un buffer di dati in una risorsa identificata da un URI.Uploads a data buffer to a resource identified by a URI. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

Overload

UploadDataAsync(Uri, String, Byte[])

Carica un buffer di dati in una risorsa identificata da un URI, utilizzando il metodo specificato.Uploads a data buffer to a resource identified by a URI, using the specified method. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

UploadDataAsync(Uri, String, Byte[], Object)

Carica un buffer di dati in una risorsa identificata da un URI, utilizzando il metodo specificato e un token di identificazione.Uploads a data buffer to a resource identified by a URI, using the specified method and identifying token.

UploadDataAsync(Uri, Byte[])

Carica un buffer di dati in una risorsa identificata da un URI utilizzando il metodo POST.Uploads a data buffer to a resource identified by a URI, using the POST method. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

UploadDataAsync(Uri, String, Byte[])

Carica un buffer di dati in una risorsa identificata da un URI, utilizzando il metodo specificato.Uploads a data buffer to a resource identified by a URI, using the specified method. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public void UploadDataAsync (Uri address, string? method, byte[] data);
public void UploadDataAsync (Uri address, string method, byte[] data);
member this.UploadDataAsync : Uri * string * byte[] -> unit
Public Sub UploadDataAsync (address As Uri, method As String, data As Byte())

Parametri

address
Uri

L'URI della risorsa per ricevere i dati.The URI of the resource to receive the data.

method
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.

data
Byte[]

Il buffer di dati da inviare alla risorsa.The data buffer to send to the resource.

Eccezioni

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

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

-oppure--or-

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

-oppure--or-

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

Commenti

Questo metodo invia un buffer di dati a una risorsa.This method sends a data buffer to a resource. Il buffer dei dati viene inviato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. I dati non sono codificati.The data is not encoded. Per ricevere una notifica al termine del caricamento dei dati, aggiungere un gestore eventi all' UploadDataCompleted evento.To receive notification when the data upload completes, add an event handler to the UploadDataCompleted event.

Questo metodo non blocca il thread chiamante durante l'invio dei dati.This method does not block the calling thread while the data is being sent. Per inviare dati e bloccarsi durante l'attesa della risposta del server, usare uno dei UploadData metodi.To send data and block while waiting for the server's response, use one of the UploadData methods.

In .NET Framework e .NET Core 1,0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il CancelAsync metodo.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

Se la BaseAddress proprietà non è una stringa vuota ("") e non address contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string (""), and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address .If the QueryString property is not an empty string, it is appended to address.

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 ulteriori informazioni, vedere la pagina relativa alla traccia di rete in .NET Framework.For more information, see Network Tracing in .NET Framework.

Si applica a

UploadDataAsync(Uri, String, Byte[], Object)

Carica un buffer di dati in una risorsa identificata da un URI, utilizzando il metodo specificato e un token di identificazione.Uploads a data buffer to a resource identified by a URI, using the specified method and identifying token.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);
public void UploadDataAsync (Uri address, string? method, byte[] data, object? userToken);
public void UploadDataAsync (Uri address, string method, byte[] data, object userToken);
member this.UploadDataAsync : Uri * string * byte[] * obj -> unit
Public Sub UploadDataAsync (address As Uri, method As String, data As Byte(), userToken As Object)

Parametri

address
Uri

L'URI della risorsa per ricevere i dati.The URI of the resource to receive the data.

method
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.

data
Byte[]

Il buffer di dati da inviare alla risorsa.The data buffer to send to the resource.

userToken
Object

Oggetto definito dall'utente passato al metodo richiamato al completamento dell'operazione asincrona.A user-defined object that is passed to the method invoked when the asynchronous operation completes.

Eccezioni

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

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

-oppure--or-

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

-oppure--or-

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

Commenti

Questo metodo invia un buffer di dati a una risorsa.This method sends a data buffer to a resource. Il buffer dei dati viene inviato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. I dati non sono codificati.The data is not encoded. Per ricevere una notifica al termine del caricamento dei dati, aggiungere un gestore eventi all' UploadDataCompleted evento.To receive notification when the data upload completes, add an event handler to the UploadDataCompleted event.

Questo metodo non blocca il thread chiamante durante l'invio dei dati.This method does not block the calling thread while the data is being sent. Per inviare dati e bloccarsi durante l'attesa della risposta del server, usare uno dei UploadData metodi.To send data and block while waiting for the server's response, use one of the UploadData methods.

In .NET Framework e .NET Core 1,0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il CancelAsync metodo.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

Se la BaseAddress proprietà non è una stringa vuota ("") e non address contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string (""), and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address .If the QueryString property is not an empty string, it is appended to address.

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 ulteriori informazioni, vedere la pagina relativa alla traccia di rete in .NET Framework.For more information, see Network Tracing in .NET Framework.

Si applica a

UploadDataAsync(Uri, Byte[])

Carica un buffer di dati in una risorsa identificata da un URI utilizzando il metodo POST.Uploads a data buffer to a resource identified by a URI, using the POST method. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

public:
 void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);
public void UploadDataAsync (Uri address, byte[] data);
member this.UploadDataAsync : Uri * byte[] -> unit
Public Sub UploadDataAsync (address As Uri, data As Byte())

Parametri

address
Uri

L'URI della risorsa per ricevere i dati.The URI of the resource to receive the data.

data
Byte[]

Il buffer di dati da inviare alla risorsa.The data buffer to send to the resource.

Eccezioni

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

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

-oppure--or-

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

-oppure--or-

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

Commenti

Questo metodo invia un buffer di dati a una risorsa.This method sends a data buffer to a resource. Il buffer dei dati viene inviato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. I dati non sono codificati.The data is not encoded. Per ricevere una notifica al termine del caricamento dei dati, aggiungere un gestore eventi all' UploadDataCompleted evento.To receive notification when the data upload completes, add an event handler to the UploadDataCompleted event.

Questo metodo non blocca il thread chiamante durante l'invio dei dati.This method does not block the calling thread while the data is being sent. Per inviare dati e bloccarsi durante l'attesa della risposta del server, usare uno dei UploadData metodi.To send data and block while waiting for the server's response, use one of the UploadData methods.

In .NET Framework e .NET Core 1,0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il CancelAsync metodo.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

Se la BaseAddress proprietà non è una stringa vuota ("") e non address contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string (""), and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se la QueryString proprietà non è una stringa vuota, viene aggiunta 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 FTP.This method uses the STOR command to upload an FTP resource. Per una risorsa HTTP, viene usato 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 ulteriori informazioni, vedere la pagina relativa alla traccia di rete in .NET Framework.For more information, see Network Tracing in .NET Framework.

Si applica a