DataSourceCacheDurationConverter-Klasse

ASP.NET-Datenquellensteuerelemente, die Zwischenspeicherung unterstützen, stellen i. d. R. eine CacheDuration-Eigenschaft bereit, die Sie auf die Anzahl von Sekunden festlegen können, für die das Steuerelement Daten zwischenspeichert. Der Wert 0 gibt in diesem Zwischenspeicherungskontext "Infinite" an, und die DataSourceCacheDurationConverter-Klasse behandelt diese explizite Konvertierung.

Seitenentwickler verwenden die DataSourceCacheDurationConverter-Klasse nicht. Steuerelemententwickler, die Datenquellensteuerelemente mit Unterstützung von Zwischenspeicherung entwickeln, verwenden diesen Typkonverter gemeinsam mit dem TypeConverterAttribute-Attribut, um eine Eigenschaft zu ergänzen, die eine Cachedauereinstellung eines benutzerdefinierten Datenquellensteuerelements darstellt.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine Eigenschaft in einem Datenquellensteuerelement ergänzen können, das die Zwischenspeicherung mit einem TypeConverterAttribute-Attribut unterstützt. In diesem Beispiel unterstützt das Datenquellensteuerelement Zwischenspeicherungssemantik und macht drei Eigenschaften verfügbar, die nach anderen ASP.NET-Datenquellensteuerelementen modelliert sind: EnableCaching, CacheDuration und CacheExpirationPolicy. Die CacheDuration-Eigenschaft verwendet den DataSourceCacheDurationConverter-Typkonverter.

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.");
    }

    // ...
}

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz