WebRequest.GetRequestStream Método

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

WebRequest.cs

Quando substituído em uma classe descendente, retorna um Stream para gravar dados no recurso da Internet.

public:
 virtual System::IO::Stream ^ GetRequestStream();

public virtual System.IO.Stream GetRequestStream ();

abstract member GetRequestStream : unit -> System.IO.Stream
override this.GetRequestStream : unit -> System.IO.Stream

Public Overridable Function GetRequestStream () As Stream

Retornos

Stream

Um Stream para gravar dados no recurso da Internet.

Exceções

NotImplementedException

Será feita qualquer tentativa de acessar o método quando ele não for substituído em uma classe descendente.

Exemplos

O exemplo a seguir usa o GetRequestStream método para obter um fluxo e, em seguida, grava dados que transmitem.

// Set the 'ContentType' property of the WebRequest.
myWebRequest->ContentType = "application/x-www-form-urlencoded";

// Set the 'ContentLength' property of the WebRequest.
myWebRequest->ContentLength = byteArray->Length;
Stream^ newStream = myWebRequest->GetRequestStream();
newStream->Write( byteArray, 0, byteArray->Length );

// Close the Stream object.
newStream->Close();

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Set the 'ContentType' property of the WebRequest.
myWebRequest.ContentType="application/x-www-form-urlencoded";

// Set the 'ContentLength' property of the WebRequest.
myWebRequest.ContentLength=byteArray.Length;
Stream newStream=myWebRequest.GetRequestStream();
newStream.Write(byteArray,0,byteArray.Length);

// Close the Stream object.
newStream.Close();

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse=myWebRequest.GetResponse();

' Set the 'ContentType' property of the WebRequest.
myWebRequest.ContentType = "application/x-www-form-urlencoded"

' Set the 'ContentLength' property of the WebRequest.
myWebRequest.ContentLength = byteArray.Length
Dim newStream As Stream = myWebRequest.GetRequestStream()
newStream.Write(byteArray, 0, byteArray.Length)

' Close the Stream object.
newStream.Close()

' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

Comentários

O GetRequestStream método inicia uma solicitação para enviar dados para o recurso da Internet e retorna uma Stream instância para enviar dados para o recurso da Internet.

O GetRequestStream método fornece acesso síncrono ao Stream. Para acesso assíncrono, use os BeginGetRequestStream métodos e EndGetRequestStream .

Observação

A WebRequest classe é uma abstract classe . O comportamento real das instâncias em tempo de WebRequest execução é determinado pela classe descendente retornada pelo WebRequest.Create método . Para obter mais informações sobre valores e exceções padrão, consulte a documentação das classes descendentes, como HttpWebRequest e FileWebRequest.

Confira também

• BeginGetRequestStream(AsyncCallback, Object)
• Usando fluxos na rede