HttpWebRequest.GetRequestStream Método

Origem:

HttpWebRequest.cs

Origem:

HttpWebRequest.cs

Origem:

HttpWebRequest.cs

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

public override System.IO.Stream GetRequestStream ();

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

Public Overrides Function GetRequestStream () As Stream

Retornos

Um Stream a ser usado para gravar dados de solicitação.

Exceções

Exemplos

O exemplo de código a seguir usa o método GetRequestStream para retornar uma instância de fluxo.

// Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest->Method = "POST";
Console::WriteLine( "\nPlease enter the data to be posted to the (http://www.contoso.com/codesnippets/next.asp) Uri :" );

// Create a new String* Object* to POST data to the Url.
String^ inputData = Console::ReadLine();

String^ postData = String::Concat( "firstone= ", inputData );
ASCIIEncoding^ encoding = gcnew ASCIIEncoding;
array<Byte>^ byte1 = encoding->GetBytes( postData );

// Set the content type of the data being posted.
myHttpWebRequest->ContentType = "application/x-www-form-urlencoded";

// Set the content length of the String* being posted.
myHttpWebRequest->ContentLength = byte1->Length;

Stream^ newStream = myHttpWebRequest->GetRequestStream();

newStream->Write( byte1, 0, byte1->Length );
Console::WriteLine( "The value of 'ContentLength' property after sending the data is {0}", myHttpWebRequest->ContentLength );

// Close the Stream Object*.
newStream->Close();

// Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest.Method = "POST";
Console.WriteLine ("\nPlease enter the data to be posted to the (http://www.contoso.com/codesnippets/next.asp) Uri :");

// Create a new string object to POST data to the Url.
string inputData = Console.ReadLine ();


string postData = "firstone=" + inputData;
ASCIIEncoding encoding = new ASCIIEncoding ();
byte[] byte1 = encoding.GetBytes (postData);

// Set the content type of the data being posted.
myHttpWebRequest.ContentType = "application/x-www-form-urlencoded";

// Set the content length of the string being posted.
myHttpWebRequest.ContentLength = byte1.Length;

Stream newStream = myHttpWebRequest.GetRequestStream ();

newStream.Write (byte1, 0, byte1.Length);
Console.WriteLine ("The value of 'ContentLength' property after sending the data is {0}", myHttpWebRequest.ContentLength);

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

' Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest.Method = "POST"

Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the (http://www.contoso.com/codesnippets/next.asp) Uri :")
' Create a new string object to POST data to the Url.
Dim inputData As String = Console.ReadLine()
Dim postData As String = "firstone" + ChrW(61) + inputData
Dim encoding As New ASCIIEncoding()
Dim byte1 As Byte() = encoding.GetBytes(postData)
' Set the content type of the data being posted.
myHttpWebRequest.ContentType = "application/x-www-form-urlencoded"
' Set the content length of the string being posted.
myHttpWebRequest.ContentLength = byte1.Length
Dim newStream As Stream = myHttpWebRequest.GetRequestStream()
newStream.Write(byte1, 0, byte1.Length)
Console.WriteLine("The value of 'ContentLength' property after sending the data is {0}", myHttpWebRequest.ContentLength)
newStream.Close()

Comentários

O método GetRequestStream retorna um fluxo a ser usado para enviar dados para o HttpWebRequest. Depois que o objeto Stream tiver sido retornado, você poderá enviar dados com o HttpWebRequest usando o método Stream.Write.

Se um aplicativo precisar definir o valor da propriedade ContentLength, isso deverá ser feito antes de recuperar o fluxo.

Você deve chamar o método Stream.Close para fechar o fluxo e liberar a conexão para reutilização. A falha ao fechar o fluxo faz com que o aplicativo fique sem conexões.

Confira também

• elemento DefaultProxy (Configurações de Rede)

Origem:

HttpWebRequest.cs

Origem:

HttpWebRequest.cs

Origem:

HttpWebRequest.cs

public:
 System::IO::Stream ^ GetRequestStream([Runtime::InteropServices::Out] System::Net::TransportContext ^ % context);

public System.IO.Stream GetRequestStream (out System.Net.TransportContext? context);

public System.IO.Stream GetRequestStream (out System.Net.TransportContext context);

override this.GetRequestStream : TransportContext -> System.IO.Stream

Public Function GetRequestStream (ByRef context As TransportContext) As Stream

Parâmetros

Retornos

Um Stream a ser usado para gravar dados de solicitação.

Exceções

Comentários

O método GetRequestStream retorna um fluxo a ser usado para enviar dados para o HttpWebRequest e gera o TransportContext associado ao fluxo. Depois que o objeto Stream tiver sido retornado, você poderá enviar dados com o HttpWebRequest usando o método Stream.Write.

Alguns aplicativos que usam a autenticação integrada do Windows com proteção estendida podem precisar ser capazes de consultar a camada de transporte usada por HttpWebRequest para recuperar o CBT (token de associação de canal) do canal TLS subjacente. O método GetRequestStream fornece acesso a essas informações para métodos HTTP que têm um corpo da solicitação (POST e solicitações PUT). Isso só será necessário se o aplicativo estiver implementando sua própria autenticação e precisar de acesso ao CBT.

Se um aplicativo precisar definir o valor da propriedade ContentLength, isso deverá ser feito antes de recuperar o fluxo.

Você deve chamar o método Stream.Close para fechar o fluxo e liberar a conexão para reutilização. A falha ao fechar o fluxo faz com que o aplicativo fique sem conexões.

Confira também

• TransportContext
• GetChannelBinding(ChannelBindingKind)
• System.Security.Authentication.ExtendedProtection
• ChannelBinding
• Autenticação Integrada do Windows com Proteção Estendida