DataSourceCacheDurationConverter Класс

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Предоставляет конвертер типа для преобразования 32-разрядных целых со знаком объектов в представления времени кэширования в элементе управления источника данных, и обратно.

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 атрибутом для декорирования свойства, представляющего параметр длительности кэша пользовательского элемента управления источником данных.

Конструкторы

DataSourceCacheDurationConverter()

Инициализирует новый экземпляр класса DataSourceCacheDurationConverter.

Методы

CanConvertFrom(ITypeDescriptorContext, Type)	Определяет, может ли экземпляр DataSourceCacheDurationConverter преобразовать объект указанного исходного типа в объект Int32.
CanConvertFrom(Type)	Возвращает значение, указывающее, может ли этот преобразователь преобразовать объект заданного типа к типу этого преобразователя. (Унаследовано от TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Возвращает значение, показывающее, может ли экземпляр DataSourceCacheDurationConverter преобразовать объект в заданный целевой тип.
CanConvertTo(Type)	Возвращает значение, указывающее, может ли этот преобразователь выполнить преобразование данного объекта к заданному типу. (Унаследовано от TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Преобразует указанный объект в объект Int32.
ConvertFrom(Object)	Приводит заданное значение к типу этого преобразователя. (Унаследовано от TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Преобразует заданную строку к типу этого преобразователя, используя нейтральные язык и региональные параметры вместе с заданным контекстом. (Унаследовано от TypeConverter)
ConvertFromInvariantString(String)	Преобразует заданную строку к типу этого преобразователя, используя нейтральные язык и региональные параметры. (Унаследовано от TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Преобразует заданный текст в объект, используя заданный контекст и сведения о языке и региональных параметрах. (Унаследовано от TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Преобразует заданный текст в объект, используя заданный контекст. (Унаследовано от TypeConverter)
ConvertFromString(String)	Преобразует заданный текст в объект. (Унаследовано от TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Преобразует указанный объект в другой тип.
ConvertTo(Object, Type)	Преобразует данное значение в указанный тип, используя заданные аргументы. (Унаследовано от TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Преобразует указанное значение в строковое представление для нейтральных языка и региональных параметров. (Унаследовано от TypeConverter)
ConvertToInvariantString(Object)	Преобразует указанное значение в строковое представление для нейтральных языка и региональных параметров. (Унаследовано от TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Преобразует данное значение в заданный тип, используя заданный контекст и сведения о языке и региональных параметрах. (Унаследовано от TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Преобразует данное значение в строку, используя данный контекст. (Унаследовано от TypeConverter)
ConvertToString(Object)	Преобразует указанное значение в строковое представление. (Унаследовано от TypeConverter)
CreateInstance(IDictionary)	Повторно создает объект Object, задающий набор значений свойств для объекта. (Унаследовано от TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Создает экземпляр типа, с которым связан этот TypeConverter, используя заданный контекст с учетом набора значений свойств для объекта. (Унаследовано от TypeConverter)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetConvertFromException(Object)	Возвращает исключение, возникающее в случае, если невозможно выполнить преобразование. (Унаследовано от TypeConverter)
GetConvertToException(Object, Type)	Возвращает исключение, возникающее в случае, если невозможно выполнить преобразование. (Унаследовано от TypeConverter)
GetCreateInstanceSupported()	Возвращает значение, показывающее, требуется ли при изменении значения этого объекта вызывать метод CreateInstance(IDictionary), чтобы создать новое значение. (Унаследовано от TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Возвращает значение, указывающее, требуется ли для изменения значения в этом объекте вызов CreateInstance(IDictionary), чтобы создать новое значение с помощью указанного контекста. (Унаследовано от TypeConverter)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetProperties(ITypeDescriptorContext, Object)	Возвращает коллекцию свойств для типа массива, заданного параметром, используя заданный контекст. (Унаследовано от TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Возвращает коллекцию свойств для типа массива, заданного параметром value, используя заданные контекст и атрибуты. (Унаследовано от TypeConverter)
GetProperties(Object)	Возвращает коллекцию свойств для типа массива, заданного параметром значения. (Унаследовано от TypeConverter)
GetPropertiesSupported()	Возвращает значение, показывающее, поддерживаются ли свойства этим объектом. (Унаследовано от TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Возвращает значение, показывающее, поддерживает ли данный объект свойства, используя заданный контекст. (Унаследовано от TypeConverter)
GetStandardValues()	Возвращает коллекцию стандартных значений из контекста по умолчанию для типа данных, для которого предназначен этот преобразователь типов. (Унаследовано от TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Возвращает коллекцию стандартных значений типа, для которого создан экземпляр DataSourceCacheDurationConverter.
GetStandardValuesExclusive()	Возвращает значение, показывающее, является ли исчерпывающим списком коллекция стандартных значений, возвращаемая методом GetStandardValues(). (Унаследовано от TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Определяет, является ли коллекция стандартных значений, возвращаемых из метода GetStandardValues эксклюзивных списком при использовании указанного контекста.
GetStandardValuesSupported()	Возвращает значение, показывающее, поддерживает ли объект стандартный набор значений, которые можно выбрать из списка. (Унаследовано от TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Показывает, поддерживает ли объект DataSourceCacheDurationConverter стандартный набор значений, которые можно выбрать из списка, используя заданный контекст.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsValid(ITypeDescriptorContext, Object)	Возвращает значение, показывающее, допустим ли для этого типа и указанного контекста данный объект значения. (Унаследовано от TypeConverter)
IsValid(Object)	Возвращает значение, показывающее, допустим ли для этого типа данный объект значения. (Унаследовано от TypeConverter)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
SortProperties(PropertyDescriptorCollection, String[])	Сортирует коллекцию свойств. (Унаследовано от TypeConverter)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

• CacheDuration
• CacheDuration
• CacheDuration
• Int32Converter