通过

HttpWebRequest.GetRequestStream 方法

  • 参考

定义

命名空间:
System.Net
程序集:
System.Net.Requests.dll
程序集:
System.dll
程序集:
netstandard.dll

获取用于写入请求数据的 Stream 对象。

重载

GetRequestStream()

获取用于写入请求数据的 Stream 对象。
GetRequestStream(TransportContext)

获取一个 Stream 对象，该对象用于写入请求数据并输出与流关联的 TransportContext。

GetRequestStream()

Source:
HttpWebRequest.cs
Source:
HttpWebRequest.cs
Source:
HttpWebRequest.cs

获取用于写入请求数据的 Stream 对象。

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

返回

Stream

用于写入请求数据的 Stream。

例外

ProtocolViolationException

Method 属性为 GET 或 HEAD。

-或-

KeepAlive true，AllowWriteStreamBuffering 为 false，ContentLength 为 -1，SendChunked 为 false，Method 为 POST 或 PUT。

InvalidOperationException

多次调用 GetRequestStream() 方法。

-或-

TransferEncoding 设置为值，SendChunkedfalse。

NotSupportedException

请求缓存验证程序指示可从缓存中提供此请求的响应;但是，写入数据的请求不得使用缓存。 如果使用未正确实现的自定义缓存验证程序，则可能会出现此异常。

WebException

以前调用 Abort()。

-或-

请求的超时期限已过期。

-或-

处理请求时出错。

ObjectDisposedException

在 .NET Compact Framework 应用程序中，未正确获取和关闭长度为零的请求流。 有关处理零内容长度请求的详细信息，请参阅 .NET Compact Framework中的 网络编程。

示例

下面的代码示例使用 GetRequestStream 方法返回流实例。

// 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()

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

GetRequestStream 方法返回用于发送 HttpWebRequest数据的流。 返回 Stream 对象后，可以使用 Stream.Write 方法通过 HttpWebRequest 发送数据。

如果应用程序需要设置 ContentLength 属性的值，则必须在检索流之前完成此操作。

必须调用 Stream.Close 方法才能关闭流并释放连接以供重复使用。 如果无法关闭流，应用程序将耗尽连接。

注意

应用程序无法混合特定请求的同步和异步方法。 如果调用 GetRequestStream 方法，则必须使用 GetResponse 方法来检索响应。

注意

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework中的 网络跟踪。

另请参阅

适用于

GetRequestStream(TransportContext)

Source:
HttpWebRequest.cs
Source:
HttpWebRequest.cs
Source:
HttpWebRequest.cs

获取一个 Stream 对象，该对象用于写入请求数据并输出与流关联的 TransportContext。

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

参数

context
TransportContext

Stream的 TransportContext。

返回

Stream

用于写入请求数据的 Stream。

例外

Exception

GetRequestStream() 方法无法获取 Stream。

InvalidOperationException

多次调用 GetRequestStream() 方法。

-或-

TransferEncoding 设置为值，SendChunkedfalse。

NotSupportedException

请求缓存验证程序指示可从缓存中提供此请求的响应;但是，写入数据的请求不得使用缓存。 如果使用未正确实现的自定义缓存验证程序，则可能会出现此异常。

ProtocolViolationException

Method 属性为 GET 或 HEAD。

-或-

KeepAlive true，AllowWriteStreamBuffering 为 false，ContentLength 为 -1，SendChunked 为 false，Method 为 POST 或 PUT。

WebException

以前调用 Abort()。

-或-

请求的超时期限已过期。

-或-

处理请求时出错。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

GetRequestStream 方法返回一个流，用于发送 HttpWebRequest 的数据，并输出与流关联的 TransportContext。 返回 Stream 对象后，可以使用 Stream.Write 方法通过 HttpWebRequest 发送数据。

某些使用集成 Windows 身份验证和扩展保护的应用程序可能需要能够查询 HttpWebRequest 使用的传输层，以便从基础 TLS 通道检索通道绑定令牌（CBT）。 GetRequestStream 方法提供对 HTTP 方法的访问权限，这些方法具有请求正文（POST 和 PUT 请求）。 仅当应用程序实现自己的身份验证并且需要访问 CBT 时，才需要这样做。

如果应用程序需要设置 ContentLength 属性的值，则必须在检索流之前完成此操作。

必须调用 Stream.Close 方法才能关闭流并释放连接以供重复使用。 如果无法关闭流，应用程序将耗尽连接。

注意

应用程序无法混合特定请求的同步和异步方法。 如果调用 GetRequestStream 方法，则必须使用 GetResponse 方法来检索响应。

注意

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework中的 网络跟踪。

另请参阅

适用于