HttpWebRequest.AddRange Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.
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.
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
.
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
.
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.