HttpWebRequest.IfModifiedSince Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Requests.dll

Źródło:

HttpWebRequest.cs

Pobiera lub ustawia wartość nagłówka HTTP If-Modified-Since.

public:
 property DateTime IfModifiedSince { DateTime get(); void set(DateTime value); };

public DateTime IfModifiedSince { get; set; }

member this.IfModifiedSince : DateTime with get, set

Public Property IfModifiedSince As DateTime

Wartość właściwości

DateTime

DateTime, który zawiera zawartość nagłówka http If-Modified-Since.

Przykłady

Poniższy przykład kodu sprawdza właściwość IfModifiedSince.

// Create a new 'Uri' object with the mentioned string.
Uri^ myUri = gcnew Uri( "http://www.contoso.com" );
  
// Create a new 'HttpWebRequest' object with the above 'Uri' object.
HttpWebRequest^ myHttpWebRequest = dynamic_cast<HttpWebRequest^>(WebRequest::Create( myUri ));
  
// Create a new 'DateTime' object.
DateTime targetDate = DateTime::Now;
// Set a target date of a week ago
targetDate.AddDays(-7.0);
myHttpWebRequest->IfModifiedSince = targetDate;

try
{
     
  // Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
  HttpWebResponse^ myHttpWebResponse = dynamic_cast<HttpWebResponse^>(myHttpWebRequest->GetResponse());
  Console::WriteLine( "Response headers \n {0}\n", myHttpWebResponse->Headers );
  Stream^ streamResponse = myHttpWebResponse->GetResponseStream();
  StreamReader^ streamRead = gcnew StreamReader( streamResponse );
  array<Char>^readBuff = gcnew array<Char>(256);
  int count = streamRead->Read( readBuff, 0, 256 );
  Console::WriteLine( "\nThe contents of Html Page are :  \n" );
  while ( count > 0 )
  {
    String^ outputData = gcnew String( readBuff,0,count );
    Console::Write( outputData );
    count = streamRead->Read( readBuff, 0, 256 );
  }
  streamResponse->Close();
  streamRead->Close();
     
  // Release the HttpWebResponse Resource.
  myHttpWebResponse->Close();
  Console::WriteLine( "\nPress 'Enter' key to continue................." );
  Console::Read();
}
catch ( WebException^ e )
{
  if (e->Response)
  {
    if ( ((HttpWebResponse ^)e->Response)->StatusCode == HttpStatusCode::NotModified)
      Console::WriteLine("\nThe page has not been modified since {0}", targetDate);
    else
      Console::WriteLine("\nUnexpected status code = {0}", ((HttpWebResponse ^)e->Response)->StatusCode);  
  }
  else
    Console::WriteLine("\nUnexpected Web Exception {0}" + e->Message); 
}

// Create a new 'Uri' object with the mentioned string.
Uri myUri =new Uri("http://www.contoso.com");			
// Create a new 'HttpWebRequest' object with the above 'Uri' object.
HttpWebRequest myHttpWebRequest= (HttpWebRequest)WebRequest.Create(myUri);

// Create a new 'DateTime' object.
DateTime targetDate = DateTime.Now;
// Set a target date of a week ago
targetDate.AddDays(-7.0);
myHttpWebRequest.IfModifiedSince = targetDate;

try
{
  // Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
  HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
  Console.WriteLine("Response headers for recently modified page\n{0}\n",myHttpWebResponse.Headers);
  Stream streamResponse=myHttpWebResponse.GetResponseStream();
  StreamReader streamRead = new StreamReader( streamResponse );
  Char[] readBuff = new Char[256];
  int count = streamRead.Read( readBuff, 0, 256 );
  Console.WriteLine("\nThe contents of Html Page are :  \n");	

  while (count > 0)
  {
    String outputData = new String(readBuff, 0, count);
    Console.Write(outputData);
    count = streamRead.Read(readBuff, 0, 256);
  }
  // Close the Stream object.
  streamResponse.Close();
  streamRead.Close();
  // Release the HttpWebResponse Resource.
  myHttpWebResponse.Close();
            
  Console.WriteLine("\nPress 'Enter' key to continue.................");	
  Console.Read();
}
catch(WebException e)
{
  if (e.Response != null)
  {
    if ( ((HttpWebResponse)e.Response).StatusCode == HttpStatusCode.NotModified)
      Console.WriteLine("\nThe page has not been modified since "+targetDate);
    else
      Console.WriteLine("\nUnexpected status code = " + ((HttpWebResponse)e.Response).StatusCode);
  }
  else
            {
                Console.WriteLine("\nUnexpected Web Exception " + e.Message);
            }
        }

' Create a new 'Uri' object with the mentioned string.
Dim myUri As New Uri("http://www.contoso.com")
' Create a new 'HttpWebRequest' object with the above 'Uri' object.
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create(myUri), HttpWebRequest)
' Create a new 'DateTime' object.
Dim targetDate As DateTime = DateTime.Now
targetDate.AddDays(-7.0)
myHttpWebRequest.IfModifiedSince = targetDate

Try
  ' Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
  Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
  Console.WriteLine("Response headers for recently modified page" + ControlChars.Cr + "{0}" + ControlChars.Cr, myHttpWebResponse.Headers)
  Dim streamResponse As Stream = myHttpWebResponse.GetResponseStream()
  Dim streamRead As New StreamReader(streamResponse)
  Dim readBuff(256) As [Char]
  Dim count As Integer = streamRead.Read(readBuff, 0, 256)
  Console.WriteLine(ControlChars.Cr + "The contents of Html Page are :  " + ControlChars.Cr)
  While count > 0
    Dim outputData As New [String](readBuff, 0, count)
    Console.Write(outputData)
    count = streamRead.Read(readBuff, 0, 256)
  End While

  ' Close the Stream object.
  streamResponse.Close()
  streamRead.Close()
  ' Release the HttpWebResponse Resource.
  myHttpWebResponse.Close()
  Console.WriteLine(ControlChars.Cr + "Press 'Enter' key to continue.................")
  Console.Read()
Catch e As WebException
  If e.Response IsNot Nothing
  
    If CType(e.Response,HttpWebResponse).StatusCode = HttpStatusCode.NotModified
      Console.WriteLine((ControlChars.Cr + "The page has not been modified since " + targetDate))
    Else
      Console.WriteLine(ControlChars.Cr + "Unexpected status code = " + Ctype(e.Response,HttpWebResponse).StatusCode)
    End If
  Else
    Console.WriteLine(ControlChars.Cr + "Unexpected Web Exception " + e.Message) 
  End If
End Try

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Jeśli nagłówek If-Modified-Since jest null, wartość zwracana zostanie ustawiona na wartość DateTime.MinValue.

Właściwość IfModifiedSince jest standardowym obiektem System.DateTime i może zawierać pole System.DateTimeKindDateTimeKind.Local, DateTimeKind.Utclub DateTimeKind.Unspecified. W przypadku używania właściwości IfModifiedSince można ustawić dowolny rodzaj czasu. Jeśli DateTimeKind.Unspecified jest ustawiona lub pobrana, przyjmuje się, że właściwość IfModifiedSince ma być DateTimeKind.Local (czas lokalny).

Klasy w przestrzeni nazw System.Net zawsze zapisują właściwość IfModifiedSince na przewodach podczas transmisji w postaci standardowej przy użyciu formatu GMT (Utc).

Jeśli właściwość IfModifiedSince jest ustawiona na DateTime.MinValue, nagłówek HTTP If-Modified-Since zostanie usunięty z właściwości Headers i WebHeaderCollection.

Jeśli właściwość IfModifiedSince jest DateTime.MinValue, oznacza to, że nagłówek HTTP If-Modified-Since nie jest uwzględniony we właściwości Headers i WebHeaderCollection.

Nuta

Wartość tej właściwości jest przechowywana w WebHeaderCollection. Jeśli parametr WebHeaderCollection jest ustawiony, wartość właściwości zostanie utracona.

Jeśli właściwość IfModifiedSince jest ustawiona i zostanie zwrócony kod stanu 304 (niezmodyfikowany), zostanie zwrócony System.Net.WebException przez metody BeginGetResponse, GetResponsei EndGetResponse.