Bagikan melalui


HttpWebRequest.AddRange Metode

Definisi

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 untuk rentang tertentu.

AddRange(Int64, Int64)

Menambahkan header rentang byte ke permintaan untuk 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

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

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.

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

rangeSpecifier tidak valid.

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

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode HttpWebRequest.AddRange menambahkan header rentang byte ke permintaan.

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

Jika range negatif, parameter range menentukan titik akhir rentang. Server harus mulai mengirim data dari awal data di entitas HTTP ke parameter range 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, parameter 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, 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 kelas HttpWebResponse. 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

rangeSpecifier tidak valid.

Header rentang tidak dapat ditambahkan.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode HttpWebRequest.AddRange menambahkan header rentang byte ke permintaan.

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

Jika range negatif, parameter range menentukan titik akhir rentang. Server harus mulai mengirim data dari awal data di entitas HTTP ke parameter range 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, parameter 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, 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 kelas HttpWebResponse. 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 untuk 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

rangeSpecifier tidak valid.

from lebih besar dari to

-atau-

from atau to kurang dari 0.

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

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode HttpWebRequest.AddRange menambahkan 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, parameter from akan ditentukan sebagai 0 dan parameter to 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, 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 kelas HttpWebResponse. 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 untuk 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

rangeSpecifier tidak valid.

from lebih besar dari to

-atau-

from atau to kurang dari 0.

Header rentang tidak dapat ditambahkan.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode HttpWebRequest.AddRange menambahkan 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, parameter from akan ditentukan sebagai 0 dan parameter to 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, 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 kelas HttpWebResponse. 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

rangeSpecifier null.

rangeSpecifier tidak valid.

Header rentang tidak dapat ditambahkan.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode HttpWebRequest.AddRange menambahkan header Rentang ke permintaan.

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

Jika range negatif, parameter range menentukan titik akhir rentang. Server harus mulai mengirim data dari awal data di entitas HTTP ke parameter range 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. Mengatur parameter rangeSpecifier 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, parameter rangeSpecifier akan ditentukan sebagai "byte" dan parameter range 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, 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 kelas HttpWebResponse. 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

rangeSpecifier null.

rangeSpecifier tidak valid.

Header rentang tidak dapat ditambahkan.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode HttpWebRequest.AddRange menambahkan header Rentang ke permintaan.

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

Jika range negatif, parameter range menentukan titik akhir rentang. Server harus mulai mengirim data dari awal data di entitas HTTP ke parameter range 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. Mengatur parameter rangeSpecifier 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, parameter rangeSpecifier akan ditentukan sebagai "byte" dan parameter range 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, 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 kelas HttpWebResponse. 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

rangeSpecifier null.

from lebih besar dari to

-atau-

from atau to kurang dari 0.

rangeSpecifier tidak valid.

Header rentang tidak dapat ditambahkan.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode HttpWebRequest.AddRange menambahkan 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. Mengatur parameter rangeSpecifier 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, parameter rangeSpecifier akan ditentukan sebagai "byte", parameter from adalah 0, dan parameter 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 parameter rangeSpecifier untuk metode ini.

Jika header Accept-Ranges tidak diterima di header respons dari server, 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 kelas HttpWebResponse. 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

rangeSpecifier null.

from lebih besar dari to

-atau-

from atau to kurang dari 0.

rangeSpecifier tidak valid.

Header rentang tidak dapat ditambahkan.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode HttpWebRequest.AddRange menambahkan 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. Mengatur parameter rangeSpecifier 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, parameter rangeSpecifier akan ditentukan sebagai "byte", parameter from adalah 0, dan parameter 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 parameter rangeSpecifier untuk metode ini.

Jika header Accept-Ranges tidak diterima di header respons dari server, 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 kelas HttpWebResponse. Header yang terkait dengan setiap rentang dikembalikan dalam respons.

Lihat juga

Berlaku untuk