Como: Definir uma política de cache baseada na localização para um aplicativo

Artigo
04/07/2023

Políticas de cache com base no local permitem que um aplicativo defina explicitamente o comportamento do cache com base na localização do recurso solicitado. Este tópico demonstra como definir a política de cache programaticamente. Para obter informações sobre como configurar a política para um aplicativo usando os arquivos de configuração, veja o Elemento <requestCaching> (Configurações de Rede).

Para definir uma política de cache baseada na localização para um aplicativo

Crie um objeto RequestCachePolicy ou HttpRequestCachePolicy.
Defina o objeto de política como o padrão para o domínio do aplicativo.

Para definir uma política que toma recursos solicitados de um cache

Crie uma política que toma recursos solicitados de um cache se disponíveis e, caso contrário, envia solicitações ao servidor, definindo o nível de cache para CacheIfAvailable. Uma solicitação pode ser atendida por qualquer cache entre o cliente e servidor, incluindo caches remotos.

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

Para definir uma política que impede qualquer cache de fornecer recursos

Crie uma política que impede que qualquer cache forneça recursos solicitados, definindo o nível de cache para NoCacheNoStore. Esse nível de política remove o recurso do cache local se ele está presente e indica para caches remotos que eles também devem remover o recurso.

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

Para definir uma política que retorna os recursos solicitados apenas se eles estiverem no cache local

Criar uma política que retorna os recursos solicitados apenas se estiverem no cache local, definindo o nível de cache para CacheOnly. Se o recurso solicitado não estiver no cache, uma exceção WebException será lançada.

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

Para definir uma política que impede o cache local de fornecer recursos

Crie uma política que impede que o cache local forneça os recursos solicitados, definindo o nível de cache para Refresh. Se o recurso solicitado está em um cache intermediário e é revalidado com êxito, o cache intermediário pode fornecer o recurso solicitado.

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

Para definir uma política que impede qualquer cache de fornecer recursos solicitados

Crie uma política que impede que qualquer cache forneça recursos solicitados, definindo o nível de cache para Reload. O recurso retornado pelo servidor pode ser armazenado no cache.

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

Para definir uma política que permite que qualquer cache forneça recursos solicitados se o recurso no servidor não é mais recente do que a cópia armazenada em cache

Crie uma política que permite que qualquer cache forneça recursos solicitados se o recurso no servidor não é mais recente do que a cópia armazenada em cache definindo o nível de cache para 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