ASP.NET Redis için Azure Cache için Çıktı Önbelleği Sağlayıcısı

Redis Çıkış Önbelleği Sağlayıcısı, çıktı önbelleği verileri için işlem dışı bir depolama mekanizmasıdır. Bu veriler tam HTTP yanıtları (sayfa çıktısını önbelleğe alma) için özel olarak kullanılır. Sağlayıcı, ASP.NET 4'te tanıtıldı yeni çıktı önbelleği sağlayıcı genişletilebilirlik noktasına takıyor. Uygulama ASP.NET Core için, ASP.NET Core'da yanıt önbelleğe alma makalesini okuyun.

Redis Çıkış Önbelleği Sağlayıcısını kullanmak için önce önbelleğinizi ve ardından Redis Çıkış ASP.NET Sağlayıcısı NuGet yapılandırmanız gerekir. Bu makalede, redis çıkış önbelleği sağlayıcısını kullanmak üzere uygulama yapılandırma hakkında rehberlik sağlar. Bir önbellek örneği oluşturma ve yapılandırma hakkında daha fazla Redis için Azure Cache için bkz. Önbellek oluşturma.

Sayfa ASP.NET önbellekte depolama

Redis için Azure Cache Session State NuGet paketini kullanarak Visual Studio istemci uygulamasını yapılandırmak için Araçlar menüsünden NuGet Paket Yöneticisi, Paket Yöneticisi Konsolu'nu seçin.

Package Manager Console penceresinden aşağıdaki komutu çalıştırın.

Install-Package Microsoft.Web.RedisOutputCacheProvider

Redis Çıkış Önbelleği Sağlayıcısı NuGet StackExchange.Redis paketine bağımlılığı vardır. StackExchange.Redis paketi projenize dahil değilse yüklenir. Redis Çıkış Önbelleği Sağlayıcısı NuGet daha fazla bilgi için RedisOutputCacheProvider NuGet bakın.

Bu NuGet, gerekli derleme başvurularını indirir ve ekler ve aşağıdaki bölümü web.config ekler. Bu bölüm, redis çıkış önbelleği sağlayıcısını ASP.NET için gerekli yapılandırmayı içerir.

<caching>
  <outputCache defaultProvider="MyRedisOutputCache">
    <providers>
      <add name="MyRedisOutputCache" type="Microsoft.Web.Redis.RedisOutputCacheProvider"
           host=""
           accessKey=""
           ssl="true" />
    </providers>
  </outputCache>
</caching>

Sol tarafta, Microsoft Azure portalında önbelleğinizin değerleriyle Microsoft Azure yapılandırabilirsiniz. Ayrıca, istediğiniz diğer değerleri de yapılandırarak. Önbellek özelliklerinize erişme yönergeleri için bkz. Redis için Azure Cache yapılandırma.

Öznitelik notları

ConnectionString ayarlanıyor

ConnectionString 'in değeri, appSettings içinde bu tür bir dize varsa, appSettings 'ten gerçek bağlantı dizesini getirmek için anahtar olarak kullanılır. AppSettings içinde bulunmazsa, ConnectionString değeri web.config ConnectionString bölümünden gerçek bağlantı dizesini getirmek için anahtar olarak kullanılır, bu bölüm varsa. Bağlantı dizesi AppSettings 'de veya web.config ConnectionString bölümünde yoksa, StackExchange. redsıs. connectionçoğullayıcı oluşturulurken bağlantı dizesi olarak ConnectionString öğesinin sabit değeri kullanılacaktır.

Aşağıdaki örneklerde, ConnectionString 'in nasıl kullanıldığı gösterilmektedir.

Örnek 1

<connectionStrings>
    <add name="MyRedisConnectionString" connectionString="mycache.redis.cache.windows.net:6380,password=actual access key,ssl=True,abortConnect=False" />
</connectionStrings>

' De web.config , yukarıdaki anahtarı gerçek değer yerine parametre değeri olarak kullanın.

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvide"
             name = "MySessionStateStore"
             connectionString = "MyRedisConnectionString"/>
    </providers>
</sessionState>

Örnek 2

<appSettings>
    <add key="MyRedisConnectionString" value="mycache.redis.cache.windows.net:6380,password=actual access key,ssl=True,abortConnect=False" />
</appSettings>

' De web.config , yukarıdaki anahtarı gerçek değer yerine parametre değeri olarak kullanın.

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvide"
             name = "MySessionStateStore"
             connectionString = "MyRedisConnectionString"/>
    </providers>
</sessionState>

Örnek 3

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvide"
             name = "MySessionStateStore"
             connectionString = "mycache.redis.cache.windows.net:6380,password=actual access key,ssl=True,abortConnect=False"/>
    </providers>
</sessionState>

ThrowOnError hakkındaki notlar

Şu anda bir oturum işlemi sırasında bir hata oluşursa, oturum durumu sağlayıcısı bir özel durum oluşturur. Özel durumu oluşturmak uygulamayı kapatır.

bu davranış, mevcut ASP.NET oturum durumu sağlayıcısı kullanıcılarının beklentilerini destekleyen bir şekilde değiştirilmiştir ve aynı zamanda özel durumlar üzerinde işlem yapmanızı sağlar. varsayılan davranış yine bir hata oluştuğunda, diğer ASP.NET oturum durumu sağlayıcılarıyla tutarlı bir özel durum oluşturur. Mevcut kod, önceki ile aynı şekilde çalışmalıdır.

ThrowOnError değerini false olarak ayarlarsanız bir hata oluştuğunda özel durum oluşturmak yerine sessizce başarısız olur. Bir hata olup olmadığını görmek için, özel durumun ne olduğunu bulun, Microsoft. Web. redsıs. RedisSessionStateProvider. LastException statik özelliğini denetleyin.

Retrytimeoutınmilliseconds üzerine notlar

Retrytimeoutınmilliseconds ayarı bir ağ hatası veya başka bir şey nedeniyle bir oturum işleminin hata durumunda yeniden deneneceği durumu basitleştirmek için bazı mantık sağlar. Retrytimeoutınmilliseconds ayarı, yeniden deneme zaman aşımını denetlemenize veya yeniden denememeyi tamamen devre dışı bırakmanıza olanak tanır.

Retrytimeoutınmilliseconds ' ı bir sayıya ayarlarsanız, örneğin 2000, bir oturum işlemi başarısız olduğunda, bir hata olarak davranmadan önce 2000 milisaniyeye yeniden dener. Oturum durumu sağlayıcısı 'nın bu yeniden deneme mantığını uygulaması için zaman aşımını yapılandırmanız yeterlidir. İlk yeniden deneme 20 milisaniyelik sonra gerçekleşecektir, bu da çoğu durumda bir ağ hatası oluştuğunda yeterlidir. Bundan sonra, zaman aşımına uğrayana kadar her saniye yeniden dener. Zaman aşımından hemen sonra, zaman aşımını (en fazla) bir saniye kesmeyeceği için bir kez daha yeniden dener.

Yeniden deneme gerektiğini düşünmezseniz veya yeniden deneme mantığını kendiniz işlemek istiyorsanız, Retrytimeoutınmilliseconds ' ı 0 olarak ayarlayın. Örneğin, Redsıs sunucusunu uygulamanızla aynı makinede çalıştırırken yeniden denemek istemeyebilirsiniz.

Redisserializertype hakkında

Değerleri redin üzerinde depolamak için serileştirme, varsayılan olarak BinaryFormatter sınıfı tarafından belirtilen ikili biçimde yapılır. Microsoft. Web. Red. ISerializer uygulayan bir sınıfın derleme nitelikli tür adını belirtmek Için redisserializertype kullanın ve değerleri seri hale getirmek ve seri durumdan çıkarmak için özel mantık vardır. Örneğin, JSON.NET kullanarak bir JSON serileştirici sınıfı aşağıda verilmiştir:

namespace MyCompany.Redis
{
    public class JsonSerializer : ISerializer
    {
        private static JsonSerializerSettings _settings = new JsonSerializerSettings() { TypeNameHandling = TypeNameHandling.All };

        public byte[] Serialize(object data)
        {
            return Encoding.UTF8.GetBytes(JsonConvert.SerializeObject(data, _settings));
        }

        public object Deserialize(byte[] data)
        {
            if (data == null)
            {
                return null;
            }
            return JsonConvert.DeserializeObject(Encoding.UTF8.GetString(data), _settings);
        }
    }
}

Bu sınıfın Mycompanydll adlı bir derlemede tanımlandığını varsayarsak, parametresini kullanmak Için Redisserializertype parametresini ayarlayabilirsiniz:

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvider"
             name = "MySessionStateStore"
             redisSerializerType = "MyCompany.Redis.JsonSerializer,MyCompanyDll"
             ... />
    </providers>
</sessionState>

Çıktı önbelleği yönergesi

Çıktıyı önbelleğe almak istediğiniz her sayfaya bir OutputCache yönergesi ekleyin.

<%@ OutputCache Duration="60" VaryByParam="*" %>

Önceki örnekte, önbelleğe alınan sayfa verileri 60 saniye boyunca önbellekte kalır ve sayfanın farklı bir sürümü her bir parametre birleşimi için önbelleğe alınır. OutputCache yönergesi hakkında daha fazla bilgi için bkz @OutputCache ..

Bu adımları uyguladıktan sonra, uygulamanız Redsıs çıkış önbelleği sağlayıcısını kullanacak şekilde yapılandırılır.

Üçüncü taraf çıkış önbelleği sağlayıcıları

• NCache
• Apache Ignite

Sonraki adımlar

redsıs için Azure önbelleği ASP.NET oturum durumu sağlayıcısınagöz atın.