WebClient.OpenWrite Método

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

Devoluções

A Stream era usado para escrever dados no recurso.

Exceções

Exemplos

O exemplo de código seguinte lê dados da linha de comandos e é usado OpenWrite para obter um fluxo para escrever os dados. O Stream devolvido por OpenWrite é encerrado 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.")

Observações

O OpenWrite método devolve um fluxo gravável que é usado para enviar dados a um recurso. Este método bloqueia ao abrir o fluxo. Para continuar a executar enquanto espera pela transmissão, use um dos OpenWriteAsync métodos.

Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.

Este método utiliza o comando STOR para carregar um recurso FTP. Para um recurso HTTP, é utilizado o método POST.

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

Devoluções

A Stream era usado para escrever dados no recurso.

Exceções

Observações

O OpenWrite método devolve um fluxo gravável que é usado para enviar dados a um recurso. Este método bloqueia ao abrir o fluxo. Para continuar a executar enquanto espera pela transmissão, use um dos OpenWriteAsync métodos.

Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.

Este método utiliza o comando STOR para carregar um recurso FTP. Para um recurso HTTP, é utilizado o método POST.

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

Devoluções

A Stream era usado para escrever dados no recurso.

Exceções

Exemplos

O seguinte exemplo de código lê dados da linha de comandos e usa OpenWrite para obter um fluxo usado para escrever os dados. O Stream devolvido 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.")

Observações

O OpenWrite método devolve um fluxo gravável que é usado para enviar dados a um recurso. O pedido subjacente é feito com o método especificado no method parâmetro. Os dados são enviados para o servidor quando fechas o fluxo. Este método bloqueia ao abrir o fluxo. Para continuar a executar enquanto espera pela transmissão, 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, a WebException é lançado com a Status propriedade definida para indicar o erro.

Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não especificar um endereço absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.

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

Devoluções

A Stream era usado para escrever dados no recurso.

Exceções

Observações

O OpenWrite método devolve um fluxo gravável que é usado para enviar dados a um recurso. Este método bloqueia ao abrir o fluxo. Para continuar a executar enquanto espera pela transmissão, use um dos OpenWriteAsync métodos.

Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.