DataSourceCacheDurationConverter Classe

Definição

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

public class DataSourceCacheDurationConverter : System.ComponentModel.Int32Converter

type DataSourceCacheDurationConverter = class
    inherit Int32Converter

Public Class DataSourceCacheDurationConverter
Inherits Int32Converter

Herança

Object

TypeConverter

BaseNumberConverter

Int32Converter

DataSourceCacheDurationConverter

Exemplos

O exemplo de código seguinte demonstra como se pode decorar uma propriedade num controlo de fonte de dados que suporta cache com um TypeConverterAttribute atributo. Neste exemplo, o controlo de fonte de dados suporta a semântica de cache e expõe três propriedades modeladas a partir de outros controlos de fonte de dados ASP.NET: EnableCaching, CacheDuration e CacheExpirationPolicy. A CacheDuration propriedade utiliza o conversor DataSourceCacheDurationConverter de tipos.

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

Observações

ASP.NET controlos de fonte de dados que suportam cache normalmente fornecem uma propriedade CacheDuration que pode definir para o número de segundos em que o controlo armazena os dados em cache. O valor 0 representa "Infinito" nestes contextos de cache, e a DataSourceCacheDurationConverter classe trata desta conversão explícita.

Os programadores de páginas não usam a DataSourceCacheDurationConverter classe. Os programadores de controlo que desenvolvem controlos de fonte de dados que suportam cache utilizam este tipo de conversor juntamente com o TypeConverterAttribute atributo para decorar uma propriedade que representa a definição de duração do cache de um controlo de fonte de dados personalizado.

Ver também

• CacheDuration
• CacheDuration
• CacheDuration
• Int32Converter