DataSourceCacheDurationConverter

.NET Framework クラス ライブラリ リファレンス

DataSourceCacheDurationConverter クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

32 ビット符号付き整数オブジェクトをデータ ソース コントロールのキャッシュの存続期間の表現に変換する処理、およびその逆の変換処理を行うための型コンバータを提供します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class DataSourceCacheDurationConverter
    Inherits Int32Converter

Visual Basic (使用法)

Dim instance As DataSourceCacheDurationConverter

C#

public class DataSourceCacheDurationConverter
 : Int32Converter

C++

public ref class DataSourceCacheDurationConverter
 : public Int32Converter

J#

public class DataSourceCacheDurationConverter
 extends Int32Converter

JScript

public class DataSourceCacheDurationConverter
 extends Int32Converter

解説

キャッシュをサポートする ASP.NET データ ソース コントロールには、通常、コントロールがデータをキャッシュする秒数を設定できる CacheDuration プロパティが用意されています。これらのキャッシュ コンテキストでは、値 0 は "無限" を表します。また、この明示的な変換は DataSourceCacheDurationConverter クラスで処理されます。

ページの開発者は、DataSourceCacheDurationConverter クラスを使用しません。キャッシュをサポートするデータ ソース コントロールを開発しているコントロールの開発者は、この種類のコンバータを TypeConverterAttribute 属性と共に使用して、カスタム データ ソース コントロールのキャッシュの存続期間の設定を表すプロパティを装飾します。

使用例

TypeConverterAttribute 属性を使用して、キャッシュをサポートするデータ ソース コントロールのプロパティを装飾する方法を次のコード例に示します。この例では、データ ソース コントロールはキャッシュのセマンティクスをサポートし、EnableCaching、CacheDuration、および CacheExpirationPolicy という、他の ASP.NET データ ソース コントロールに即してモデル化された 3 つのプロパティを公開します。CacheDuration プロパティは、DataSourceCacheDurationConverter 型コンバータを使用します。

Visual Basic

<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 'SomeDataSource 

C#

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 のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.ComponentModel.TypeConverter
     System.ComponentModel.BaseNumberConverter
       System.ComponentModel.Int32Converter
        System.Web.UI.DataSourceCacheDurationConverter

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataSourceCacheDurationConverter メンバ
System.Web.UI 名前空間
SqlDataSource.CacheDuration
ObjectDataSource.CacheDuration
XmlDataSource.CacheDuration
Int32Converter

DataSourceCacheDurationConverter コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

DataSourceCacheDurationConverter クラスの新しいインスタンスを初期化します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New DataSourceCacheDurationConverter

C#

public DataSourceCacheDurationConverter ()

C++

public:
DataSourceCacheDurationConverter ()

J#

public DataSourceCacheDurationConverter ()

JScript

public function DataSourceCacheDurationConverter
 ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataSourceCacheDurationConverter クラス
DataSourceCacheDurationConverter メンバ
System.Web.UI 名前空間

DataSourceCacheDurationConverter メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CanConvertFrom	オーバーロードされます。 DataSourceCacheDurationConverter インスタンスで、特定の型のオブジェクトを Int32 オブジェクトに変換できるかどうかを判断します。
	CanConvertTo	オーバーロードされます。 DataSourceCacheDurationConverter インスタンスでオブジェクトを変換先の特定の型に変換できるかどうかを示す値を返します。
	ConvertFrom	オーバーロードされます。 指定のオブジェクトを Int32 オブジェクトに変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 ( TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 ( TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 指定したオブジェクトを別の型に変換します。
	ConvertToInvariantString	オーバーロードされます。 指定した値を、インバリアント カルチャを使用した文字列形式に変換します。 ( TypeConverter から継承されます。)
	ConvertToString	オーバーロードされます。 指定した値を文字列形式に変換します。 ( TypeConverter から継承されます。)
	CreateInstance	オーバーロードされます。 Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。 ( TypeConverter から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetCreateInstanceSupported	オーバーロードされます。 このオブジェクトの値を変更するときに CreateInstance メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。 ( TypeConverter から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetProperties	オーバーロードされます。 value パラメータに指定された配列型のプロパティのコレクションを返します。 ( TypeConverter から継承されます。)
	GetPropertiesSupported	オーバーロードされます。 オブジェクトがプロパティをサポートしているかどうかを示す値を返します。 ( TypeConverter から継承されます。)
	GetStandardValues	オーバーロードされます。 DataSourceCacheDurationConverter インスタンスがデザインされた対象のデータ型について標準値のコレクションを返します。
	GetStandardValuesExclusive	オーバーロードされます。 GetStandardValues メソッドから返される標準値のコレクションが排他的なリストであるかどうかを指定します。
	GetStandardValuesSupported	オーバーロードされます。 リストから選択できる標準値セットをこのオブジェクトでサポートするかどうかを指定します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsValid	オーバーロードされます。 指定した値オブジェクトが型に対して有効かどうかを示す値を返します。 ( TypeConverter から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetConvertFromException	変換を実行できなかった場合にスローされる例外を返します。 ( TypeConverter から継承されます。)
	GetConvertToException	変換を実行できなかった場合にスローされる例外を返します。 ( TypeConverter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	SortProperties	プロパティのコレクションを並べ替えます。 ( TypeConverter から継承されます。)

参照

関連項目

DataSourceCacheDurationConverter クラス
System.Web.UI 名前空間
SqlDataSource.CacheDuration
ObjectDataSource.CacheDuration
XmlDataSource.CacheDuration
Int32Converter

DataSourceCacheDurationConverter メンバ

32 ビット符号付き整数オブジェクトをデータ ソース コントロールのキャッシュの存続期間の表現に変換する処理、およびその逆の変換処理を行うための型コンバータを提供します。

DataSourceCacheDurationConverter データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	DataSourceCacheDurationConverter	DataSourceCacheDurationConverter クラスの新しいインスタンスを初期化します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CanConvertFrom	オーバーロードされます。 DataSourceCacheDurationConverter インスタンスで、特定の型のオブジェクトを Int32 オブジェクトに変換できるかどうかを判断します。
	CanConvertTo	オーバーロードされます。 DataSourceCacheDurationConverter インスタンスでオブジェクトを変換先の特定の型に変換できるかどうかを示す値を返します。
	ConvertFrom	オーバーロードされます。 指定のオブジェクトを Int32 オブジェクトに変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 (TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 (TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 指定したオブジェクトを別の型に変換します。
	ConvertToInvariantString	オーバーロードされます。 指定した値を、インバリアント カルチャを使用した文字列形式に変換します。 (TypeConverter から継承されます。)
	ConvertToString	オーバーロードされます。 指定した値を文字列形式に変換します。 (TypeConverter から継承されます。)
	CreateInstance	オーバーロードされます。 Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。 (TypeConverter から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetCreateInstanceSupported	オーバーロードされます。 このオブジェクトの値を変更するときに CreateInstance メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。 (TypeConverter から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetProperties	オーバーロードされます。 value パラメータに指定された配列型のプロパティのコレクションを返します。 (TypeConverter から継承されます。)
	GetPropertiesSupported	オーバーロードされます。 オブジェクトがプロパティをサポートしているかどうかを示す値を返します。 (TypeConverter から継承されます。)
	GetStandardValues	オーバーロードされます。 DataSourceCacheDurationConverter インスタンスがデザインされた対象のデータ型について標準値のコレクションを返します。
	GetStandardValuesExclusive	オーバーロードされます。 GetStandardValues メソッドから返される標準値のコレクションが排他的なリストであるかどうかを指定します。
	GetStandardValuesSupported	オーバーロードされます。 リストから選択できる標準値セットをこのオブジェクトでサポートするかどうかを指定します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsValid	オーバーロードされます。 指定した値オブジェクトが型に対して有効かどうかを示す値を返します。 (TypeConverter から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetConvertFromException	変換を実行できなかった場合にスローされる例外を返します。 (TypeConverter から継承されます。)
	GetConvertToException	変換を実行できなかった場合にスローされる例外を返します。 (TypeConverter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	SortProperties	プロパティのコレクションを並べ替えます。 (TypeConverter から継承されます。)

参照

関連項目

DataSourceCacheDurationConverter クラス
System.Web.UI 名前空間
SqlDataSource.CacheDuration
ObjectDataSource.CacheDuration
XmlDataSource.CacheDuration
Int32Converter