WebClient.OpenWrite Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

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

Sobrecargas

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

OpenWrite(String)

Origem:

WebClient.cs

Abre um fluxo para gravar dados para o 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 BaseAddress e 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 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

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 combinado com BaseAddress para 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.

Observação

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

OpenWrite(Uri)

Origem:

WebClient.cs

Abre um fluxo para gravar dados para o 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 BaseAddress e address é inválido.

- ou -

Erro ao abrir o fluxo.

Comentários

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 combinado com BaseAddress para 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.

Observação

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

OpenWrite(String, String)

Origem:

WebClient.cs

Abre um fluxo para gravar dados para o 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 for 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 BaseAddress e 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 por OpenWrite deve 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

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 combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Observação

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

OpenWrite(Uri, String)

Origem:

WebClient.cs

Abre um fluxo para gravar dados para o 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 for 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 BaseAddress e address é inválido.

- ou -

Erro ao abrir o fluxo.

Comentários

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 combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Observação

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