WebClient.OpenWriteAsync WebClient.OpenWriteAsync WebClient.OpenWriteAsync WebClient.OpenWriteAsync Method

Definizione

Apre un flusso per la scrittura di dati nella risorsa specificata.Opens a stream for writing data to the specified resource. Questi metodi non bloccano il thread chiamante.These methods do not block the calling thread.

Overload

OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object)

Apre un flusso per la scrittura dei dati nella risorsa specificata utilizzando il metodo specificato.Opens a stream for writing data to the specified resource, using the specified method. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String)

Apre un flusso per la scrittura di dati nella risorsa specificata.Opens a stream for writing data to the specified resource. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

OpenWriteAsync(Uri) OpenWriteAsync(Uri) OpenWriteAsync(Uri) OpenWriteAsync(Uri)

Apre un flusso per la scrittura di dati nella risorsa specificata.Opens a stream for writing data to the specified resource. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object)

Apre un flusso per la scrittura dei dati nella risorsa specificata utilizzando il metodo specificato.Opens a stream for writing data to the specified resource, using the specified method. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method, System::Object ^ userToken);
public void OpenWriteAsync (Uri address, string method, object userToken);
member this.OpenWriteAsync : Uri * string * obj -> unit
Public Sub OpenWriteAsync (address As Uri, method As String, userToken As Object)

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.

userToken
Object Object Object Object

Oggetto definito dall'utente passato al metodo richiamato al completamento dell'operazione asincronaA 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.

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

Commenti

Questo metodo recupera un flusso scrivibile che viene usato per inviare dati a una risorsa.This method retrieves a writable stream that is used to send data to a resource. Il flusso viene recuperato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The stream is retrieved asynchronously using thread resources that are automatically allocated from the thread pool. Per ricevere notifica quando il flusso è disponibile, aggiungere un gestore eventi per il OpenWriteCompleted evento.To receive notification when the stream is available, add an event handler to the OpenWriteCompleted event. Il contenuto del flusso viene inviato al server quando si chiude il flusso.The contents of the stream are sent to the server when you close the stream.

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.

Questo metodo non blocca il thread chiamante durante il flusso viene aperto.This method does not block the calling thread while the stream is being opened. Per bloccare l'attesa per il flusso, usare uno del OpenWrite metodi.To block while waiting for the stream, use one of the OpenWrite methods.

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.

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.

OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String)

Apre un flusso per la scrittura di dati nella risorsa specificata.Opens a stream for writing data to the specified resource. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method);
public void OpenWriteAsync (Uri address, string method);
member this.OpenWriteAsync : Uri * string -> unit
Public Sub OpenWriteAsync (address As Uri, method As String)

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.

Eccezioni

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

Commenti

Questo metodo recupera un flusso scrivibile che viene usato per inviare dati a una risorsa.This method retrieves a writable stream that is used to send data to a resource. Il flusso viene recuperato utilizzando le risorse di thread che vengono allocate automaticamente dal pool di thread.The stream is retrieved using thread resources that are automatically allocated from the thread pool. Per ricevere notifica quando il flusso è disponibile, aggiungere un gestore eventi per il OpenWriteCompleted evento.To receive notification when the stream is available, add an event handler to the OpenWriteCompleted event. Quando si chiude il flusso, il thread si blocca fino a quando la richiesta viene inviata a address e viene ricevuta una risposta.When you close the stream, the thread blocks until the request is sent to address and a response is received.

Questo metodo non blocca il thread chiamante durante il flusso viene aperto.This method does not block the calling thread while the stream is being opened. Per bloccare l'attesa per il flusso, usare uno del OpenWrite metodi.To block while waiting for the stream, use one of the OpenWrite methods.

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.

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.

OpenWriteAsync(Uri) OpenWriteAsync(Uri) OpenWriteAsync(Uri) OpenWriteAsync(Uri)

Apre un flusso per la scrittura di dati nella risorsa specificata.Opens a stream for writing data to the specified resource. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

public:
 void OpenWriteAsync(Uri ^ address);
public void OpenWriteAsync (Uri address);
member this.OpenWriteAsync : Uri -> unit
Public Sub OpenWriteAsync (address As Uri)

Parametri

address
Uri Uri Uri Uri

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

Eccezioni

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

Commenti

Questo metodo recupera un flusso scrivibile che viene usato per inviare dati a una risorsa.This method retrieves a writable stream that is used to send data to a resource. Il flusso viene recuperato utilizzando le risorse di thread che vengono allocate automaticamente dal pool di thread.The stream is retrieved using thread resources that are automatically allocated from the thread pool. Per ricevere notifica quando il flusso è disponibile, aggiungere un gestore eventi per il OpenWriteCompleted evento.To receive notification when the stream is available, add an event handler to the OpenWriteCompleted event. Quando si chiude il flusso, il thread si blocca fino a quando la richiesta viene inviata a address e viene ricevuta una risposta.When you close the stream, the thread blocks until the request is sent to address and a response is received.

Questo metodo non blocca il thread chiamante durante il flusso viene aperto.This method does not block the calling thread while the stream is being opened. Per bloccare l'attesa per il flusso, usare uno del OpenWrite metodi.To block while waiting for the stream, use one of the OpenWrite methods.

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.

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