WebClient.OpenWriteTaskAsync WebClient.OpenWriteTaskAsync WebClient.OpenWriteTaskAsync WebClient.OpenWriteTaskAsync Method

Definizione

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona utilizzando un oggetto attività.Opens a stream for writing data to the specified 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

OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String)

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona utilizzando un oggetto attività.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri)

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona utilizzando un oggetto attività.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String)

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona utilizzando un oggetto attività.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String)

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona utilizzando un oggetto attività.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String)

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona utilizzando un oggetto attività.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);
member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)

Parametri

address
String String String String

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

Restituisce

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce un oggetto Stream utilizzato per scrivere i dati in una risorsa.The Result property on the task object returns a Stream used to write data 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.

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

Commenti

Questa operazione non verrà bloccata.This operation will not block. L'oggetto restituito Task<TResult> oggetto verrà completata dopo di un flusso accessibile in scrittura alla risorsa di dati è stata aperta.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Questo metodo non blocca il thread chiamante mentre viene aperto il flusso.This method does not block the calling thread while the stream is opening.

Questo metodo recupera un Stream utilizzato per scrivere i dati alla risorsa specificata dall'istanza di address parametro.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Il flusso viene ottenuto utilizzando le risorse del thread allocate automaticamente dal pool di thread.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Nota

È necessario chiamare Stream.Close al termine con il Stream per evitare di esaurire le risorse di sistema.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

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 ("") e address non contiene un URI assoluto 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 ("") 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 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.

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.

Vedi anche

OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri)

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona utilizzando un oggetto attività.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);
member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)

Parametri

address
Uri Uri Uri Uri

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

Restituisce

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce un oggetto Stream utilizzato per scrivere i dati in una risorsa.The Result property on the task object returns a Stream used to write data 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.

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

Commenti

Questa operazione non verrà bloccata.This operation will not block. L'oggetto restituito Task<TResult> oggetto verrà completata dopo di un flusso accessibile in scrittura alla risorsa di dati è stata aperta.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Questo metodo non blocca il thread chiamante mentre viene aperto il flusso.This method does not block the calling thread while the stream is opening.

Questo metodo recupera un Stream utilizzato per scrivere i dati alla risorsa specificata dall'istanza di address parametro.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Il flusso viene ottenuto utilizzando le risorse del thread allocate automaticamente dal pool di thread.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Nota

È necessario chiamare Stream.Close al termine con il Stream per evitare di esaurire le risorse di sistema.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

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 ("") e address non contiene un URI assoluto 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 ("") 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 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.

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.

OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String)

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona utilizzando un oggetto attività.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address, System::String ^ method);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string method);
member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)

Parametri

address
String String String String

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

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 il valore è null, l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

Restituisce

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce un oggetto Stream utilizzato per scrivere i dati in una risorsa.The Result property on the task object returns a Stream used to write data 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.

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

Commenti

Questa operazione non verrà bloccata.This operation will not block. L'oggetto restituito Task<TResult> oggetto verrà completata dopo di un flusso accessibile in scrittura alla risorsa di dati è stata aperta.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Questo metodo non blocca il thread chiamante mentre viene aperto il flusso.This method does not block the calling thread while the stream is opening.

Questo metodo recupera un Stream utilizzato per scrivere i dati alla risorsa specificata dall'istanza di address parametro.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Il flusso viene ottenuto utilizzando le risorse del thread allocate automaticamente dal pool di thread.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Nota

È necessario chiamare Stream.Close al termine con il Stream per evitare di esaurire le risorse di sistema.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Se il method parametro specifica un metodo che non è accettato dal server, le classi del protocollo sottostante è determineranno il risultato.If the method parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. In genere, un WebException viene generata un'eccezione con il Status proprietà impostata per indicare l'errore.Typically, a WebException is thrown with the Status property set to indicate the error.

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 ("") e address non contiene un URI assoluto 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 ("") 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 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.

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.

Vedi anche

OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String)

Apre un flusso per la scrittura di dati alla risorsa specificata come operazione asincrona utilizzando un oggetto attività.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address, System::String ^ method);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string method);
member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)

Parametri

address
Uri Uri Uri Uri

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

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 il valore è null, l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

Restituisce

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation. La proprietà Result nell'oggetto attività restituisce un oggetto Stream utilizzato per scrivere i dati in una risorsa.The Result property on the task object returns a Stream used to write data 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.

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

Commenti

Questa operazione non verrà bloccata.This operation will not block. L'oggetto restituito Task<TResult> oggetto verrà completata dopo di un flusso accessibile in scrittura alla risorsa di dati è stata aperta.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Questo metodo non blocca il thread chiamante mentre viene aperto il flusso.This method does not block the calling thread while the stream is opening.

Questo metodo recupera un Stream utilizzato per scrivere i dati alla risorsa specificata dall'istanza di address parametro.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Il flusso viene ottenuto utilizzando le risorse del thread allocate automaticamente dal pool di thread.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Nota

È necessario chiamare Stream.Close al termine con il Stream per evitare di esaurire le risorse di sistema.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Se il method parametro specifica un metodo che non è accettato dal server, le classi del protocollo sottostante è determineranno il risultato.If the method parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. In genere, un WebException viene generata un'eccezione con il Status proprietà impostata per indicare l'errore.Typically, a WebException is thrown with the Status property set to indicate the error.

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 ("") e address non contiene un URI assoluto 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 ("") 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 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.

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.

Vedi anche

Si applica a