WebClient.OpenWrite WebClient.OpenWrite WebClient.OpenWrite WebClient.OpenWrite Method

Definizione

Apre un flusso per la scrittura di dati su una risorsa con l'URI specificato.Opens a stream for writing data to a resource with the specified URI.

Overload

OpenWrite(String) OpenWrite(String) OpenWrite(String) OpenWrite(String)

Apre un flusso per la scrittura di dati nella risorsa specificata.Opens a stream for writing data to the specified resource.

OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri)

Apre un flusso per la scrittura di dati nella risorsa specificata.Opens a stream for writing data to the specified resource.

OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String)

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.

OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String)

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, by using the specified method.

OpenWrite(String) OpenWrite(String) OpenWrite(String) OpenWrite(String)

Apre un flusso per la scrittura di dati nella risorsa specificata.Opens a stream for writing data to the specified resource.

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address);
public System.IO.Stream OpenWrite (string address);
member this.OpenWrite : string -> System.IO.Stream
Public Function OpenWrite (address As String) As 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

Un Stream utilizzato per scrivere i dati nella risorsa.A Stream used to write data to the resource.

Eccezioni

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

L'URI composto dalla combinazione di 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.

Esempi

Esempio di codice seguente legge i dati dalla riga di comando e Usa OpenWrite per ottenere un flusso per la scrittura dei dati.The following code example reads data from the command line and uses OpenWrite to obtain a stream for writing the data. Si noti che il Stream restituito da OpenWrite viene chiusa dopo l'invio dei dati.Note that the Stream returned by OpenWrite is closed after the data is sent.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply Ascii Encoding to obtain an array of bytes.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

// postStream implicitly sets HTTP POST as the request method.
Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString );

postStream->Write( postArray, 0, postArray->Length );

// Close the stream and release resources.
postStream->Close();

Console::WriteLine( "\nSuccessfully posted the data." );
string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply Ascii Encoding to obtain an array of bytes. 
byte[] postArray = Encoding.ASCII.GetBytes(postData);

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

// postStream implicitly sets HTTP POST as the request method.
Console.WriteLine("Uploading to {0} ...",  uriString);							Stream postStream = myWebClient.OpenWrite(uriString);

postStream.Write(postArray,0,postArray.Length);

// Close the stream and release resources.
postStream.Close();

Console.WriteLine("\nSuccessfully posted the data.");
Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)

Dim postData As String = Console.ReadLine()

' Apply ASCII Encoding to obtain an array of bytes .
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine("Uploading to {0} ...", uriString)

' OpenWrite implicitly sets HTTP POST as the request method.
Dim postStream As Stream = myWebClient.OpenWrite(uriString)
postStream.Write(postArray, 0, postArray.Length)

' Close the stream and release resources.
postStream.Close()

Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")

Commenti

Il OpenWrite metodo restituisce un flusso scrivibile che viene usato per inviare dati a una risorsa.The OpenWrite method returns a writable stream that is used to send data to a resource. Questo metodo si blocca durante l'apertura del flusso.This method blocks while opening the stream. Per continuare l'esecuzione durante l'attesa per il flusso, utilizzare uno del OpenWriteAsync metodi.To continue executing while waiting for the stream, use one of the OpenWriteAsync 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.

OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri)

Apre un flusso per la scrittura di dati nella risorsa specificata.Opens a stream for writing data to the specified resource.

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address);
public System.IO.Stream OpenWrite (Uri address);
member this.OpenWrite : Uri -> System.IO.Stream
Public Function OpenWrite (address As Uri) As 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

Un Stream utilizzato per scrivere i dati nella risorsa.A Stream used to write data to the resource.

Eccezioni

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

L'URI composto dalla combinazione di 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

Il OpenWrite metodo restituisce un flusso scrivibile che viene usato per inviare dati a una risorsa.The OpenWrite method returns a writable stream that is used to send data to a resource. Questo metodo si blocca durante l'apertura del flusso.This method blocks while opening the stream. Per continuare l'esecuzione durante l'attesa per il flusso, utilizzare uno del OpenWriteAsync metodi.To continue executing while waiting for the stream, use one of the OpenWriteAsync 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.

OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String)

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.

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address, System::String ^ method);
public System.IO.Stream OpenWrite (string address, string method);
member this.OpenWrite : string * string -> System.IO.Stream
Public Function OpenWrite (address As String, method As String) As 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

Un Stream utilizzato per scrivere i dati nella risorsa.A Stream used to write data to the resource.

Eccezioni

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

L'URI composto dalla combinazione di 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.

Esempi

Esempio di codice seguente legge i dati dalla riga di comando e Usa OpenWrite per ottenere un flusso usato per scrivere i dati.The following code example reads data from the command line and uses OpenWrite to obtain a stream used to write the data. Si noti che il Stream restituito da OpenWrite deve essere chiuso per inviare i dati.Note that the Stream returned by OpenWrite must be closed to send the data.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString, "POST" );
postStream->Write( postArray, 0, postArray->Length );

// Close the stream and release resources.
postStream->Close();
Console::WriteLine( "\nSuccessfully posted the data." );
string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
byte[] postArray = Encoding.ASCII.GetBytes(postData);

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("Uploading to {0} ...",  uriString);						
Stream postStream = myWebClient.OpenWrite(uriString,"POST");
postStream.Write(postArray,0,postArray.Length);

// Close the stream and release resources.
postStream.Close();
Console.WriteLine("\nSuccessfully posted the data.");
Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
' Apply ASCII encoding to obtain an array of bytes.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine("Uploading to {0} ...", uriString)
Dim postStream As Stream = myWebClient.OpenWrite(uriString, "POST")

postStream.Write(postArray, 0, postArray.Length)

' Close the stream and release resources.
postStream.Close()

Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")

Commenti

Il OpenWrite metodo restituisce un flusso scrivibile che viene usato per inviare dati a una risorsa.The OpenWrite method returns a writable stream that is used to send data to a resource. La richiesta sottostante viene eseguita con il metodo specificato nel method parametro.The underlying request is made with the method specified in the method parameter. I dati vengono inviati al server quando si chiude il flusso.The data is sent to the server when you close the stream. Questo metodo si blocca durante l'apertura del flusso.This method blocks while opening the stream. Per continuare l'esecuzione durante l'attesa per il flusso, utilizzare uno del OpenWriteAsync metodi.To continue executing while waiting for the stream, use one of the OpenWriteAsync methods.

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.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non specifica un indirizzo 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 specify an absolute address, 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.

OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String)

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, by using the specified method.

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address, System::String ^ method);
public System.IO.Stream OpenWrite (Uri address, string method);
member this.OpenWrite : Uri * string -> System.IO.Stream
Public Function OpenWrite (address As Uri, method As String) As 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

Un Stream utilizzato per scrivere i dati nella risorsa.A Stream used to write data to the resource.

Eccezioni

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

L'URI composto dalla combinazione di 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

Il OpenWrite metodo restituisce un flusso scrivibile che viene usato per inviare dati a una risorsa.The OpenWrite method returns a writable stream that is used to send data to a resource. Questo metodo si blocca durante l'apertura del flusso.This method blocks while opening the stream. Per continuare l'esecuzione durante l'attesa per il flusso, utilizzare uno del OpenWriteAsync metodi.To continue executing while waiting for the stream, use one of the OpenWriteAsync 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.

Si applica a