HttpWebRequest.Pipelined Property

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Source:

HttpWebRequest.cs

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.