DataSourceCacheDurationConverter Класс

Определение

public ref class DataSourceCacheDurationConverter : System::ComponentModel::Int32Converter

public class DataSourceCacheDurationConverter : System.ComponentModel.Int32Converter

type DataSourceCacheDurationConverter = class
    inherit Int32Converter

Public Class DataSourceCacheDurationConverter
Inherits Int32Converter

Наследование

Object

TypeConverter

BaseNumberConverter

Int32Converter

DataSourceCacheDurationConverter

Примеры

В следующем примере кода показано, как декорировать свойство в элементе управления источниками данных, поддерживающем кэширование с помощью атрибута TypeConverterAttribute . В этом примере элемент управления источником данных поддерживает семантику кэширования и предоставляет три свойства, моделироваемые после других элементов управления источниками данных ASP.NET: EnableCaching, CacheDuration и CacheExpirationPolicy. Свойство CacheDuration использует преобразователь DataSourceCacheDurationConverter типов.

using System;
using System.ComponentModel;
using System.Web.UI;
    
[ NonVisualControl() ]
public class SomeDataSource : DataSourceControl
{
    // Implementation of a custom data source control.
    
    // The SdsCache object is an imaginary cache object
    // provided for this example. It has not actual 
    // implementation.
    private SdsCache m_sdsCache = new SdsCache();
    internal SdsCache Cache {
        get { return m_sdsCache; }
    }
            
    [TypeConverterAttribute(typeof(DataSourceCacheDurationConverter))]
    public int CacheDuration {
        get { return Cache.Duration; }
    }
            
    public DataSourceCacheExpiry CacheExpirationPolicy {
        get { return Cache.Expiry; }
        set { Cache.Expiry = value; }
    }
    
    public bool EnableCaching {
        get { return Cache.Enabled; }
        set { Cache.Enabled = value; }
    }

    protected override DataSourceView GetView(string viewName)
    {
        throw new Exception("The method or operation is not implemented.");
    }
    
    // ...
}

<NonVisualControl()>  _
Public Class SomeDataSource
    Inherits DataSourceControl
    ' Implementation of a custom data source control.
    ' The SdsCache object is an imaginary cache object
    ' provided for this example. It has not actual 
    ' implementation.
    Private myCache As New SdsCache()

    Friend ReadOnly Property Cache() As SdsCache 
        Get
            Return myCache
        End Get
    End Property 

    <TypeConverterAttribute(GetType(DataSourceCacheDurationConverter))>  _
    Public ReadOnly Property CacheDuration() As Integer 
        Get
            Return Cache.Duration
        End Get
    End Property 

    Public Property CacheExpirationPolicy() As DataSourceCacheExpiry 
        Get
            Return Cache.Expiry
        End Get
        Set
            Cache.Expiry = value
        End Set
    End Property 

    Public Property EnableCaching() As Boolean 
        Get
            Return Cache.Enabled
        End Get
        Set
            Cache.Enabled = value
        End Set
    End Property 

    Protected Overrides Function GetView(ByVal viewName As String) As System.Web.UI.DataSourceView
        Throw New Exception("The method or operation is not implemented.")
    End Function
    
    ' Continue implementation of data source control.
    ' ...
    
End Class

Комментарии

ASP.NET элементы управления источниками данных, поддерживающие кэширование, обычно предоставляют свойство CacheDuration, которое можно задать для количества секунд, в течение которых данные кэшируются элементом управления. Значение 0 представляет "Infinite" в этих контекстах кэширования, и DataSourceCacheDurationConverter класс заботится об этом явном преобразовании.

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

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

• CacheDuration
• CacheDuration
• CacheDuration
• Int32Converter