HttpWebRequest.AddRange Yöntem

Başvuru

Tanım

Ad Alanı:: System.Net

Bütünleştirilmiş Kod:: System.Net.Requests.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

İsteğe bir aralık üst bilgisi ekler.

Aşırı Yüklemeler

AddRange(Int32)	İstenen verilerin başından veya sonundan belirli bir aralık için isteğe bayt aralığı üst bilgisi ekler.
AddRange(Int64)	İstenen verilerin başından veya sonundan belirli bir aralık için isteğe bayt aralığı üst bilgisi ekler.
AddRange(Int32, Int32)	Belirtilen aralık için isteğe bir bayt aralığı üst bilgisi ekler.
AddRange(Int64, Int64)	Belirtilen aralık için isteğe bir bayt aralığı üst bilgisi ekler.
AddRange(String, Int32)	İstenen verilerin başından veya sonundan belirli bir aralık için isteğe Bir Aralık üst bilgisi ekler.
AddRange(String, Int64)	İstenen verilerin başından veya sonundan belirli bir aralık için isteğe Bir Aralık üst bilgisi ekler.
AddRange(String, Int32, Int32)	Belirtilen aralık için bir isteğe aralık üst bilgisi ekler.
AddRange(String, Int64, Int64)	Belirtilen aralık için bir isteğe aralık üst bilgisi ekler.

Açıklamalar

Tüm HTTP varlıkları HTTP iletilerinde bayt dizisi olarak gösterildiğinden, bayt aralığı kavramı herhangi bir HTTP varlığı için anlamlıdır. Ancak, tüm istemcilerin ve sunucuların bayt aralığı işlemlerini desteklemesi gerekmez.

İstekteki Aralık üst bilgisi, istemcinin bir HTTP varlığında belirtilen bayt aralığının yalnızca bir kısmını almak istemesine olanak tanır. Sunucuların Aralık üst bilgisi isteklerini desteklemesi gerekmez.

AddRange(Int32)

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

İstenen verilerin başından veya sonundan belirli bir aralık için isteğe bayt aralığı üst bilgisi ekler.

public:
 void AddRange(int range);

public void AddRange (int range);

member this.AddRange : int -> unit

Public Sub AddRange (range As Integer)

Parametreler

range: Int32

Aralığın başlangıç veya bitiş noktası.

Özel durumlar

ArgumentException

rangeSpecifier geçersizdir.

InvalidOperationException

Aralık üst bilgisi eklenemedi.

Örnekler

Aşağıdaki kod örneği isteğe bir aralık üst bilgisi ekler.

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

Açıklamalar

yöntemi isteğe HttpWebRequest.AddRange bir bayt aralığı üst bilgisi ekler.

range Pozitifse parametresi aralığın range başlangıç noktasını belirtir. Sunucu, belirtilen parametreden range HTTP varlığındaki verilerin sonuna veri göndermeye başlamalıdır.

Negatifse range parametresi aralığın range bitiş noktasını belirtir. Sunucu, HTTP varlığındaki verilerin başlangıcından belirtilen parametreye veri göndermeye range başlamalıdır.

Sunucunun ilk 100 baytı (başlangıçtan bayt konumu 99'a) göndermesini isteyen http protokolü isteğindeki bir Aralık üst bilgisi örneği şöyle olabilir:

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

Bu örnekte range parametresi -99 olabilir.

HTTP sunucusu, Accept-Ranges üst bilgisi ile Aralık üst bilgileri desteğini gösterir. Bayt aralıklarını destekleyen bir sunucudan Accept-Ranges üst bilgisi örneği aşağıdaki gibi olabilir:

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

Sunucudan yanıtın üst bilgisinde bir Accept-Ranges üst bilgisi alınmazsa, sunucu Aralık üst bilgilerini desteklemez. Aralıkları desteklemeyen, ancak Accept-Ranges üst bilgisini tanıyan bir sunucudan Accept-Ranges üst bilgisi örneği aşağıdaki gibi olabilir:

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

Bir aralık isteğinden yanıt alınırken, yalnızca isteğin tamamıyla ilişkili HTTP üst bilgileri ayrıştırılır ve sınıfındaki HttpWebResponse özellikler aracılığıyla kullanılabilir hale getirilir. Her aralıkla ilişkili üst bilgiler yanıtta döndürülür.

Ayrıca bkz.

AddRange

Şunlara uygulanır

AddRange(Int64)

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

İstenen verilerin başından veya sonundan belirli bir aralık için isteğe bayt aralığı üst bilgisi ekler.

public:
 void AddRange(long range);

public void AddRange (long range);

member this.AddRange : int64 -> unit

Public Sub AddRange (range As Long)

Parametreler

range: Int64

Aralığın başlangıç veya bitiş noktası.

Özel durumlar

ArgumentException

rangeSpecifier geçersizdir.

InvalidOperationException

Aralık üst bilgisi eklenemedi.

Açıklamalar

yöntemi isteğe HttpWebRequest.AddRange bir bayt aralığı üst bilgisi ekler.

range Pozitifse parametresi aralığın range başlangıç noktasını belirtir. Sunucu, belirtilen parametreden range HTTP varlığındaki verilerin sonuna veri göndermeye başlamalıdır.

Sunucunun ilk 100 baytı (başlangıçtan bayt konumu 99'a) göndermesini isteyen http protokolü isteğindeki bir Aralık üst bilgisi örneği şöyle olabilir:

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

Bu örnekte range parametresi -99 olabilir.

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

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

Ayrıca bkz.

AddRange

Şunlara uygulanır

AddRange(Int32, Int32)

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Belirtilen aralık için isteğe bir bayt aralığı üst bilgisi ekler.

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)

Parametreler

from: Int32

Veri göndermeye başlayabileceğiniz konum.

to: Int32

Veri göndermeyi durduracağınız konum.

Özel durumlar

ArgumentException

rangeSpecifier geçersizdir.

ArgumentOutOfRangeException

from büyüktür to

-veya-

from veya to 0'dan küçüktür.

InvalidOperationException

Aralık üst bilgisi eklenemedi.

Örnekler

Aşağıdaki kod örneği isteğe bir aralık üst bilgisi ekler.

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

Açıklamalar

yöntemi isteğe HttpWebRequest.AddRange bir bayt aralığı üst bilgisi ekler.

HTTP protokolü isteğinde ilk 100 baytı isteyen bir Aralık üst bilgisi örneği aşağıdaki gibi olabilir:

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

Bu örnekte parametresi from 0, to parametresi ise 99 olarak belirtilebilir. Aralık tanımlayıcısı bu yöntem tarafından otomatik olarak "bayt" olarak ayarlanır.

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

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

Ayrıca bkz.

AddRange

Şunlara uygulanır

AddRange(Int64, Int64)

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Belirtilen aralık için isteğe bir bayt aralığı üst bilgisi ekler.

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)

Parametreler

from: Int64

Veri göndermeye başlayabileceğiniz konum.

to: Int64

Veri göndermeyi durduracağınız konum.

Özel durumlar

ArgumentException

rangeSpecifier geçersizdir.

ArgumentOutOfRangeException

from büyüktür to

-veya-

from veya to 0'dan küçüktür.

InvalidOperationException

Aralık üst bilgisi eklenemedi.

Açıklamalar

yöntemi isteğe HttpWebRequest.AddRange bir bayt aralığı üst bilgisi ekler.

HTTP protokolü isteğinde ilk 100 baytı isteyen bir Aralık üst bilgisi örneği aşağıdaki gibi olabilir:

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

Bu örnekte parametresi from 0, to parametresi ise 99 olarak belirtilebilir. Aralık tanımlayıcısı bu yöntem tarafından otomatik olarak "bayt" olarak ayarlanır.

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

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

Ayrıca bkz.

AddRange

Şunlara uygulanır

AddRange(String, Int32)

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

İstenen verilerin başından veya sonundan belirli bir aralık için isteğe Bir Aralık üst bilgisi ekler.

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)

Parametreler

rangeSpecifier: String

Aralığın açıklaması.

range: Int32

Aralığın başlangıç veya bitiş noktası.

Özel durumlar

ArgumentNullException

rangeSpecifier, null değeridir.

ArgumentException

rangeSpecifier geçersizdir.

InvalidOperationException

Aralık üst bilgisi eklenemedi.

Açıklamalar

yöntemi isteğe HttpWebRequest.AddRange bir Range üst bilgisi ekler.

range Pozitifse parametresi aralığın range başlangıç noktasını belirtir. Sunucu, belirtilen parametreden range HTTP varlığındaki verilerin sonuna veri göndermeye başlamalıdır.

rangeSpecifier Çoğu HTTP sunucusu tarafından tanınan tek aralık tanımlayıcısı olduğundan parametresi normalde "bayt" olarak belirtilir. parametresini rangeSpecifier başka bir dizeye ayarlamak bayt dışında özel aralık tanımlayıcıları için destek sağlar (IETF tarafından RFC 2616'da tanımlanan bayt aralığı tanımlayıcısı).

HTTP protokolü isteğinde ilk 100 baytı isteyen bir Aralık üst bilgisi örneği aşağıdaki gibi olabilir:

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

Bu örnekte, rangeSpecifier parametre "bayt" olarak belirtilebilir ve range parametre -99 olur.

HTTP sunucusu, yanıtta Accept-Ranges üst bilgisi olan Aralık üst bilgileri desteğini gösterir. Bayt aralıklarını destekleyen bir sunucudan Accept-Ranges üst bilgisi örneği aşağıdaki gibi olabilir:

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

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

Ayrıca bkz.

AddRange

Şunlara uygulanır

AddRange(String, Int64)

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

İstenen verilerin başından veya sonundan belirli bir aralık için isteğe Bir Aralık üst bilgisi ekler.

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)

Parametreler

rangeSpecifier: String

Aralığın açıklaması.

range: Int64

Aralığın başlangıç veya bitiş noktası.

Özel durumlar

ArgumentNullException

rangeSpecifier, null değeridir.

ArgumentException

rangeSpecifier geçersizdir.

InvalidOperationException

Aralık üst bilgisi eklenemedi.

Açıklamalar

yöntemi isteğe HttpWebRequest.AddRange bir Range üst bilgisi ekler.

range Pozitifse parametresi aralığın range başlangıç noktasını belirtir. Sunucu, belirtilen parametreden range HTTP varlığındaki verilerin sonuna veri göndermeye başlamalıdır.

HTTP protokolü isteğinde ilk 100 baytı isteyen bir Aralık üst bilgisi örneği aşağıdaki gibi olabilir:

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

Bu örnekte, rangeSpecifier parametre "bayt" olarak belirtilebilir ve range parametre -99 olur.

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

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

Ayrıca bkz.

AddRange

Şunlara uygulanır

AddRange(String, Int32, Int32)

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Belirtilen aralık için bir isteğe aralık üst bilgisi ekler.

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)

Parametreler

rangeSpecifier: String

Aralığın açıklaması.

from: Int32

Veri göndermeye başlayabileceğiniz konum.

to: Int32

Veri göndermeyi durduracağınız konum.

Özel durumlar

ArgumentNullException

rangeSpecifier, null değeridir.

ArgumentOutOfRangeException

from büyüktür to

-veya-

from veya to 0'dan küçüktür.

ArgumentException

rangeSpecifier geçersizdir.

InvalidOperationException

Aralık üst bilgisi eklenemedi.

Açıklamalar

yöntemi isteğe HttpWebRequest.AddRange bir Range üst bilgisi ekler.

HTTP protokolü isteğinde ilk 100 baytı isteyen bir Aralık üst bilgisi örneği aşağıdaki gibi olabilir:

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

Bu örnekte, rangeSpecifier parametre "bayt" olarak belirtilebilir, from parametre 0 ve to parametre 99 olur.

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

Accept-Ranges üst bilgisinde belirtilen dize, bu yöntemin parametresinde rangeSpecifier belirtilecek aralık belirticidir.

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

Ayrıca bkz.

AddRange

Şunlara uygulanır

AddRange(String, Int64, Int64)

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Kaynak:: HttpWebRequest.cs

Belirtilen aralık için bir isteğe aralık üst bilgisi ekler.

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)

Parametreler

rangeSpecifier: String

Aralığın açıklaması.

from: Int64

Veri göndermeye başlayabileceğiniz konum.

to: Int64

Veri göndermeyi durduracağınız konum.

Özel durumlar

ArgumentNullException

rangeSpecifier, null değeridir.

ArgumentOutOfRangeException

from büyüktür to

-veya-

from veya to 0'dan küçüktür.

ArgumentException

rangeSpecifier geçersizdir.

InvalidOperationException

Aralık üst bilgisi eklenemedi.

Açıklamalar

yöntemi isteğe HttpWebRequest.AddRange bir Range üst bilgisi ekler.

HTTP protokolü isteğinde ilk 100 baytı isteyen bir Aralık üst bilgisi örneği aşağıdaki gibi olabilir:

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

Bu örnekte, rangeSpecifier parametre "bayt" olarak belirtilebilir, from parametre 0 ve to parametre 99 olur.

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

Accept-Ranges üst bilgisinde belirtilen dize, bu yöntemin parametresinde rangeSpecifier belirtilecek aralık belirticidir.

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

Ayrıca bkz.

AddRange

Şunlara uygulanır

Share via

HttpWebRequest.AddRange Yöntem

Tanım

Aşırı Yüklemeler

Açıklamalar

AddRange(Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

AddRange(Int64)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

AddRange(Int32, Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

AddRange(Int64, Int64)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

AddRange(String, Int32)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

AddRange(String, Int64)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

AddRange(String, Int32, Int32)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

AddRange(String, Int64, Int64)

Parametreler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar