HttpWebRequest.MaximumResponseHeadersLength HttpWebRequest.MaximumResponseHeadersLength HttpWebRequest.MaximumResponseHeadersLength HttpWebRequest.MaximumResponseHeadersLength Property

定義

応答ヘッダーの許容最大長を取得または設定します。Gets or sets the maximum allowed length of the response headers.

public:
 property int MaximumResponseHeadersLength { int get(); void set(int value); };
public int MaximumResponseHeadersLength { get; set; }
member this.MaximumResponseHeadersLength : int with get, set
Public Property MaximumResponseHeadersLength As Integer

プロパティ値

応答ヘッダーの長さ (KB 単位、1 KB = 1024 バイト)。The length, in kilobytes (1024 bytes), of the response headers.

例外

このプロパティは、要求の送信後に設定されます。The property is set after the request has already been submitted.

値が 0 未満で、-1 と等しくありません。The value is less than 0 and is not equal to -1.

次のコード例では、このプロパティの値を設定します。The following code example sets the value of this property.

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::Text;
using namespace System::IO;

// Specify the URL to receive the request.
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   HttpWebRequest^ request = dynamic_cast<HttpWebRequest^>(WebRequest::Create( args[ 1 ] ));
   
   // Set some reasonable limits on resources used by this request
   request->MaximumAutomaticRedirections = 4;
   request->MaximumResponseHeadersLength = 4;
   
   // Set credentials to use for this request.
   request->Credentials = CredentialCache::DefaultCredentials;
   HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());
   Console::WriteLine( "Content length is {0}", response->ContentLength );
   Console::WriteLine( "Content type is {0}", response->ContentType );
   
   // Get the stream associated with the response.
   Stream^ receiveStream = response->GetResponseStream();
   
   // Pipes the stream to a higher level stream reader with the required encoding format. 
   StreamReader^ readStream = gcnew StreamReader( receiveStream,Encoding::UTF8 );
   Console::WriteLine( "Response stream received." );
   Console::WriteLine( readStream->ReadToEnd() );
   response->Close();
   readStream->Close();
}

/*
The output from this example will vary depending on the value passed into Main 
but will be similar to the following:

Content length is 1542
Content type is text/html; charset=utf-8
Response stream received.
<html>
...
</html>

*/
using System;
using System.Net;
using System.Text;
using System.IO;


    public class Test
    {
        // Specify the URL to receive the request.
        public static void Main (string[] args)
        {
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create (args[0]);

            // Set some reasonable limits on resources used by this request
            request.MaximumAutomaticRedirections = 4;
            request.MaximumResponseHeadersLength = 4;
            // Set credentials to use for this request.
            request.Credentials = CredentialCache.DefaultCredentials;
            HttpWebResponse response = (HttpWebResponse)request.GetResponse ();

            Console.WriteLine ("Content length is {0}", response.ContentLength);
            Console.WriteLine ("Content type is {0}", response.ContentType);
             
            // Get the stream associated with the response.
            Stream receiveStream = response.GetResponseStream ();

            // Pipes the stream to a higher level stream reader with the required encoding format. 
            StreamReader readStream = new StreamReader (receiveStream, Encoding.UTF8);

            Console.WriteLine ("Response stream received.");
            Console.WriteLine (readStream.ReadToEnd ());
            response.Close ();
            readStream.Close ();
        }
    }

/*
The output from this example will vary depending on the value passed into Main 
but will be similar to the following:

Content length is 1542
Content type is text/html; charset=utf-8
Response stream received.
<html>
...
</html>

*/
Imports System.Net
Imports System.Text
Imports System.IO


    Public Class Test

        ' Specify the URL to receive the request.
        Public Shared Sub Main(ByVal args() As String)
        Dim request As HttpWebRequest = CType(WebRequest.Create(args(0)), HttpWebRequest)


        ' Set some reasonable limits on resources used by this request
        request.MaximumAutomaticRedirections = 4
        request.MaximumResponseHeadersLength = 4

        ' Set credentials to use for this request.
        request.Credentials = CredentialCache.DefaultCredentials

        Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)

        Console.WriteLine("Content length is {0}", response.ContentLength)
        Console.WriteLine("Content type is {0}", response.ContentType)

        ' Get the stream associated with the response.
        Dim receiveStream As Stream = response.GetResponseStream()

        ' Pipes the stream to a higher level stream reader with the required encoding format. 
        Dim readStream As New StreamReader(receiveStream, Encoding.UTF8)

        Console.WriteLine("Response stream received.")
        Console.WriteLine(readStream.ReadToEnd())
        response.Close()
        readStream.Close()
    End Sub 'Main
End Class 'Test
'
'The output from this example will vary depending on the value passed into Main 
'but will be similar to the following:
'
'Content length is 1542
'Content type is text/html; charset=utf-8
'Response stream received.
'...
'
'

注釈

応答ヘッダーの長さには、応答ステータス行、および HTTP プロトコルの一部として受信される追加の制御文字が含まれます。The length of the response header includes the response status line and any extra control characters that are received as part of HTTP protocol. 値-1 は、応答ヘッダーに制限が適用されないことを意味します。値0は、すべての要求が失敗することを意味します。A value of -1 means no limit is imposed on the response headers; a value of 0 means that all requests fail.

プロパティが明示的に設定されていない場合、プロパティDefaultMaximumResponseHeadersLengthの値が既定値に設定されます。 MaximumResponseHeadersLengthIf the MaximumResponseHeadersLength property is not explicitly set, it defaults to the value of the DefaultMaximumResponseHeadersLength property.

受信した応答ヘッダーの長さがMaximumResponseHeadersLengthプロパティの値を超えた場合EndGetResponse 、メソッドGetResponseまたはメソッドはWebException 、プロパティStatusがにMessageLengthLimitExceeded設定されたをスローします。If the length of the response header received exceeds the value of the MaximumResponseHeadersLength property, the EndGetResponse or GetResponse methods will throw a WebException with the Status property set to MessageLengthLimitExceeded.

適用対象