HttpRequestCachePolicy 생성자

정의

네임스페이스:

System.Net.Cache

어셈블리:

System.Net.Requests.dll

HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.

오버로드

HttpRequestCachePolicy()	HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.
HttpRequestCachePolicy(DateTime)	지정된 캐시 동기화 날짜를 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.
HttpRequestCachePolicy(HttpRequestCacheLevel)	지정된 캐시 정책을 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	지정된 보관 기간 제어 및 시간 값을 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	지정된 최대 보관 기간, 보관 기간 제어 및 시간 값을 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	지정된 최대 보관 기간, 보관 기간 제어 값, 시간 값 및 캐시 동기화 날짜를 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.

HttpRequestCachePolicy()

Source:

HttpRequestCachePolicy.cs

HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy ();

Public Sub New ()

예제

다음 코드 예제에서는이 생성자를 사용 하 여 캐시 정책을 설정 하는 방법을 보여 줍니다.

static WebResponse^ GetResponseUsingCacheDefault( Uri^ uri )
{
   // Set  the default cache policy level for the "http:" scheme.
   RequestCachePolicy^ policy = gcnew RequestCachePolicy;

   // Create the request.
   WebRequest^ request = WebRequest::Create( uri );
   request->CachePolicy = policy;
   WebResponse^ response = request->GetResponse();
   Console::WriteLine( L"Policy level is {0}.", policy->Level );
   Console::WriteLine( L"Is the response from the cache? {0}", response->IsFromCache );
   return response;
}

public static WebResponse GetResponseUsingCacheDefault(Uri uri)
{
    // Set  the default cache policy level for the "http:" scheme.
    RequestCachePolicy policy = new RequestCachePolicy();
    // Create the request.
    WebRequest request = WebRequest.Create(uri);
    request.CachePolicy = policy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("Policy level is {0}.", policy.Level.ToString());
    Console.WriteLine("Is the response from the cache? {0}", response.IsFromCache);

    return response;
}

설명

이 생성자는 Level 속성을 Default로 초기화합니다.

HttpRequestCachePolicy(DateTime)

Source:

HttpRequestCachePolicy.cs

지정된 캐시 동기화 날짜를 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.

public:
 HttpRequestCachePolicy(DateTime cacheSyncDate);

public HttpRequestCachePolicy (DateTime cacheSyncDate);

new System.Net.Cache.HttpRequestCachePolicy : DateTime -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheSyncDate As DateTime)

매개 변수

cacheSyncDate

DateTime

캐시에 저장된 리소스의 유효성을 다시 검사해야 할 시간을 지정하는 DateTime 개체입니다.

예제

다음 코드 예제에서는 캐시 동기화 날짜를 기반으로 캐시 정책을 만드는 방법을 보여 줍니다.

static HttpRequestCachePolicy^ CreateLastSyncPolicy( DateTime when )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( when );
   Console::WriteLine( L"When: {0}", when );
   Console::WriteLine( policy->CacheSyncDate );
   return policy;
}

public static HttpRequestCachePolicy CreateLastSyncPolicy(DateTime when)
{
    HttpRequestCachePolicy policy =
       new HttpRequestCachePolicy(when);

    Console.WriteLine("When: {0}", when);
    Console.WriteLine(policy.CacheSyncDate.ToString());
    return policy;
}

설명

캐시 동기화 날짜를 사용하면 캐시된 콘텐츠의 유효성을 검사해야 하는 절대 날짜를 지정할 수 있습니다. 캐시 동기화 날짜 이전에 캐시 항목의 유효성을 마지막으로 다시 검사한 경우 서버와의 유효성 재검사이 발생합니다. 캐시 동기화 날짜 이후에 캐시 항목의 유효성을 다시 검사하고 캐시된 항목을 유효하지 않은 서버 유효성 검사 요구 사항이 없는 경우 캐시의 항목이 사용됩니다. 캐시 동기화 날짜가 미래의 특정 날짜로 설정된 경우 캐시 동기화 날짜가 지날 때까지 요청될 때마다 항목의 유효성이 재검사됩니다.

이 생성자는 Level 속성을 Default로 초기화합니다. CacheSyncDate 속성이 cacheSyncDate으로 초기화됩니다.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Source:

HttpRequestCachePolicy.cs

지정된 캐시 정책을 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpRequestCacheLevel level);

public HttpRequestCachePolicy (System.Net.Cache.HttpRequestCacheLevel level);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpRequestCacheLevel -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (level As HttpRequestCacheLevel)

매개 변수

level

HttpRequestCacheLevel

HttpRequestCacheLevel 값입니다.

예제

다음 코드 예제에서는 캐시에서 찾은 리소스를 캐시에서 사용할 수 있는 캐시 정책을 만드는 방법을 보여 줍니다.

static HttpRequestCachePolicy^ CreateCacheIfAvailablePolicy()
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::CacheIfAvailable );
   Console::WriteLine( policy );
   return policy;
}

public static HttpRequestCachePolicy CreateCacheIfAvailablePolicy()
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpRequestCacheLevel.CacheIfAvailable);

    Console.WriteLine(policy.ToString());
    return policy;
}

설명

이 생성자는 Level 속성을 level로 초기화합니다.

값은 HttpRequestCacheLevel 캐싱을 사용할 수 있는지 여부와 캐시를 사용할 수 있는 시기를 제어합니다. 자세한 내용은 설명서를 HttpRequestCacheLevel 참조하세요.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Source:

HttpRequestCachePolicy.cs

지정된 보관 기간 제어 및 시간 값을 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpCacheAgeControl cacheAgeControl, TimeSpan ageOrFreshOrStale);

public HttpRequestCachePolicy (System.Net.Cache.HttpCacheAgeControl cacheAgeControl, TimeSpan ageOrFreshOrStale);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpCacheAgeControl * TimeSpan -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheAgeControl As HttpCacheAgeControl, ageOrFreshOrStale As TimeSpan)

매개 변수

cacheAgeControl

HttpCacheAgeControl

HttpCacheAgeControl 열거형 값인 MaxAge, MaxStale 또는 MinFresh 중 하나입니다.

ageOrFreshOrStale

TimeSpan

시간을 지정하는 TimeSpan 값입니다.

예외

ArgumentException

cacheAgeControl 매개 변수에 지정된 값을 이 생성자와 함께 사용할 수 없는 경우

예제

다음 코드 예제에서는 최소 새로 고침을 기반으로 캐시 정책을 만드는 방법을 보여 줍니다.

static HttpRequestCachePolicy^ CreateMinFreshPolicy( TimeSpan span )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MinFresh,span );
   Console::WriteLine( L"Minimum freshness {0}", policy->MinFresh );
   return policy;
}

public static HttpRequestCachePolicy CreateMinFreshPolicy(TimeSpan span)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MinFresh, span);
    Console.WriteLine("Minimum freshness {0}", policy.MinFresh.ToString());
    return policy;
}

설명

값은 cacheAgeControl 매개 변수 값의 ageOrFreshOrStale 의미를 정의하고 연결된 속성을 설정하는 데 사용됩니다. 예를 들어 를 지정 MaxStaleMaxStale 하면 속성이 매개 변수의 값으로 ageOrFreshOrStale 설정됩니다.

이 생성자는 Level 속성을 Default로 초기화합니다.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Source:

HttpRequestCachePolicy.cs

지정된 최대 보관 기간, 보관 기간 제어 및 시간 값을 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale);

public HttpRequestCachePolicy (System.Net.Cache.HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpCacheAgeControl * TimeSpan * TimeSpan -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheAgeControl As HttpCacheAgeControl, maxAge As TimeSpan, freshOrStale As TimeSpan)

매개 변수

cacheAgeControl

HttpCacheAgeControl

HttpCacheAgeControl 값입니다.

maxAge

TimeSpan

리소스의 최대 보관 기간을 지정하는 TimeSpan 값입니다.

freshOrStale

TimeSpan

시간을 지정하는 TimeSpan 값입니다.

예외

ArgumentException

cacheAgeControl 매개 변수에 지정된 값이 잘못된 경우

예제

다음 코드 예제에서는 최소 새로 고침 및 최대 사용 기간을 기반으로 캐시 정책을 만드는 방법을 보여 줍니다.

static HttpRequestCachePolicy^ CreateFreshAndAgePolicy( TimeSpan freshMinimum, TimeSpan ageMaximum )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MaxAgeAndMinFresh,
       ageMaximum, freshMinimum );
   Console::WriteLine( policy );
   return policy;
}

public static HttpRequestCachePolicy CreateFreshAndAgePolicy(TimeSpan freshMinimum, TimeSpan ageMaximum)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh, ageMaximum, freshMinimum);
    Console.WriteLine(policy.ToString());
    return policy;
}

설명

값은 cacheAgeControl 매개 변수 값의 freshOrStale 의미를 해석하고 연결된 속성을 설정하는 데 사용됩니다. 예를 들어 를 지정 MaxStaleMaxStale 하면 속성이 매개 변수의 값으로 freshOrStale 설정됩니다. 를 지정 MaxAgeAndMaxStaleMaxAge 하면 속성은 매개 변수 값을 maxAge 사용하여 설정되고 MaxStale 속성은 매개 변수 값을 freshOrStale 사용하여 설정됩니다.

또는 MaxAgeAndMinFresh를 지정 MaxAgeAndMaxStale 하지 않으면 속성이 MaxAge 설정되지 않습니다.

이 생성자는 Level 속성을 Default로 초기화합니다.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Source:

HttpRequestCachePolicy.cs

지정된 최대 보관 기간, 보관 기간 제어 값, 시간 값 및 캐시 동기화 날짜를 사용하여 HttpRequestCachePolicy 클래스의 새 인스턴스를 초기화합니다.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale, DateTime cacheSyncDate);

public HttpRequestCachePolicy (System.Net.Cache.HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale, DateTime cacheSyncDate);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpCacheAgeControl * TimeSpan * TimeSpan * DateTime -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheAgeControl As HttpCacheAgeControl, maxAge As TimeSpan, freshOrStale As TimeSpan, cacheSyncDate As DateTime)

매개 변수

cacheAgeControl

HttpCacheAgeControl

HttpCacheAgeControl 값입니다.

maxAge

TimeSpan

리소스의 최대 보관 기간을 지정하는 TimeSpan 값입니다.

freshOrStale

TimeSpan

시간을 지정하는 TimeSpan 값입니다.

cacheSyncDate

DateTime

캐시에 저장된 리소스의 유효성을 다시 검사해야 할 시간을 지정하는 DateTime 개체입니다.

예제

다음 코드 예제에서는 최소 새로 고침, 최대 사용 기간 및 캐시 동기화 날짜를 기반으로 캐시 정책을 만드는 방법을 보여 줍니다.

static HttpRequestCachePolicy^ CreateFreshAndAgePolicy2( TimeSpan freshMinimum, TimeSpan ageMaximum, DateTime when )
{
   HttpRequestCachePolicy^ policy = 
       gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MaxAgeAndMinFresh, 
       ageMaximum, freshMinimum, when );
   Console::WriteLine( policy );
   return policy;
   
   // For the following invocation: CreateFreshAndAgePolicy(new TimeSpan(5,0,0), new TimeSpan(10,0,0),         );
   // the output is:
   // Level:Automatic AgeControl:MinFreshAndMaxAge MinFresh:18000 MaxAge:36000
}

public static HttpRequestCachePolicy CreateFreshAndAgePolicy2(TimeSpan freshMinimum, TimeSpan ageMaximum, DateTime when)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh, ageMaximum, freshMinimum, when);
    Console.WriteLine(policy.ToString());
    return policy;
    // For the following invocation:
    // CreateFreshAndAgePolicy(new TimeSpan(5,0,0), new TimeSpan(10,0,0),);
    // the output is:
    // Level:Automatic
    // AgeControl:MinFreshAndMaxAge
    // MinFresh:18000
    // MaxAge:36000
}

설명

값은 cacheAgeControl 매개 변수 값의 freshOrStale 의미를 해석하고 연결된 속성을 설정하는 데 사용됩니다. 예를 들어 를 지정 MaxStaleMaxStale 하면 속성이 매개 변수의 값으로 freshOrStale 설정됩니다. 를 지정 MaxAgeAndMaxStaleMaxAge 하면 속성은 매개 변수 값을 maxAge 사용하여 설정되고 MaxStale 속성은 매개 변수 값을 freshOrStale 사용하여 설정됩니다.

또는 MaxAgeAndMinFresh를 지정 MaxAgeAndMaxStale 하지 않으면 속성이 MaxAge 설정되지 않습니다.

이 생성자는 속성을 cacheSyncDate로 초기화 CacheSyncDate 하고 속성을 Default로 초기화합니다Level.