HttpWebRequest.GetRequestStream Método

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.Requests.dll

Obtém um Stream objeto a ser usado para gravar dados de solicitação.

Sobrecargas

Nome	Description
GetRequestStream()	Obtém um Stream objeto a ser usado para gravar dados de solicitação.
GetRequestStream(TransportContext)	Obtém um Stream objeto a ser usado para gravar dados de solicitação e gera o TransportContext associado ao fluxo.

GetRequestStream()

Origem:

HttpWebRequest.cs

Obtém um Stream objeto a ser usado para gravar dados de solicitação.

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

Stream

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

Exceções

ProtocolViolationException

A Method propriedade é GET ou HEAD.

-ou-

KeepAlive is true, AllowWriteStreamBuffering is false, ContentLength is -1, SendChunked is false, and Method is POST or PUT.

InvalidOperationException

O GetRequestStream() método é chamado mais de uma vez.

-ou-

TransferEncoding é definido como um valor e SendChunked é false.

NotSupportedException

O validador de cache de solicitação indicou que a resposta para essa solicitação pode ser atendida do cache; no entanto, as solicitações que gravam dados não devem usar o cache. Essa exceção poderá ocorrer se você estiver usando um validador de cache personalizado implementado incorretamente.

WebException

Abort() foi chamado anteriormente.

-ou-

O período de tempo limite para a solicitação expirou.

-ou-

Erro ao processar a solicitação.

ObjectDisposedException

Em um aplicativo .NET Compact Framework, um fluxo de solicitação sem tamanho de conteúdo não foi obtido e fechado corretamente. Para obter mais informações sobre como lidar com solicitações de comprimento de conteúdo zero, consulte Programação de Rede no .NET Compact Framework.

Exemplos

O exemplo de código a seguir usa o GetRequestStream método 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 = "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

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

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

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

Você deve chamar o Stream.Close método 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.

Nota

Seu aplicativo não pode misturar métodos síncronos e assíncronos para uma solicitação específica. Se você chamar o GetRequestStream método, deverá usar o GetResponse método para recuperar a resposta.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

Confira também

• Elemento DefaultProxy (Configurações de Rede)

GetRequestStream(TransportContext)

Origem:

HttpWebRequest.cs

Obtém um Stream objeto a ser usado para gravar dados de solicitação e gera o TransportContext associado ao fluxo.

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

context

TransportContext

O TransportContext para o Stream.

Retornos

Stream

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

Exceções

Exception

O GetRequestStream() método não pôde obter o Stream.

InvalidOperationException

O GetRequestStream() método é chamado mais de uma vez.

-ou-

TransferEncoding é definido como um valor e SendChunked é false.

NotSupportedException

O validador de cache de solicitação indicou que a resposta para essa solicitação pode ser atendida do cache; no entanto, as solicitações que gravam dados não devem usar o cache. Essa exceção poderá ocorrer se você estiver usando um validador de cache personalizado implementado incorretamente.

ProtocolViolationException

A Method propriedade é GET ou HEAD.

-ou-

KeepAlive is true, AllowWriteStreamBuffering is false, ContentLength is -1, SendChunked is false, and Method is POST or PUT.

WebException

Abort() foi chamado anteriormente.

-ou-

O período de tempo limite para a solicitação expirou.

-ou-

Erro ao processar a solicitação.

Comentários

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

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

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 HttpWebRequest para recuperar o CBT (token de associação de canal) do canal TLS subjacente. O GetRequestStream método fornece acesso a essas informações para métodos HTTP que têm um corpo da solicitação (POST e PUT solicitações). 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 ContentLength propriedade, isso deverá ser feito antes de recuperar o fluxo.

Você deve chamar o Stream.Close método 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.

Nota

Seu aplicativo não pode misturar métodos síncronos e assíncronos para uma solicitação específica. Se você chamar o GetRequestStream método, deverá usar o GetResponse método para recuperar a resposta.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

Confira também

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