Share via

HttpWebRequest.AddRange Metode

  • Referensi

Definisi

Ruang nama:
System.Net
Rakitan:
System.Net.Requests.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Menambahkan header rentang ke permintaan.

Overload

AddRange(Int32)

Menambahkan header rentang byte ke permintaan untuk rentang tertentu dari awal atau akhir data yang diminta.
AddRange(Int64)

Menambahkan header rentang byte ke permintaan untuk rentang tertentu dari awal atau akhir data yang diminta.
AddRange(Int32, Int32)

Menambahkan header rentang byte ke permintaan rentang tertentu.
AddRange(Int64, Int64)

Menambahkan header rentang byte ke permintaan rentang tertentu.
AddRange(String, Int32)

Menambahkan header Rentang ke permintaan rentang tertentu dari awal atau akhir data yang diminta.
AddRange(String, Int64)

Menambahkan header Rentang ke permintaan rentang tertentu dari awal atau akhir data yang diminta.
AddRange(String, Int32, Int32)

Menambahkan header rentang ke permintaan untuk rentang tertentu.
AddRange(String, Int64, Int64)

Menambahkan header rentang ke permintaan untuk rentang tertentu.

Keterangan

Karena semua entitas HTTP diwakili dalam pesan HTTP sebagai urutan byte, konsep rentang byte bermakna untuk entitas HTTP apa pun. Namun, tidak semua klien dan server perlu mendukung operasi rentang byte.

Header Rentang pada permintaan memungkinkan klien untuk meminta bahwa klien hanya ingin menerima beberapa bagian dari rentang byte yang ditentukan dalam entitas HTTP. Server tidak diperlukan untuk mendukung permintaan header Rentang.

AddRange(Int32)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Menambahkan header rentang byte ke permintaan untuk rentang tertentu dari awal atau akhir data yang diminta.

public:
 void AddRange(int range);
public void AddRange (int range);
member this.AddRange : int -> unit
Public Sub AddRange (range As Integer)

Parameter

range
Int32

Titik awal atau akhir rentang.

Pengecualian

ArgumentException

rangeSpecifier tidak valid.

InvalidOperationException

Header rentang tidak dapat ditambahkan.

Contoh

Contoh kode berikut menambahkan header rentang ke permintaan.

// Create a New 'HttpWebRequest' object.
HttpWebRequest^ myHttpWebRequest1 = 
    (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest1->AddRange( 1000);
Console::WriteLine("Call AddRange(1000)");
      Console::Write("Resulting Headers: ");
      Console::WriteLine(myHttpWebRequest1->Headers);

HttpWebRequest^ myHttpWebRequest2 = 
    (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest2->AddRange(-1000);
Console::WriteLine("Call AddRange(-1000)");
      Console::Write("Resulting Headers: ");
      Console::WriteLine(myHttpWebRequest2->Headers);

// Create a New 'HttpWebRequest' object .
HttpWebRequest myHttpWebRequest1=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
myHttpWebRequest1.AddRange(1000);	
Console.WriteLine("Call AddRange(1000)");
Console.Write("Resulting Headers: ");
Console.WriteLine(myHttpWebRequest1.Headers.ToString());

// Create a New 'HttpWebRequest' object .
HttpWebRequest myHttpWebRequest2=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
myHttpWebRequest2.AddRange(-1000);	
Console.WriteLine("Call AddRange(-1000)");
Console.Write("Resulting Headers: ");
Console.WriteLine(myHttpWebRequest2.Headers.ToString());

' A New 'HttpWebRequest' object is created.
Dim myHttpWebRequest1 As HttpWebRequest = WebRequest.Create("http://www.contoso.com")
myHttpWebRequest1.AddRange(1000)
Console.WriteLine("Call AddRange(1000)")
      Console.Write("Resulting Headers: ")
      Console.WriteLine(myHttpWebRequest1.Headers.ToString())

Dim myHttpWebRequest2 As HttpWebRequest = WebRequest.Create("http://www.contoso.com")
myHttpWebRequest2.AddRange(-1000)
Console.WriteLine("Call AddRange(-1000)")
      Console.Write("Resulting Headers: ")
      Console.WriteLine(myHttpWebRequest2.Headers.ToString())

Keterangan

Metode menambahkan HttpWebRequest.AddRange header rentang byte ke permintaan.

Jika range positif, range parameter menentukan titik awal rentang. Server harus mulai mengirim data dari range parameter yang ditentukan ke akhir data di entitas HTTP.

Jika range negatif, range parameter menentukan titik akhir rentang. Server harus mulai mengirim data dari awal data di entitas HTTP ke range parameter yang ditentukan.

Karena semua entitas HTTP diwakili dalam pesan HTTP sebagai urutan byte, konsep rentang byte bermakna untuk entitas HTTP apa pun. Namun, tidak semua klien dan server perlu mendukung operasi rentang byte.

Header Rentang pada permintaan memungkinkan klien untuk meminta bahwa ia hanya ingin menerima beberapa bagian dari rentang byte yang ditentukan dalam entitas HTTP. Server tidak diperlukan untuk mendukung permintaan header Rentang.

Contoh header Rentang dalam permintaan protokol HTTP yang meminta server mengirim 100 byte pertama (dari posisi awal hingga byte 99) adalah sebagai berikut:

Range: bytes=0-99\r\n\r\n

Untuk contoh ini, parameternya range adalah -99.

Server HTTP menunjukkan dukungan untuk header Rentang dengan header Accept-Ranges. Contoh header Accept-Ranges dari server yang mendukung rentang byte adalah sebagai berikut:

Accept-Ranges: bytes\r\n\r\n

Jika header Accept-Ranges tidak diterima di header respons dari server, maka server tidak mendukung header Rentang. Contoh header Accept-Ranges dari server yang tidak mendukung rentang, tetapi mengenali header Accept-Ranges, adalah sebagai berikut:

Accept-Ranges: none\r\n\r\n

Saat menerima respons dari permintaan rentang, hanya header HTTP yang terkait dengan seluruh permintaan yang diurai dan tersedia melalui properti di HttpWebResponse kelas . Header yang terkait dengan setiap rentang dikembalikan dalam respons.

Lihat juga

Berlaku untuk

AddRange(Int64)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Menambahkan header rentang byte ke permintaan untuk rentang tertentu dari awal atau akhir data yang diminta.

public:
 void AddRange(long range);
public void AddRange (long range);
member this.AddRange : int64 -> unit
Public Sub AddRange (range As Long)

Parameter

range
Int64

Titik awal atau akhir rentang.

Pengecualian

ArgumentException

rangeSpecifier tidak valid.

InvalidOperationException

Header rentang tidak dapat ditambahkan.

Keterangan

Metode menambahkan HttpWebRequest.AddRange header rentang byte ke permintaan.

Jika range positif, range parameter menentukan titik awal rentang. Server harus mulai mengirim data dari range parameter yang ditentukan ke akhir data di entitas HTTP.

Jika range negatif, range parameter menentukan titik akhir rentang. Server harus mulai mengirim data dari awal data di entitas HTTP ke range parameter yang ditentukan.

Karena semua entitas HTTP diwakili dalam pesan HTTP sebagai urutan byte, konsep rentang byte bermakna untuk entitas HTTP apa pun. Namun, tidak semua klien dan server perlu mendukung operasi rentang byte.

Header Rentang pada permintaan memungkinkan klien untuk meminta bahwa ia hanya ingin menerima beberapa bagian dari rentang byte yang ditentukan dalam entitas HTTP. Server tidak diperlukan untuk mendukung permintaan header Rentang.

Contoh header Rentang dalam permintaan protokol HTTP yang meminta server mengirim 100 byte pertama (dari posisi awal hingga byte 99) adalah sebagai berikut:

Range: bytes=0-99\r\n\r\n

Untuk contoh ini, parameternya range adalah -99.

Server HTTP menunjukkan dukungan untuk header Rentang dengan header Accept-Ranges. Contoh header Accept-Ranges dari server yang mendukung rentang byte adalah sebagai berikut:

Accept-Ranges: bytes\r\n\r\n

Jika header Accept-Ranges tidak diterima di header respons dari server, maka server tidak mendukung header Rentang. Contoh header Accept-Ranges dari server yang tidak mendukung rentang, tetapi mengenali header Accept-Ranges, adalah sebagai berikut:

Accept-Ranges: none\r\n\r\n

Saat menerima respons dari permintaan rentang, hanya header HTTP yang terkait dengan seluruh permintaan yang diurai dan tersedia melalui properti di HttpWebResponse kelas . Header yang terkait dengan setiap rentang dikembalikan dalam respons.

Lihat juga

Berlaku untuk

AddRange(Int32, Int32)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Menambahkan header rentang byte ke permintaan rentang tertentu.

public:
 void AddRange(int from, int to);
public void AddRange (int from, int to);
member this.AddRange : int * int -> unit
Public Sub AddRange (from As Integer, to As Integer)

Parameter

from
Int32

Posisi untuk mulai mengirim data.

to
Int32

Posisi untuk berhenti mengirim data.

Pengecualian

ArgumentException

rangeSpecifier tidak valid.

ArgumentOutOfRangeException

from lebih besar dari to

-atau-

from atau to kurang dari 0.

InvalidOperationException

Header rentang tidak dapat ditambahkan.

Contoh

Contoh kode berikut menambahkan header rentang ke permintaan.

// Create a New 'HttpWebRequest' object.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest->AddRange( 50, 150 );
Console::WriteLine("Call AddRange(50, 150)");
      Console::Write("Resulting Request Headers: ");
      Console::WriteLine(myHttpWebRequest->Headers);

// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );

// Displays the headers in the response received
Console::Write("Resulting Response Headers: ");
      Console::WriteLine(myHttpWebResponse->Headers);

// 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 HTML contents of the page from 50th to 150 charaters are :\n  " );
while ( count > 0 )
{
   String^ outputData = gcnew String( readBuffer,0,count );
   Console::WriteLine( outputData );
   count = streamRead->Read( readBuffer, 0, 256 );
}
streamRead->Close();
streamResponse->Close();
myHttpWebResponse->Close();

      // Create a New 'HttpWebRequest' object .
      HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
      myHttpWebRequest.AddRange(50,150);	
      Console.WriteLine("Call AddRange(50,150)");
      Console.Write("Resulting Request Headers: ");
      Console.WriteLine(myHttpWebRequest.Headers.ToString());

      // Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
      HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();

// Displays the headers in the response received
Console.Write("Resulting Response Headers: ");
      Console.WriteLine(myHttpWebResponse.Headers.ToString());

      // 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 HTML contents of the page from 50th to 150 characters are :\n  ");	
      while (count > 0)
      {
          String outputData = new String(readBuffer, 0, count);
          Console.WriteLine(outputData);
          count = streamRead.Read(readBuffer, 0, 256);
      }
      // Release the response object resources.
      streamRead.Close();
      streamResponse.Close();
      myHttpWebResponse.Close();

' A New 'HttpWebRequest' objetc is created.
Dim myHttpWebRequest As HttpWebRequest = WebRequest.Create("http://www.contoso.com")
myHttpWebRequest.AddRange(50, 150)
Console.WriteLine("Call AddRange(50, 150)")
      Console.Write("Resulting Request Headers: ")
      Console.WriteLine(myHttpWebRequest.Headers.ToString())

' The response object of 'HttpWebRequest' is assigned to a 'HttpWebResponse' variable.
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)

' Displays the headers in the response received
Console.Write("Resulting Response Headers: ")
      Console.WriteLine(myHttpWebResponse.Headers.ToString())

' Displaying 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 HTML contents of the page from 50th to 150 charaters are :" + ControlChars.Cr + "  ")
While count > 0
    Dim outputData As New [String](readBuffer, 0, count)
    Console.WriteLine(outputData)
    count = streamRead.Read(readBuffer, 0, 256)
End While
' Release the response object resources.
 streamRead.Close()
 streamResponse.Close()
myHttpWebResponse.Close()

Keterangan

Metode menambahkan HttpWebRequest.AddRange header rentang byte ke permintaan.

Karena semua entitas HTTP diwakili dalam pesan HTTP sebagai urutan byte, konsep rentang byte bermakna untuk entitas HTTP apa pun. Namun, tidak semua klien dan server perlu mendukung operasi rentang byte.

Header Rentang pada permintaan memungkinkan klien untuk meminta bahwa ia hanya ingin menerima beberapa bagian dari rentang byte yang ditentukan dalam entitas HTTP. Server tidak diperlukan untuk mendukung permintaan header Rentang.

Contoh header Rentang dalam permintaan protokol HTTP yang meminta 100 byte pertama adalah sebagai berikut:

Range: bytes=0-99\r\n\r\n

Untuk contoh ini, from parameter akan ditentukan sebagai 0 dan to parameter akan ditentukan sebagai 99. Penentu rentang secara otomatis ditetapkan sebagai "byte" dengan metode ini.

Server HTTP menunjukkan dukungan untuk header Rentang dengan header Accept-Ranges. Contoh header Accept-Ranges dari server yang mendukung rentang byte adalah sebagai berikut:

Accept-Ranges: bytes\r\n\r\n

Jika header Accept-Ranges tidak diterima di header respons dari server, maka server tidak mendukung header Rentang. Contoh header Accept-Ranges dari server yang tidak mendukung rentang, tetapi mengenali header Accept-Ranges, adalah sebagai berikut:

Accept-Ranges: none\r\n\r\n

Saat menerima respons dari permintaan rentang, hanya header HTTP yang terkait dengan seluruh permintaan yang diurai dan tersedia melalui properti di HttpWebResponse kelas . Header yang terkait dengan setiap rentang dikembalikan dalam respons.

Lihat juga

Berlaku untuk

AddRange(Int64, Int64)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Menambahkan header rentang byte ke permintaan rentang tertentu.

public:
 void AddRange(long from, long to);
public void AddRange (long from, long to);
member this.AddRange : int64 * int64 -> unit
Public Sub AddRange (from As Long, to As Long)

Parameter

from
Int64

Posisi untuk mulai mengirim data.

to
Int64

Posisi untuk berhenti mengirim data.

Pengecualian

ArgumentException

rangeSpecifier tidak valid.

ArgumentOutOfRangeException

from lebih besar dari to

-atau-

from atau to kurang dari 0.

InvalidOperationException

Header rentang tidak dapat ditambahkan.

Keterangan

Metode menambahkan HttpWebRequest.AddRange header rentang byte ke permintaan.

Karena semua entitas HTTP diwakili dalam pesan HTTP sebagai urutan byte, konsep rentang byte bermakna untuk entitas HTTP apa pun. Namun, tidak semua klien dan server perlu mendukung operasi rentang byte.

Header Rentang pada permintaan memungkinkan klien untuk meminta bahwa ia hanya ingin menerima beberapa bagian dari rentang byte yang ditentukan dalam entitas HTTP. Server tidak diperlukan untuk mendukung permintaan header Rentang.

Contoh header Rentang dalam permintaan protokol HTTP yang meminta 100 byte pertama adalah sebagai berikut:

Range: bytes=0-99\r\n\r\n

Untuk contoh ini, from parameter akan ditentukan sebagai 0 dan to parameter akan ditentukan sebagai 99. Penentu rentang secara otomatis ditetapkan sebagai "byte" dengan metode ini.

Server HTTP menunjukkan dukungan untuk header Rentang dengan header Accept-Ranges. Contoh header Accept-Ranges dari server yang mendukung rentang byte adalah sebagai berikut:

Accept-Ranges: bytes\r\n\r\n

Jika header Accept-Ranges tidak diterima di header respons dari server, maka server tidak mendukung header Rentang. Contoh header Accept-Ranges dari server yang tidak mendukung rentang, tetapi mengenali header Accept-Ranges, adalah sebagai berikut:

Accept-Ranges: none\r\n\r\n

Saat menerima respons dari permintaan rentang, hanya header HTTP yang terkait dengan seluruh permintaan yang diurai dan tersedia melalui properti di HttpWebResponse kelas . Header yang terkait dengan setiap rentang dikembalikan dalam respons.

Lihat juga

Berlaku untuk

AddRange(String, Int32)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Menambahkan header Rentang ke permintaan rentang tertentu dari awal atau akhir data yang diminta.

public:
 void AddRange(System::String ^ rangeSpecifier, int range);
public void AddRange (string rangeSpecifier, int range);
member this.AddRange : string * int -> unit
Public Sub AddRange (rangeSpecifier As String, range As Integer)

Parameter

rangeSpecifier
String

Deskripsi rentang.

range
Int32

Titik awal atau akhir rentang.

Pengecualian

ArgumentNullException

rangeSpecifieradalah null.

ArgumentException

rangeSpecifier tidak valid.

InvalidOperationException

Header rentang tidak dapat ditambahkan.

Keterangan

Metode menambahkan HttpWebRequest.AddRange header Rentang ke permintaan.

Jika range positif, range parameter menentukan titik awal rentang. Server harus mulai mengirim data dari range parameter yang ditentukan ke akhir data di entitas HTTP.

Jika range negatif, range parameter menentukan titik akhir rentang. Server harus mulai mengirim data dari awal data di entitas HTTP ke range parameter yang ditentukan.

Karena semua entitas HTTP diwakili dalam pesan HTTP sebagai urutan byte, konsep rentang byte bermakna untuk entitas HTTP apa pun. Namun, tidak semua klien dan server perlu mendukung operasi rentang byte.

Header Rentang pada permintaan memungkinkan klien untuk meminta bahwa ia hanya ingin menerima beberapa bagian dari rentang byte yang ditentukan dalam entitas HTTP. Server tidak diperlukan untuk mendukung permintaan header Rentang.

Parameter rangeSpecifier biasanya akan ditentukan sebagai "byte", karena ini adalah satu-satunya penentu rentang yang dikenali oleh sebagian besar server HTTP. rangeSpecifier Mengatur parameter ke beberapa string lain memungkinkan dukungan untuk penentu rentang kustom selain byte (penentu rentang byte yang ditentukan dalam RFC 2616 oleh IETF).

Contoh header Rentang dalam permintaan protokol HTTP yang meminta 100 byte pertama adalah sebagai berikut:

Range: bytes=-99\r\n\r\n

Untuk contoh ini, rangeSpecifier parameter akan ditentukan sebagai "byte" dan range parameternya adalah -99.

Server HTTP menunjukkan dukungan untuk header Rentang dengan header Accept-Ranges dalam respons. Contoh header Accept-Ranges dari server yang mendukung rentang byte adalah sebagai berikut:

Accept-Ranges: bytes\r\n\r\n

Jika header Accept-Ranges tidak diterima di header respons dari server, maka server tidak mendukung header Rentang. Contoh header Accept-Ranges dari server yang tidak mendukung rentang, tetapi mengenali header Accept-Ranges, adalah sebagai berikut:

Accept-Ranges: none\r\n\r\n

Saat menerima respons dari permintaan rentang, hanya header HTTP yang terkait dengan seluruh permintaan yang diurai dan tersedia melalui properti di HttpWebResponse kelas . Header yang terkait dengan setiap rentang dikembalikan dalam respons.

Lihat juga

Berlaku untuk

AddRange(String, Int64)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Menambahkan header Rentang ke permintaan rentang tertentu dari awal atau akhir data yang diminta.

public:
 void AddRange(System::String ^ rangeSpecifier, long range);
public void AddRange (string rangeSpecifier, long range);
member this.AddRange : string * int64 -> unit
Public Sub AddRange (rangeSpecifier As String, range As Long)

Parameter

rangeSpecifier
String

Deskripsi rentang.

range
Int64

Titik awal atau akhir rentang.

Pengecualian

ArgumentNullException

rangeSpecifieradalah null.

ArgumentException

rangeSpecifier tidak valid.

InvalidOperationException

Header rentang tidak dapat ditambahkan.

Keterangan

Metode menambahkan HttpWebRequest.AddRange header Rentang ke permintaan.

Jika range positif, range parameter menentukan titik awal rentang. Server harus mulai mengirim data dari range parameter yang ditentukan ke akhir data di entitas HTTP.

Jika range negatif, range parameter menentukan titik akhir rentang. Server harus mulai mengirim data dari awal data di entitas HTTP ke range parameter yang ditentukan.

Karena semua entitas HTTP diwakili dalam pesan HTTP sebagai urutan byte, konsep rentang byte bermakna untuk entitas HTTP apa pun. Namun, tidak semua klien dan server perlu mendukung operasi rentang byte.

Header Rentang pada permintaan memungkinkan klien untuk meminta bahwa ia hanya ingin menerima beberapa bagian dari rentang byte yang ditentukan dalam entitas HTTP. Server tidak diperlukan untuk mendukung permintaan header Rentang.

Parameter rangeSpecifier biasanya akan ditentukan sebagai "byte", karena ini adalah satu-satunya penentu rentang yang dikenali oleh sebagian besar server HTTP. rangeSpecifier Mengatur parameter ke beberapa string lain memungkinkan dukungan untuk penentu rentang kustom selain byte (penentu rentang byte yang ditentukan dalam RFC 2616 oleh IETF).

Contoh header Rentang dalam permintaan protokol HTTP yang meminta 100 byte pertama adalah sebagai berikut:

Range: bytes=-99\r\n\r\n

Untuk contoh ini, rangeSpecifier parameter akan ditentukan sebagai "byte" dan range parameternya adalah -99.

Server HTTP menunjukkan dukungan untuk header Rentang dengan header Accept-Ranges dalam respons. Contoh header Accept-Ranges dari server yang mendukung rentang byte adalah sebagai berikut:

Accept-Ranges: bytes\r\n\r\n

Jika header Accept-Ranges tidak diterima di header respons dari server, maka server tidak mendukung header Rentang. Contoh header Accept-Ranges dari server yang tidak mendukung rentang, tetapi mengenali header Accept-Ranges, adalah sebagai berikut:

Accept-Ranges: none\r\n\r\n

Saat menerima respons dari permintaan rentang, hanya header HTTP yang terkait dengan seluruh permintaan yang diurai dan tersedia melalui properti di HttpWebResponse kelas . Header yang terkait dengan setiap rentang dikembalikan dalam respons.

Lihat juga

Berlaku untuk

AddRange(String, Int32, Int32)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Menambahkan header rentang ke permintaan untuk rentang tertentu.

public:
 void AddRange(System::String ^ rangeSpecifier, int from, int to);
public void AddRange (string rangeSpecifier, int from, int to);
member this.AddRange : string * int * int -> unit
Public Sub AddRange (rangeSpecifier As String, from As Integer, to As Integer)

Parameter

rangeSpecifier
String

Deskripsi rentang.

from
Int32

Posisi untuk mulai mengirim data.

to
Int32

Posisi untuk berhenti mengirim data.

Pengecualian

ArgumentNullException

rangeSpecifieradalah null.

ArgumentOutOfRangeException

from lebih besar dari to

-atau-

from atau to kurang dari 0.

ArgumentException

rangeSpecifier tidak valid.

InvalidOperationException

Header rentang tidak dapat ditambahkan.

Keterangan

Metode menambahkan HttpWebRequest.AddRange header Rentang ke permintaan.

Karena semua entitas HTTP diwakili dalam pesan HTTP sebagai urutan byte, konsep rentang byte bermakna untuk entitas HTTP apa pun. Namun, tidak semua klien dan server perlu mendukung operasi rentang byte.

Header Rentang pada permintaan memungkinkan klien untuk meminta bahwa ia hanya ingin menerima beberapa bagian dari rentang byte yang ditentukan dalam entitas HTTP. Server tidak diperlukan untuk mendukung permintaan header Rentang.

Parameter rangeSpecifier biasanya akan ditentukan sebagai "byte", karena ini adalah satu-satunya penentu rentang yang dikenali oleh sebagian besar server HTTP. rangeSpecifier Mengatur parameter ke beberapa string lain memungkinkan dukungan untuk penentu rentang kustom selain byte (penentu rentang byte yang ditentukan dalam RFC 2616 oleh IETF).

Contoh header Rentang dalam permintaan protokol HTTP yang meminta 100 byte pertama adalah sebagai berikut:

Range: bytes=0-99\r\n\r\n

Untuk contoh ini, rangeSpecifier parameter akan ditentukan sebagai "byte", from parameternya adalah 0, dan parameternya to adalah 99.

Server HTTP menunjukkan dukungan untuk header Rentang dengan header Accept-Ranges dalam respons. Contoh header Accept-Ranges dari server yang mendukung rentang byte adalah sebagai berikut:

Accept-Ranges: bytes\r\n\r\n

String yang ditentukan dalam header Accept-Ranges adalah penentu rentang yang akan ditentukan dalam rangeSpecifier parameter untuk metode ini.

Jika header Accept-Ranges tidak diterima di header respons dari server, maka server tidak mendukung header Rentang. Contoh header Accept-Ranges dari server yang tidak mendukung rentang, tetapi mengenali header Accept-Ranges, adalah sebagai berikut:

Accept-Ranges: none\r\n\r\n

Saat menerima respons dari permintaan rentang, hanya header HTTP yang terkait dengan seluruh permintaan yang diurai dan tersedia melalui properti di HttpWebResponse kelas . Header yang terkait dengan setiap rentang dikembalikan dalam respons.

Lihat juga

Berlaku untuk

AddRange(String, Int64, Int64)

Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs
Sumber:
HttpWebRequest.cs

Menambahkan header rentang ke permintaan untuk rentang tertentu.

public:
 void AddRange(System::String ^ rangeSpecifier, long from, long to);
public void AddRange (string rangeSpecifier, long from, long to);
member this.AddRange : string * int64 * int64 -> unit
Public Sub AddRange (rangeSpecifier As String, from As Long, to As Long)

Parameter

rangeSpecifier
String

Deskripsi rentang.

from
Int64

Posisi untuk mulai mengirim data.

to
Int64

Posisi untuk berhenti mengirim data.

Pengecualian

ArgumentNullException

rangeSpecifieradalah null.

ArgumentOutOfRangeException

from lebih besar dari to

-atau-

from atau to kurang dari 0.

ArgumentException

rangeSpecifier tidak valid.

InvalidOperationException

Header rentang tidak dapat ditambahkan.

Keterangan

Metode menambahkan HttpWebRequest.AddRange header Rentang ke permintaan.

Karena semua entitas HTTP diwakili dalam pesan HTTP sebagai urutan byte, konsep rentang byte bermakna untuk entitas HTTP apa pun. Namun, tidak semua klien dan server perlu mendukung operasi rentang byte.

Header Rentang pada permintaan memungkinkan klien untuk meminta bahwa ia hanya ingin menerima beberapa bagian dari rentang byte yang ditentukan dalam entitas HTTP. Server tidak diperlukan untuk mendukung permintaan header Rentang.

Parameter rangeSpecifier biasanya akan ditentukan sebagai "byte", karena ini adalah satu-satunya penentu rentang yang dikenali oleh sebagian besar server HTTP. rangeSpecifier Mengatur parameter ke beberapa string lain memungkinkan dukungan untuk penentu rentang kustom selain byte (penentu rentang byte yang ditentukan dalam RFC 2616 oleh IETF).

Contoh header Rentang dalam permintaan protokol HTTP yang meminta 100 byte pertama adalah sebagai berikut:

Range: bytes=0-99\r\n\r\n

Untuk contoh ini, rangeSpecifier parameter akan ditentukan sebagai "byte", from parameternya adalah 0, dan to parameternya adalah 99.

Server HTTP menunjukkan dukungan untuk header Rentang dengan header Accept-Ranges dalam respons. Contoh header Accept-Ranges dari server yang mendukung rentang byte adalah sebagai berikut:

Accept-Ranges: bytes\r\n\r\n

String yang ditentukan dalam header Accept-Ranges adalah penentu rentang yang akan ditentukan dalam rangeSpecifier parameter untuk metode ini.

Jika header Accept-Ranges tidak diterima di header respons dari server, maka server tidak mendukung header Rentang. Contoh header Accept-Ranges dari server yang tidak mendukung rentang, tetapi mengenali header Accept-Ranges, adalah sebagai berikut:

Accept-Ranges: none\r\n\r\n

Saat menerima respons dari permintaan rentang, hanya header HTTP yang terkait dengan seluruh permintaan yang diurai dan tersedia melalui properti di HttpWebResponse kelas . Header yang terkait dengan setiap rentang dikembalikan dalam respons.

Lihat juga

Berlaku untuk