WebClient.OpenWrite Método

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

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

Retornos

Um Stream usado para gravar dados no recurso.

Exceções

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

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.

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

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

Retornos

Um Stream usado para gravar dados no recurso.

Exceções

Comentários

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.

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

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

Retornos

Um Stream usado para gravar dados no recurso.

Exceções

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

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.

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

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

Retornos

Um Stream usado para gravar dados no recurso.

Exceções

Comentários

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.