WebClient.UploadDataAsync Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Carica un buffer di dati in una risorsa identificata da un URI. Questo metodo non blocca il thread chiamante.

Overload

UploadDataAsync(Uri, String, Byte[])	Carica un buffer di dati in una risorsa identificata da un URI, utilizzando il metodo specificato. Questo metodo non blocca il thread chiamante.
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.
UploadDataAsync(Uri, Byte[])	Carica un buffer di dati in una risorsa identificata da un URI utilizzando il metodo POST. Questo metodo non blocca il thread chiamante.

UploadDataAsync(Uri, String, Byte[])

Source:

WebClient.cs

Carica un buffer di dati in una risorsa identificata da un URI, utilizzando il metodo specificato. Questo metodo non blocca il thread chiamante.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::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.

method

String

Il metodo utilizzato per inviare i dati alla risorsa. Se null l'impostazione predefinita sarà POST per http e STOR per ftp.

data

Byte[]

Il buffer di dati da inviare alla risorsa.

Eccezioni

ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI ottenuto combinando BaseAddress e address non è valido.

-oppure-

Si è verificato un errore durante l'apertura del flusso.

-oppure-

Nessuna risposta dal server che ospita la risorsa.

Commenti

Questo metodo invia un buffer dati a una risorsa. Il buffer dei dati viene inviato in modo asincrono usando le risorse del thread allocate automaticamente dal pool di thread. I dati non vengono codificati. Per ricevere una notifica al completamento del caricamento dei dati, aggiungere un gestore eventi all'evento UploadDataCompleted .

Questo metodo non blocca il thread chiamante mentre i dati vengono inviati. Per inviare dati e bloccare durante l'attesa della risposta del server, usare uno dei UploadData metodi.

In .NET Framework e .NET Core 1.0 è possibile annullare le operazioni asincrone non completate chiamando il CancelAsync metodo .

Se la BaseAddress proprietà non è una stringa vuota (""), e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da UploadData(Uri, String, Byte[]).

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

Source:

WebClient.cs

Carica un buffer di dati in una risorsa identificata da un URI, utilizzando il metodo specificato e un token di identificazione.

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

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.

method

String

Il metodo utilizzato per inviare i dati alla risorsa. Se null l'impostazione predefinita sarà POST per http e STOR per ftp.

data

Byte[]

Il buffer di dati da inviare alla risorsa.

userToken

Object

Oggetto definito dall'utente passato al metodo richiamato al completamento dell'operazione asincrona.

Eccezioni

ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI ottenuto combinando BaseAddress e address non è valido.

-oppure-

Si è verificato un errore durante l'apertura del flusso.

-oppure-

Nessuna risposta dal server che ospita la risorsa.

Commenti

Questo metodo invia un buffer dati a una risorsa. Il buffer dei dati viene inviato in modo asincrono usando le risorse del thread allocate automaticamente dal pool di thread. I dati non vengono codificati. Per ricevere una notifica al completamento del caricamento dei dati, aggiungere un gestore eventi all'evento UploadDataCompleted .

Questo metodo non blocca il thread chiamante mentre i dati vengono inviati. Per inviare dati e bloccare durante l'attesa della risposta del server, usare uno dei UploadData metodi.

In .NET Framework e .NET Core 1.0 è possibile annullare le operazioni asincrone non completate chiamando il CancelAsync metodo .

Se la BaseAddress proprietà non è una stringa vuota (""), e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

UploadDataAsync(Uri, Byte[])

Source:

WebClient.cs

Carica un buffer di dati in una risorsa identificata da un URI utilizzando il metodo POST. Questo metodo non blocca il thread chiamante.

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.

data

Byte[]

Il buffer di dati da inviare alla risorsa.

Eccezioni

ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI ottenuto combinando BaseAddress e address non è valido.

-oppure-

Si è verificato un errore durante l'apertura del flusso.

-oppure-

Nessuna risposta dal server che ospita la risorsa.

Commenti

Questo metodo invia un buffer dati a una risorsa. Il buffer dei dati viene inviato in modo asincrono usando le risorse del thread allocate automaticamente dal pool di thread. I dati non vengono codificati. Per ricevere una notifica al completamento del caricamento dei dati, aggiungere un gestore eventi all'evento UploadDataCompleted .

Questo metodo non blocca il thread chiamante mentre i dati vengono inviati. Per inviare dati e bloccare durante l'attesa della risposta del server, usare uno dei UploadData metodi.

In .NET Framework e .NET Core 1.0 è possibile annullare le operazioni asincrone non completate chiamando il CancelAsync metodo .

Se la BaseAddress proprietà non è una stringa vuota (""), e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address.

Questo metodo usa il comando STOR per caricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo POST.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da UploadData(Uri, Byte[]).