WebClient.OpenWrite Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Apre un flusso per la scrittura di dati in una risorsa con l'URI specificato.

Overload

OpenWrite(String)	Apre un flusso per la scrittura di dati nella risorsa specificata.
OpenWrite(Uri)	Apre un flusso per la scrittura di dati nella risorsa specificata.
OpenWrite(String, String)	Apre un flusso per la scrittura di dati nella risorsa specificata utilizzando il metodo specificato.
OpenWrite(Uri, String)	Apre un flusso per la scrittura di dati nella risorsa specificata utilizzando il metodo specificato.

OpenWrite(String)

Origine:

WebClient.cs

Apre un flusso per la scrittura di dati nella risorsa specificata.

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

URI della risorsa per ricevere i dati.

Restituisce

Stream

Oggetto Stream utilizzato per scrivere dati nella risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

Errore durante l'apertura del flusso.

Esempio

L'esempio di codice seguente legge i dati dalla riga di comando e usa OpenWrite per ottenere un flusso per la scrittura dei dati. Il Stream restituito da OpenWrite viene chiuso dopo l'invio dei dati.

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

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo OpenWrite restituisce un flusso scrivibile utilizzato per inviare dati a una risorsa. Questo metodo si blocca durante l'apertura del flusso. Per continuare l'esecuzione durante l'attesa del flusso, usare uno dei metodi di OpenWriteAsync.

Se la proprietà BaseAddress 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 proprietà QueryString 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 restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

OpenWrite(Uri)

Origine:

WebClient.cs

Apre un flusso per la scrittura di dati nella risorsa specificata.

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 della risorsa per ricevere i dati.

Restituisce

Stream

Oggetto Stream utilizzato per scrivere dati nella risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

Errore durante l'apertura del flusso.

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo OpenWrite restituisce un flusso scrivibile utilizzato per inviare dati a una risorsa. Questo metodo si blocca durante l'apertura del flusso. Per continuare l'esecuzione durante l'attesa del flusso, usare uno dei metodi di OpenWriteAsync.

Se la proprietà BaseAddress 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 proprietà QueryString 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 restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

OpenWrite(String, String)

Origine:

WebClient.cs

Apre un flusso per la scrittura di dati nella risorsa specificata utilizzando il metodo specificato.

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

URI della risorsa per ricevere i dati.

method

String

Metodo utilizzato per inviare i dati alla risorsa. Se null, il valore predefinito è POST per http e STOR per ftp.

Restituisce

Stream

Oggetto Stream utilizzato per scrivere dati nella risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

Errore durante l'apertura del flusso.

Esempio

L'esempio di codice seguente legge i dati dalla riga di comando e usa OpenWrite per ottenere un flusso usato per scrivere i dati. Il Stream restituito da OpenWrite deve essere chiuso per inviare i dati.

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

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo OpenWrite restituisce un flusso scrivibile utilizzato per inviare dati a una risorsa. La richiesta sottostante viene effettuata con il metodo specificato nel parametro method. I dati vengono inviati al server quando si chiude il flusso. Questo metodo si blocca durante l'apertura del flusso. Per continuare l'esecuzione durante l'attesa del flusso, usare uno dei metodi di OpenWriteAsync.

Se il parametro method specifica un metodo non compreso dal server, le classi di protocollo sottostanti determinano cosa accade. In genere, viene generata una WebException con la proprietà Status impostata per indicare l'errore.

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

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

OpenWrite(Uri, String)

Origine:

WebClient.cs

Apre un flusso per la scrittura di dati nella risorsa specificata utilizzando il metodo specificato.

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 della risorsa per ricevere i dati.

method

String

Metodo utilizzato per inviare i dati alla risorsa. Se null, il valore predefinito è POST per http e STOR per ftp.

Restituisce

Stream

Oggetto Stream utilizzato per scrivere dati nella risorsa.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

L'URI formato dalla combinazione di BaseAddresse address non è valido.

-o-

Errore durante l'apertura del flusso.

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo OpenWrite restituisce un flusso scrivibile utilizzato per inviare dati a una risorsa. Questo metodo si blocca durante l'apertura del flusso. Per continuare l'esecuzione durante l'attesa del flusso, usare uno dei metodi di OpenWriteAsync.

Se la proprietà BaseAddress 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 proprietà QueryString non è una stringa vuota, viene aggiunta a address.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.