HttpWebRequest.AddRange Metoda

Definicja

Dodaje nagłówek zakresu do żądania.

Przeciążenia

AddRange(Int32)

Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu od początku lub końca żądanych danych.

AddRange(Int64)

Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu od początku lub końca żądanych danych.

AddRange(Int32, Int32)

Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu.

AddRange(Int64, Int64)

Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu.

AddRange(String, Int32)

Dodaje nagłówek Zakres do żądania dla określonego zakresu od początku lub końca żądanych danych.

AddRange(String, Int64)

Dodaje nagłówek Zakres do żądania dla określonego zakresu od początku lub końca żądanych danych.

AddRange(String, Int32, Int32)

Dodaje nagłówek zakresu do żądania dla określonego zakresu.

AddRange(String, Int64, Int64)

Dodaje nagłówek zakresu do żądania dla określonego zakresu.

Uwagi

Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.

Nagłówek Zakres żądania umożliwia klientowi żądanie, że chce otrzymywać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówków zakresu.

AddRange(Int32)

Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs

Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu od początku lub końca żądanych danych.

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

Parametry

range
Int32

Początkowy lub końcowy punkt zakresu.

Wyjątki

Nazwa rangeSpecifier jest niepoprawna.

Nie można dodać nagłówka zakresu.

Przykłady

Poniższy przykład kodu dodaje nagłówek zakresu do żądania.

// 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())

Uwagi

Metoda HttpWebRequest.AddRange dodaje nagłówek zakresu bajtów do żądania.

Jeśli range jest dodatni, range parametr określa punkt początkowy zakresu. Serwer powinien rozpocząć wysyłanie danych z parametru range określonego na końcu danych w jednostce HTTP.

Jeśli range jest ujemna, range parametr określa punkt końcowy zakresu. Serwer powinien rozpocząć wysyłanie danych od początku danych w jednostce HTTP do określonego parametru range .

Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.

Nagłówek Zakres żądania umożliwia klientowi żądanie, że chce otrzymywać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówków zakresu.

Przykład nagłówka zakresu w żądaniu protokołu HTTP, który żąda, aby serwer wysyłał pierwsze 100 bajtów (od początku do pozycji bajtowej 99) będzie następujący:

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

W tym przykładzie range parametrem będzie -99.

Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges. Przykład nagłówka Accept-Ranges z serwera obsługującego zakresy bajtów:

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

Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, wygląda następująco:

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

Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości klasy HttpWebResponse . Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.

Zobacz też

Dotyczy

AddRange(Int64)

Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs

Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu od początku lub końca żądanych danych.

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

Parametry

range
Int64

Początkowy lub końcowy punkt zakresu.

Wyjątki

Nazwa rangeSpecifier jest niepoprawna.

Nie można dodać nagłówka zakresu.

Uwagi

Metoda HttpWebRequest.AddRange dodaje nagłówek zakresu bajtów do żądania.

Jeśli range jest dodatni, range parametr określa punkt początkowy zakresu. Serwer powinien rozpocząć wysyłanie danych z parametru range określonego na końcu danych w jednostce HTTP.

Jeśli range jest ujemna, range parametr określa punkt końcowy zakresu. Serwer powinien rozpocząć wysyłanie danych od początku danych w jednostce HTTP do określonego parametru range .

Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.

Nagłówek Zakres żądania umożliwia klientowi żądanie, że chce otrzymywać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówków zakresu.

Przykład nagłówka zakresu w żądaniu protokołu HTTP, który żąda, aby serwer wysyłał pierwsze 100 bajtów (od początku do pozycji bajtowej 99) będzie następujący:

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

W tym przykładzie range parametrem będzie -99.

Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges. Przykład nagłówka Accept-Ranges z serwera obsługującego zakresy bajtów:

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

Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, wygląda następująco:

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

Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości klasy HttpWebResponse . Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.

Zobacz też

Dotyczy

AddRange(Int32, Int32)

Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs

Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu.

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)

Parametry

from
Int32

Pozycja, w której chcesz rozpocząć wysyłanie danych.

to
Int32

Położenie, w którym ma przestać wysyłać dane.

Wyjątki

Nazwa rangeSpecifier jest niepoprawna.

from jest większe niż to

-lub-

from lub to jest mniejszy niż 0.

Nie można dodać nagłówka zakresu.

Przykłady

Poniższy przykład kodu dodaje nagłówek zakresu do żądania.

// 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()

Uwagi

Metoda HttpWebRequest.AddRange dodaje nagłówek zakresu bajtów do żądania.

Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.

Nagłówek Zakres żądania umożliwia klientowi żądanie, że chce otrzymywać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówków zakresu.

Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:

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

W tym przykładzie from parametr zostanie określony jako 0, a to parametr zostanie określony jako 99. Specyfikator zakresu jest automatycznie ustawiany jako "bajty" przez tę metodę.

Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges. Przykład nagłówka Accept-Ranges z serwera obsługującego zakresy bajtów:

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

Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, wygląda następująco:

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

Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości klasy HttpWebResponse . Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.

Zobacz też

Dotyczy

AddRange(Int64, Int64)

Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs

Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu.

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)

Parametry

from
Int64

Pozycja, w której chcesz rozpocząć wysyłanie danych.

to
Int64

Położenie, w którym ma przestać wysyłać dane.

Wyjątki

Nazwa rangeSpecifier jest niepoprawna.

from jest większe niż to

-lub-

from lub to jest mniejszy niż 0.

Nie można dodać nagłówka zakresu.

Uwagi

Metoda HttpWebRequest.AddRange dodaje nagłówek zakresu bajtów do żądania.

Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.

Nagłówek Zakres żądania umożliwia klientowi żądanie, że chce otrzymywać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.

Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:

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

W tym przykładzie from parametr zostanie określony jako 0, a to parametr zostanie określony jako 99. Specyfikator zakresu jest automatycznie ustawiany jako "bajty" przez tę metodę.

Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:

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

Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:

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

Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.

Zobacz też

Dotyczy

AddRange(String, Int32)

Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs

Dodaje nagłówek Zakres do żądania dla określonego zakresu od początku lub końca żądanych danych.

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)

Parametry

rangeSpecifier
String

Opis zakresu.

range
Int32

Początkowy lub końcowy punkt zakresu.

Wyjątki

rangeSpecifier to null.

Nazwa rangeSpecifier jest niepoprawna.

Nie można dodać nagłówka zakresu.

Uwagi

Metoda HttpWebRequest.AddRange dodaje nagłówek Range do żądania.

Jeśli range parametr jest dodatni, range określa punkt początkowy zakresu. Serwer powinien rozpocząć wysyłanie danych z parametru range określonego na końcu danych w jednostce HTTP.

Jeśli range parametr jest ujemny, range określa punkt końcowy zakresu. Serwer powinien rozpocząć wysyłanie danych od początku danych w jednostce HTTP do określonego parametru range .

Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.

Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.

Parametr rangeSpecifier zwykle jest określony jako "bajty", ponieważ jest to jedyny specyfikator zakresu rozpoznawany przez większość serwerów HTTP. Ustawienie parametru rangeSpecifier na inny ciąg umożliwia obsługę specyfikatorów zakresu niestandardowego innych niż bajty (specyfikator zakresu bajtów zdefiniowany w dokumencie RFC 2616 przez IETF).

Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:

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

W tym przykładzie rangeSpecifier parametr zostanie określony jako "bajty", a range parametr to -99.

Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges w odpowiedzi. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:

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

Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:

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

Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.

Zobacz też

Dotyczy

AddRange(String, Int64)

Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs

Dodaje nagłówek Zakres do żądania dla określonego zakresu od początku lub końca żądanych danych.

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)

Parametry

rangeSpecifier
String

Opis zakresu.

range
Int64

Początkowy lub końcowy punkt zakresu.

Wyjątki

rangeSpecifier to null.

Nazwa rangeSpecifier jest niepoprawna.

Nie można dodać nagłówka zakresu.

Uwagi

Metoda HttpWebRequest.AddRange dodaje nagłówek Range do żądania.

Jeśli range parametr jest dodatni, range określa punkt początkowy zakresu. Serwer powinien rozpocząć wysyłanie danych z parametru range określonego na końcu danych w jednostce HTTP.

Jeśli range parametr jest ujemny, range określa punkt końcowy zakresu. Serwer powinien rozpocząć wysyłanie danych od początku danych w jednostce HTTP do określonego parametru range .

Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.

Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.

Parametr rangeSpecifier zwykle jest określony jako "bajty", ponieważ jest to jedyny specyfikator zakresu rozpoznawany przez większość serwerów HTTP. Ustawienie parametru rangeSpecifier na inny ciąg umożliwia obsługę specyfikatorów zakresu niestandardowego innych niż bajty (specyfikator zakresu bajtów zdefiniowany w dokumencie RFC 2616 przez IETF).

Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:

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

W tym przykładzie rangeSpecifier parametr zostanie określony jako "bajty", a range parametr to -99.

Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges w odpowiedzi. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:

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

Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:

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

Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.

Zobacz też

Dotyczy

AddRange(String, Int32, Int32)

Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs

Dodaje nagłówek zakresu do żądania dla określonego zakresu.

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)

Parametry

rangeSpecifier
String

Opis zakresu.

from
Int32

Położenie, w którym należy rozpocząć wysyłanie danych.

to
Int32

Położenie, w którym należy przestać wysyłać dane.

Wyjątki

rangeSpecifier to null.

from jest większe niż to

-lub-

from wartość lub to jest mniejsza niż 0.

Nazwa rangeSpecifier jest niepoprawna.

Nie można dodać nagłówka zakresu.

Uwagi

Metoda HttpWebRequest.AddRange dodaje nagłówek Range do żądania.

Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.

Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.

Parametr rangeSpecifier zwykle jest określony jako "bajty", ponieważ jest to jedyny specyfikator zakresu rozpoznawany przez większość serwerów HTTP. Ustawienie parametru rangeSpecifier na inny ciąg umożliwia obsługę specyfikatorów zakresu niestandardowego innych niż bajty (specyfikator zakresu bajtów zdefiniowany w dokumencie RFC 2616 przez IETF).

Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:

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

W tym przykładzie rangeSpecifier parametr zostanie określony jako "bajty", from parametr będzie miał wartość 0, a to parametr będzie miał wartość 99.

Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges w odpowiedzi. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:

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

Ciąg określony w nagłówku Accept-Ranges jest specyfikatorem zakresu, który byłby określony w parametrze rangeSpecifier dla tej metody.

Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:

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

Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.

Zobacz też

Dotyczy

AddRange(String, Int64, Int64)

Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs
Źródło:
HttpWebRequest.cs

Dodaje nagłówek zakresu do żądania dla określonego zakresu.

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)

Parametry

rangeSpecifier
String

Opis zakresu.

from
Int64

Położenie, w którym należy rozpocząć wysyłanie danych.

to
Int64

Położenie, w którym należy przestać wysyłać dane.

Wyjątki

rangeSpecifier to null.

from jest większe niż to

-lub-

from wartość lub to jest mniejsza niż 0.

Nazwa rangeSpecifier jest niepoprawna.

Nie można dodać nagłówka zakresu.

Uwagi

Metoda HttpWebRequest.AddRange dodaje nagłówek Range do żądania.

Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.

Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówków zakresu.

Parametr rangeSpecifier zwykle jest określany jako "bajty", ponieważ jest to jedyny specyfikator zakresu rozpoznawany przez większość serwerów HTTP. Ustawienie parametru rangeSpecifier na inny ciąg umożliwia obsługę niestandardowych specyfikatorów zakresu innych niż bajty (specyfikator zakresu bajtów zdefiniowany w dokumencie RFC 2616 przez IETF).

Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:

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

W tym przykładzie rangeSpecifier parametr zostanie określony jako "bajty", from parametr będzie 0, a to parametr będzie miał wartość 99.

Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges w odpowiedzi. Przykład nagłówka Accept-Ranges z serwera obsługującego zakresy bajtów:

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

Ciąg określony w nagłówku Accept-Ranges jest specyfikatorem zakresu, który byłby określony w parametrze rangeSpecifier dla tej metody.

Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, wygląda następująco:

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

Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości klasy HttpWebResponse . Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.

Zobacz też

Dotyczy