StateManagedCollection.GetKnownTypes メソッド

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

StateManagedCollection.GetKnownTypes メソッド

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

派生クラスでオーバーライドされた場合、StateManagedCollection コレクションに格納できる IStateManager 型の配列を取得します。

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

Visual Basic (宣言)

Protected Overridable Function
 GetKnownTypes As Type()

Visual Basic (使用法)

Dim returnValue As Type()

returnValue = Me.GetKnownTypes

C#

protected virtual Type[] GetKnownTypes ()

C++

protected:
virtual array<Type^>^ GetKnownTypes ()

J#

protected Type[] GetKnownTypes ()

JScript

protected function GetKnownTypes () : Type[]

戻り値
コレクションに格納できる IStateManager オブジェクトの型を識別する Type オブジェクトの順番に並べられた配列。既定の実装では、null 参照 (Visual Basic では Nothing) が返されます。

解説

GetKnownTypes メソッドは、System.Web.UI.IStateManager.SaveViewState メソッド実装での StateManagedCollection コレクションによって内部的に呼び出されます。派生コレクションは、GetKnownTypes メソッドをオーバーライドして、コレクションに格納できる型を表す Type オブジェクトの配列を返します。

使用例

厳密に型指定された StateManagedCollection クラスが GetKnownTypes メソッドを実装する方法を次のコード例に示します。GetKnownTypes の CycleCollection 実装は、Bicycle 型と Tricycle 型が含まれる既知の型の Type 配列を返します。このコード例は、StateManagedCollection クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

'////////////////////////////////////////////////////////////
'
' The strongly typed CycleCollection class is a collection
' that contains Cycle class instances, which implement the
' IStateManager interface.
'
'////////////////////////////////////////////////////////////
<AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
               Public NotInheritable Class
 CycleCollection
    Inherits StateManagedCollection

    Private Shared _typesOfCycles() As
 Type = _
        {GetType(Bicycle), GetType(Tricycle)}

    Protected Overrides Function
 CreateKnownType(ByVal index As Integer)
 As Object
        Select Case index
            Case 0
                Return New Bicycle()
            Case 1
                Return New Tricycle()
            Case Else
                Throw New ArgumentOutOfRangeException("Unknown
 Type")
        End Select

    End Function


    Protected Overrides Function
 GetKnownTypes() As Type()
        Return _typesOfCycles

    End Function


    Protected Overrides Sub
 SetDirtyObject(ByVal o As Object)
        CType(o, Cycle).SetDirty()

    End Sub
End Class

C#

//////////////////////////////////////////////////////////////
//
// The strongly typed CycleCollection class is a collection
// that contains Cycle class instances, which implement the
// IStateManager interface.
//
//////////////////////////////////////////////////////////////
[AspNetHostingPermission(SecurityAction.Demand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
public sealed class CycleCollection : StateManagedCollection
 {
    
    private static readonly Type[] _typesOfCycles
 
        = new Type[] { typeof(Bicycle), typeof(Tricycle) };

    protected override object CreateKnownType(int
 index) {
        switch(index) {
            case 0:
                return new Bicycle();
            case 1:
                return new Tricycle();    
                
            default:
                throw new ArgumentOutOfRangeException("Unknown
 Type");
        }            
    }

    protected override Type[] GetKnownTypes() {
        return _typesOfCycles;
    }

    protected override void SetDirtyObject(object
 o) {
        ((Cycle)o).SetDirty();
    }

}

プラットフォーム

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

参照

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