Compartilhar via

WebClient.OpenWrite Método

  • Referência

Definição

Namespace:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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

Sobrecargas

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
Origem:
WebClient.cs
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 parâmetro address é null.

WebException

O URI formado pela combinação de 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 por OpenWrite é fechado após o envio dos 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;

// 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, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

O método OpenWrite 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 métodos OpenWriteAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString 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.

Aplica-se a

OpenWrite(Uri)

Origem:
WebClient.cs
Origem:
WebClient.cs
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 parâmetro address é null.

WebException

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

-ou-

Erro ao abrir o fluxo.

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

O método OpenWrite 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 métodos OpenWriteAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString 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.

Aplica-se a

OpenWrite(String, String)

Origem:
WebClient.cs
Origem:
WebClient.cs
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);
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 parâmetro address é null.

WebException

O URI formado pela combinação de 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. A Stream retornada por OpenWrite deve ser fechada 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, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

O método OpenWrite retorna um fluxo gravável que é usado para enviar dados para um recurso. A solicitação subjacente é feita com o método especificado no parâmetro method. 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 métodos OpenWriteAsync.

Se o parâmetro method 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 propriedade Status definida para indicar o erro.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não especificar um endereço absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString 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.

Aplica-se a

OpenWrite(Uri, String)

Origem:
WebClient.cs
Origem:
WebClient.cs
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);
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 parâmetro address é null.

WebException

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

-ou-

Erro ao abrir o fluxo.

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

O método OpenWrite 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 métodos OpenWriteAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString 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.

Aplica-se a