Прочитать на английском

Поделиться через

SqlDataSource.CacheDuration Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает длину промежутка времени (в секундах), в течение которого элемент управления источником данных кэширует данные, извлекаемые методом Select(DataSourceSelectArguments).

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataSourceCacheDurationConverter))]
public virtual int CacheDuration { get; set; }

Значение свойства

Int32

Количество секунд, на протяжении которых объект SqlDataSource кэширует результаты операции Select(DataSourceSelectArguments). Значение по умолчанию равно 0. Значение не может быть отрицательным.

Атрибуты
TypeConverterAttribute

Примеры

В следующем примере кода показано, как получить данные из базы данных Northwind в Microsoft SQL Server и отобразить их в элементе GridView управления с включенным кэшированием данных. Для CacheDuration параметра задано значение 20 секунд. Так как CacheExpirationPolicy свойство имеет Absolute значение по умолчанию, пользователи этой страницы будут видеть свежие данные каждые 20 секунд.

<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                DataSourceMode="DataSet"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                EnableCaching="True"
                CacheDuration="20"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees">
            </asp:SqlDataSource>

            <asp:GridView
                id="GridView1"
                runat="server"
                AutoGenerateColumns="False"
                DataSourceID="SqlDataSource1">
                <columns>
                    <asp:BoundField HeaderText="First Name" DataField="FirstName" />
                    <asp:BoundField HeaderText="Last Name" DataField="LastName" />
                    <asp:BoundField HeaderText="Title" DataField="Title" />
                </columns>
            </asp:GridView>

        </form>
    </body>
</html>

Комментарии

Элемент SqlDataSource управления поддерживает кэширование данных. Пока данные кэшируются, метод извлекает данные из кэша, Select а не из базовой базы данных. По истечении срока действия кэша Select метод извлекает данные из базовой базы данных, а затем снова кэширует данные.

Элемент SqlDataSource управления автоматически кэширует данные, если свойству EnableCaching присвоено значение true , а CacheDuration свойству присваивается значение больше 0, указывающее время в секундах, в течение которого кэш хранит данные до удаления записи кэша. Значение 0 указывает на бесконечно длинный кэш.

Поведение кэша определяется сочетанием длительности и CacheExpirationPolicy свойства . Если свойству CacheExpirationPolicyAbsolute присвоено значение , SqlDataSource данные кэшируются при первой операции извлечения данных, хранятся в памяти в течение не более времени, указанного свойством CacheDuration . Данные могут быть освобождены до истечения длительности, если требуется память. Затем кэш обновляется во время следующей операции. Если свойству CacheExpirationPolicy присвоено Sliding значение , элемент управления источником данных кэширует данные при первой операции извлечения данных, но сбрасывает период времени, в котором он хранит кэш для каждой последующей операции. Срок действия кэша истекает, если не было действий в течение времени, равного значению CacheDuration с момента последней Select операции.

Элемент SqlDataSource управления может кэшировать данные только в DataSet режиме . Метод NotSupportedException создает Select исключение, если SqlDataSource для элемента управления задано DataReader значение и кэширование также включено.

Важно!

При использовании олицетворения клиента в рамках проверки подлинности Microsoft Windows данные кэшируются, когда первый пользователь обращается к данным. Если другой пользователь запрашивает те же данные, данные извлекаются из кэша. Данные не извлекаются путем другого вызова базы данных для проверки доступа пользователя к данным. Если вы ожидаете, что несколько пользователей будут получать доступ к данным и хотите, чтобы каждое извлечение данных проверялось конфигурациями безопасности базы данных, не используйте кэширование.

Применяется к

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

См. также раздел