HttpWebRequest.GetRequestStream Método

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

Devoluções

A Stream para usar para escrever dados de pedidos.

Exceções

Exemplos

O exemplo de código seguinte utiliza o GetRequestStream método para devolver 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 = "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()

Observações

O GetRequestStream método devolve um fluxo para enviar dados para o HttpWebRequest. Depois de o Stream objeto ter sido devolvido, pode enviar dados com o HttpWebRequest usando o Stream.Write método.

Se uma aplicação precisar de definir o valor da ContentLength propriedade, isso deve ser feito antes de recuperar o fluxo.

Deve chamar o Stream.Close método para fechar o fluxo e libertar a ligação para reutilização. Não fechar o stream faz com que a sua aplicação fique sem ligações.

Ver também

• Elemento DefaultProxy (Definições de Rede)

public:
 System::IO::Stream ^ GetRequestStream([Runtime::InteropServices::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

Devoluções

A Stream para usar para escrever dados de pedidos.

Exceções

Observações

O GetRequestStream método devolve um fluxo para enviar dados para o HttpWebRequest e gera o associado TransportContext ao fluxo. Depois de o Stream objeto ter sido devolvido, pode enviar dados com o HttpWebRequest usando o Stream.Write método.

Algumas aplicações que utilizam Windows authentication integradas com proteção alargada podem precisar de consultar a camada de transporte usada por HttpWebRequest para recuperar o token de ligação de canal (CBT) do canal TLS subjacente. O GetRequestStream método fornece acesso a esta informação para métodos HTTP que têm um corpo de pedido (POST e PUT pedidos). Isto só é necessário se a aplicação estiver a implementar a sua própria autenticação e precisar de acesso à CBT.

Se uma aplicação precisar de definir o valor da ContentLength propriedade, isso deve ser feito antes de recuperar o fluxo.

Deve chamar o Stream.Close método para fechar o fluxo e libertar a ligação para reutilização. Não fechar o stream faz com que a sua aplicação fique sem ligações.

Ver também

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