Практическое руководство. Установка политики кэша для приложения на основе расположения

Статья
04/07/2023

Политики кэша на основе расположения позволяют приложению явным образом определить поведение кэша на основе расположения запрошенного ресурса. В этом разделе описана установка политики кэша программным способом. Сведения о настройке политики для приложения с помощью файлов конфигурации см. в разделе <requestCaching> Element (Network Параметры).

Установка политики кэша для приложения на основе расположения

Создайте объект RequestCachePolicy или HttpRequestCachePolicy.
Установите этот объект политики как объект по умолчанию для домена приложения.

Установка политики, которая принимает запрошенные ресурсы из кэша

Создайте политику, которая принимает запрошенные ресурсы из кэша, если они есть в кэше. В противном случае запросы отправляются на сервер с помощью установки уровня кэширования CacheIfAvailable. Для выполнения запроса может использоваться любой кэш между клиентом и сервером, включая удаленный кэш.
```
public static void UseCacheIfAvailable()  
{  
    HttpRequestCachePolicy policy = new HttpRequestCachePolicy  
        (HttpRequestCacheLevel.CacheIfAvailable);  
    HttpWebRequest.DefaultCachePolicy = policy;  
}  
```
```
Public Shared Sub UseCacheIfAvailable()  
    Dim policy As New HttpRequestCachePolicy _  
         (HttpRequestCacheLevel.CacheIfAvailable)  
    HttpWebRequest.DefaultCachePolicy = policy  
End Sub  
```

Установка политики, которая полностью запрещает получение ресурсов из кэша

Создайте политику, которая полностью запрещает получение запрошенных ресурсов из кэша, установив уровень кэширования NoCacheNoStore. С этой политикой ресурс удаляется из локального кэша (если он присутствует в локальном кэше), а также из удаленных кэшей.
```
public static void DoNotUseCache()  
{  
HttpRequestCachePolicy policy = new HttpRequestCachePolicy
        (HttpRequestCacheLevel.NoCacheNoStore);  
    HttpWebRequest.DefaultCachePolicy = policy;  
}  
```
```
Public Shared Sub DoNotUseCache()  
    Dim policy As New HttpRequestCachePolicy _  
        (HttpRequestCacheLevel.NoCacheNoStore)  
    HttpWebRequest.DefaultCachePolicy = policy  
End Sub  
```

Установка политики, которая возвращает запрошенные ресурсы, только если они присутствуют в локальном кэше

Создайте политику, которая возвращает запрошенные ресурсы только в том случае, если они присутствуют в локальном кэше, установив уровень кэширования CacheOnly. Если запрошенный ресурс отсутствует в кэше, выдается исключение WebException.
```
public static void OnlyUseCache()  
{  
    HttpRequestCachePolicy policy = new HttpRequestCachePolicy
        (HttpRequestCacheLevel.CacheOnly);  
    HttpWebRequest.DefaultCachePolicy = policy;  
}  
```
```
Public Shared Sub OnlyUseCache()  
    Dim policy As New HttpRequestCachePolicy _  
        (HttpRequestCacheLevel.CacheOnly)  
    HttpWebRequest.DefaultCachePolicy = policy  
End Sub  
```

Установка политики, которая запрещает получение ресурсов из локального кэша

Создайте политику, которая запрещает получение запрошенных ресурсов из локального кэша, установив уровень кэширования Refresh. Если запрошенный ресурс находится в промежуточном кэше и успешно проверен, ресурс может быть возвращен из промежуточного кэша.
```
public static void DoNotUseLocalCache()  
{  
 HttpRequestCachePolicy policy = new HttpRequestCachePolicy
        (HttpRequestCacheLevel.Refresh);  
    HttpWebRequest.DefaultCachePolicy = policy;  
}  
```
```
Public Shared Sub DoNotUseLocalCache()  
    Dim policy As New HttpRequestCachePolicy _  
        (HttpRequestCacheLevel.Refresh)  
    HttpWebRequest.DefaultCachePolicy = policy  
End Sub  
```

Установка политики, которая полностью запрещает получение запрошенных ресурсов из кэша

Создайте политику, которая полностью запрещает получение запрошенных ресурсов из кэша, установив уровень кэширования Reload. Ресурс, возвращенный сервером, может быть сохранен в кэше.

public static void SendToServer()  
{  
HttpRequestCachePolicy policy = new HttpRequestCachePolicy
        (HttpRequestCacheLevel.Reload);  
    HttpWebRequest.DefaultCachePolicy = policy;  
}

Public Shared Sub SendToServer()  
    Dim policy As New HttpRequestCachePolicy _  
        (HttpRequestCacheLevel.Reload)  
    HttpWebRequest.DefaultCachePolicy = policy  
End Sub

Установка политики, которая разрешает получение запрошенных ресурсов из любого кэша, если кэшированная копия не старше ресурса на сервере

Создайте политику, которая разрешает получение запрошенных ресурсов из любого кэша, если кэшированная копия не старше ресурса на сервере, установив уровень кэширования Revalidate.

public static void CheckServer()  
{  
HttpRequestCachePolicy policy = new HttpRequestCachePolicy  
         (HttpRequestCacheLevel.Revalidate);  
    HttpWebRequest.DefaultCachePolicy = policy;  
}

Public Shared Sub CheckServer()  
    Dim policy As New HttpRequestCachePolicy _  
        (HttpRequestCacheLevel.Revalidate)  
    HttpWebRequest.DefaultCachePolicy = policy  
End Sub