WebClient.OpenWrite Método

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.WebClient.dll

Abre um fluxo para gravar dados em um recurso com o URI especificado.

Sobrecargas

Nome	Description
OpenWrite(String)	Abre um fluxo para gravar dados no recurso especificado.
OpenWrite(Uri)	Abre um fluxo para gravar dados no recurso especificado.
OpenWrite(String, String)	Abre um fluxo para gravar dados no recurso especificado, usando o método especificado.
OpenWrite(Uri, String)	Abre um fluxo para gravar dados no recurso especificado usando o método especificado.

OpenWrite(String)

Origem:

WebClient.cs

Abre um fluxo para gravar dados no recurso especificado.

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

Parâmetros

address

String

O URI do recurso para receber os dados.

Retornos

Stream

Um Stream usado para gravar dados no recurso.

Exceções

ArgumentNullException

O address parâmetro é null.

WebException

O URI formado pela combinação BaseAddresse address é inválido.

-ou-

Erro ao abrir o fluxo.

Exemplos

O exemplo de código a seguir lê dados da linha de comando e usa OpenWrite para obter um fluxo para gravar os dados. O Stream retornado é OpenWrite fechado depois que os dados são enviados.

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.")

Comentários

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

O OpenWrite método retorna um fluxo gravável que é usado para enviar dados para um recurso. Esse método bloqueia ao abrir o fluxo. Para continuar a execução enquanto aguarda o fluxo, use um dos OpenWriteAsync métodos.

Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que seja combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Esse método usa o comando STOR para carregar um recurso FTP. Para um recurso HTTP, o método POST é usado.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

OpenWrite(Uri)

Origem:

WebClient.cs

Abre um fluxo para gravar dados no recurso especificado.

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

Parâmetros

address

Uri

O URI do recurso para receber os dados.

Retornos

Stream

Um Stream usado para gravar dados no recurso.

Exceções

ArgumentNullException

O address parâmetro é null.

WebException

O URI formado pela combinação BaseAddresse address é inválido.

-ou-

Erro ao abrir o fluxo.

Comentários

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

O OpenWrite método retorna um fluxo gravável que é usado para enviar dados para um recurso. Esse método bloqueia ao abrir o fluxo. Para continuar a execução enquanto aguarda o fluxo, use um dos OpenWriteAsync métodos.

Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que seja combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Esse método usa o comando STOR para carregar um recurso FTP. Para um recurso HTTP, o método POST é usado.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

OpenWrite(String, String)

Origem:

WebClient.cs

Abre um fluxo para gravar dados no recurso especificado, usando o método especificado.

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

Parâmetros

address

String

O URI do recurso para receber os dados.

method

String

O método usado para enviar os dados para o recurso. Se nulo, o padrão será POST para http e STOR para ftp.

Retornos

Stream

Um Stream usado para gravar dados no recurso.

Exceções

ArgumentNullException

O address parâmetro é null.

WebException

O URI formado pela combinação BaseAddresse address é inválido.

-ou-

Erro ao abrir o fluxo.

Exemplos

O exemplo de código a seguir lê dados da linha de comando e usa OpenWrite para obter um fluxo usado para gravar os dados. O Stream retornado deve OpenWrite ser fechado para enviar os dados.

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.")

Comentários

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

O OpenWrite método retorna um fluxo gravável que é usado para enviar dados para um recurso. A solicitação subjacente é feita com o método especificado no method parâmetro. Os dados são enviados ao servidor quando você fecha o fluxo. Esse método bloqueia ao abrir o fluxo. Para continuar a execução enquanto aguarda o fluxo, use um dos OpenWriteAsync métodos.

Se o method parâmetro especificar um método que não é compreendido pelo servidor, as classes de protocolo subjacentes determinam o que ocorre. Normalmente, um WebException é gerado com a Status propriedade definida para indicar o erro.

Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não especificar um endereço absoluto, address deverá ser um URI relativo que seja combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

OpenWrite(Uri, String)

Origem:

WebClient.cs

Abre um fluxo para gravar dados no recurso especificado usando o método especificado.

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

Parâmetros

address

Uri

O URI do recurso para receber os dados.

method

String

O método usado para enviar os dados para o recurso. Se nulo, o padrão será POST para http e STOR para ftp.

Retornos

Stream

Um Stream usado para gravar dados no recurso.

Exceções

ArgumentNullException

O address parâmetro é null.

WebException

O URI formado pela combinação BaseAddresse address é inválido.

-ou-

Erro ao abrir o fluxo.

Comentários

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

O OpenWrite método retorna um fluxo gravável que é usado para enviar dados para um recurso. Esse método bloqueia ao abrir o fluxo. Para continuar a execução enquanto aguarda o fluxo, use um dos OpenWriteAsync métodos.

Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo que seja combinado para BaseAddress formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.