DataSourceCacheDurationConverter Classe

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Fornece um conversor de tipo para converter objetos inteiros com sinal de 32 bits de e para representações de duração do cache de controle da fonte de dados.

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 a seguir demonstra como você pode decorar uma propriedade em um controle de fonte de dados que dá suporte ao cache com um atributo TypeConverterAttribute. Neste exemplo, o controle da fonte de dados dá suporte à semântica de cache e expõe três propriedades modeladas após outros controles de fonte de dados ASP.NET: EnableCaching, CacheDuratione CacheExpirationPolicy. A propriedade CacheDuration usa o conversor de tipo 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

Comentários

ASP.NET controles de fonte de dados que dão suporte ao cache normalmente fornecem uma propriedade CacheDuration que você pode definir como o número de segundos que o controle armazena em cache dados. O valor 0 representa "Infinito" nesses contextos de cache e a classe DataSourceCacheDurationConverter cuida dessa conversão explícita.

Os desenvolvedores de páginas não usam a classe DataSourceCacheDurationConverter. Controlar os desenvolvedores que estão desenvolvendo controles de fonte de dados que dão suporte ao cache usam esse conversor de tipo juntamente com o atributo TypeConverterAttribute para decorar uma propriedade que representa uma configuração de duração de cache de um controle de fonte de dados personalizado.

Construtores

DataSourceCacheDurationConverter()

Inicializa uma nova instância da classe DataSourceCacheDurationConverter.

Métodos

CanConvertFrom(ITypeDescriptorContext, Type)	Determina se o DataSourceCacheDurationConverter pode converter um objeto no tipo de origem fornecido em um objeto Int32.
CanConvertFrom(Type)	Retorna se esse conversor pode converter um objeto do tipo fornecido no tipo desse conversor. (Herdado de TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Retorna um valor que indica se a instância de DataSourceCacheDurationConverter pode converter um objeto no tipo de destino fornecido.
CanConvertTo(Type)	Retorna se esse conversor pode converter o objeto no tipo especificado. (Herdado de TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Converte o objeto especificado em um objeto Int32.
ConvertFrom(Object)	Converte o valor fornecido no tipo desse conversor. (Herdado de TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Converte a cadeia de caracteres fornecida no tipo desse conversor, usando a cultura invariável e o contexto especificado. (Herdado de TypeConverter)
ConvertFromInvariantString(String)	Converte a cadeia de caracteres fornecida no tipo desse conversor, usando a cultura invariável. (Herdado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Converte o texto fornecido em um objeto, usando as informações de contexto e cultura especificadas. (Herdado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Converte o texto fornecido em um objeto usando o contexto especificado. (Herdado de TypeConverter)
ConvertFromString(String)	Converte o texto especificado em um objeto. (Herdado de TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Converte o objeto especificado em outro tipo.
ConvertTo(Object, Type)	Converte o objeto de valor fornecido no tipo especificado, usando os argumentos. (Herdado de TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Converte o valor especificado em uma representação de cadeia de caracteres invariável de cultura usando o contexto especificado. (Herdado de TypeConverter)
ConvertToInvariantString(Object)	Converte o valor especificado em uma representação de cadeia de caracteres invariável por cultura. (Herdado de TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Converte o valor fornecido em uma representação de cadeia de caracteres usando as informações de contexto e cultura especificadas. (Herdado de TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Converte o valor fornecido em uma representação de cadeia de caracteres usando o contexto fornecido. (Herdado de TypeConverter)
ConvertToString(Object)	Converte o valor especificado em uma representação de cadeia de caracteres. (Herdado de TypeConverter)
CreateInstance(IDictionary)	Recria um Object dado um conjunto de valores de propriedade para o objeto. (Herdado de TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Cria uma instância do tipo ao qual esse TypeConverter está associado, usando o contexto especificado, dado um conjunto de valores de propriedade para o objeto. (Herdado de TypeConverter)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetConvertFromException(Object)	Retorna uma exceção a ser gerada quando uma conversão não pode ser executada. (Herdado de TypeConverter)
GetConvertToException(Object, Type)	Retorna uma exceção a ser gerada quando uma conversão não pode ser executada. (Herdado de TypeConverter)
GetCreateInstanceSupported()	Retorna se alterar um valor nesse objeto requer uma chamada para o método CreateInstance(IDictionary) para criar um novo valor. (Herdado de TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Retorna se alterar um valor nesse objeto requer uma chamada para CreateInstance(IDictionary) para criar um novo valor, usando o contexto especificado. (Herdado de TypeConverter)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor, usando o contexto e os atributos especificados. (Herdado de TypeConverter)
GetProperties(ITypeDescriptorContext, Object)	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor, usando o contexto especificado. (Herdado de TypeConverter)
GetProperties(Object)	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor. (Herdado de TypeConverter)
GetPropertiesSupported()	Retorna se esse objeto dá suporte a propriedades. (Herdado de TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Retorna se esse objeto dá suporte a propriedades, usando o contexto especificado. (Herdado de TypeConverter)
GetStandardValues()	Retorna uma coleção de valores padrão do contexto padrão para o tipo de dados para o qual esse conversor de tipo foi projetado. (Herdado de TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Retorna uma coleção de valores padrão para o tipo de dados para o qual a instância DataSourceCacheDurationConverter foi projetada.
GetStandardValuesExclusive()	Retorna se a coleção de valores padrão retornados de GetStandardValues() é uma lista exclusiva. (Herdado de TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Especifica se a coleção de valores padrão retornados do método GetStandardValues é uma lista exclusiva, usando o contexto especificado.
GetStandardValuesSupported()	Retorna se esse objeto dá suporte a um conjunto padrão de valores que podem ser escolhidos em uma lista. (Herdado de TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Especifica se o objeto DataSourceCacheDurationConverter dá suporte a um conjunto padrão de valores que podem ser escolhidos em uma lista, usando o contexto especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsValid(ITypeDescriptorContext, Object)	Retorna se o objeto de valor fornecido é válido para esse tipo e para o contexto especificado. (Herdado de TypeConverter)
IsValid(Object)	Retorna se o objeto de valor fornecido é válido para esse tipo. (Herdado de TypeConverter)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
SortProperties(PropertyDescriptorCollection, String[])	Classifica uma coleção de propriedades. (Herdado de TypeConverter)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• CacheDuration
• CacheDuration
• CacheDuration
• Int32Converter