HttpWebRequest.Pipelined Property

Reference

Definition

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: HttpWebRequest.cs

Source:: HttpWebRequest.cs

Source:: HttpWebRequest.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value that indicates whether to pipeline the request to the Internet resource.

public:
 property bool Pipelined { bool get(); void set(bool value); };

public bool Pipelined { get; set; }

member this.Pipelined : bool with get, set

Public Property Pipelined As Boolean

Property Value

Boolean

true if the request should be pipelined; otherwise, false. The default is true.

Examples

The following code example prints the value of the Pipelined property to the console.

// Create a 'HttpWebRequest' object.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( myUri ) );
// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );
// Display the contents of the page to the console.
Stream^ streamResponse = myHttpWebResponse->GetResponseStream();
StreamReader^ streamRead = gcnew StreamReader( streamResponse );
array<Char>^ readBuffer = gcnew array<Char>(256);
int count = streamRead->Read( readBuffer, 0, 256 );
Console::WriteLine( "\nThe contents of HTML page are......." );
while ( count > 0 )
{
   String^ outputData = gcnew String( readBuffer,0,count );
   Console::Write( outputData );
   count = streamRead->Read( readBuffer, 0, 256 );
}
Console::WriteLine( "\nHTTP Request  Headers :\n\n {0}", myHttpWebRequest->Headers );
Console::WriteLine( "\nHTTP Response Headers :\n\n {0}", myHttpWebResponse->Headers );
streamRead->Close();
streamResponse->Close();
// Release the response object resources.
myHttpWebResponse->Close();
Console::WriteLine( "\n'Pipelined' property is: {0}", myHttpWebRequest->Pipelined );
Console::WriteLine( "\nPress 'Enter' Key to Continue......" );
Console::Read();

// Create a 'HttpWebRequest' object.
HttpWebRequest	myHttpWebRequest=(HttpWebRequest)WebRequest.Create(myUri);
// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
// Display the contents of the page to the console.
Stream streamResponse=myHttpWebResponse.GetResponseStream();
StreamReader streamRead = new StreamReader( streamResponse );
Char[] readBuffer = new Char[256];
int count = streamRead.Read( readBuffer, 0, 256 );
Console.WriteLine("\nThe contents of HTML page are.......");	
while (count > 0)
{
    String outputData = new String(readBuffer, 0, count);
    Console.Write(outputData);
    count = streamRead.Read(readBuffer, 0, 256);
}
Console.WriteLine("\nHTTP Request  Headers :\n\n{0}",myHttpWebRequest.Headers);
Console.WriteLine("\nHTTP Response Headers :\n\n{0}",myHttpWebResponse.Headers);
streamRead.Close();
streamResponse.Close();
// Release the response object resources.
myHttpWebResponse.Close();
Console.WriteLine("\n'Pipelined' property is:{0}",myHttpWebRequest.Pipelined);	
Console.WriteLine("\nPress 'Enter' Key to Continue......");
Console.Read();

' Create a 'HttpWebRequest' object.
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create(myUri), HttpWebRequest)
' Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
' Display the contents of the page to the console
Dim streamResponse As Stream = myHttpWebResponse.GetResponseStream()
Dim streamRead As New StreamReader(streamResponse)
Dim readBuffer(256) As [Char]
Dim count As Integer = streamRead.Read(readBuffer, 0, 256)
Console.WriteLine(ControlChars.Cr + "The contents of HTML page are.......")
While count > 0
    Dim outputData As New [String](readBuffer, 0, count)
    Console.Write(outputData)
    count = streamRead.Read(readBuffer, 0, 256)
End While
Console.WriteLine(ControlChars.Cr + "HTTP Request  Headers :" + ControlChars.Cr + ControlChars.Cr + "{0}", myHttpWebRequest.Headers)
Console.WriteLine(ControlChars.Cr + "HTTP Response Headers :" + ControlChars.Cr + ControlChars.Cr + "{0}", myHttpWebResponse.Headers)
streamRead.Close()
 streamResponse.Close()
' Release the response object resources.
myHttpWebResponse.Close()
Console.WriteLine(ControlChars.Cr + "'Pipelined' property is:{0}", myHttpWebRequest.Pipelined)
Console.WriteLine(ControlChars.Cr + "Press 'Enter' Key to Continue......")
Console.Read()

Remarks

Caution

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete, and you shouldn't use them for new development. Use HttpClient instead.

An application uses the Pipelined property to indicate a preference for pipelined connections. When Pipelined is true, an application makes pipelined connections to the servers that support them.

Pipelined connections are made only when the KeepAlive property is also true.

Applies to

Dela via