StateManagedCollection.CreateKnownType(Int32) Metodo

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Quando sottoposto a override in una classe derivata, crea un'istanza di una classe che implementa IStateManager. Il tipo di oggetto creato si basa sul membro specificato della raccolta restituita dal GetKnownTypes() metodo .

protected:
 virtual System::Object ^ CreateKnownType(int index);
protected virtual object CreateKnownType(int index);
abstract member CreateKnownType : int -> obj
override this.CreateKnownType : int -> obj
Protected Overridable Function CreateKnownType (index As Integer) As Object

Parametri

index
Int32

Indice, dall'elenco ordinato di tipi restituiti da GetKnownTypes(), del tipo di IStateManager da creare.

Valori restituiti

Object

Istanza di una classe derivata da IStateManager, in base all'oggetto index fornito.

Eccezioni

InvalidOperationException

In tutti i casi in cui non viene eseguito l'override in una classe derivata.

Esempio

Nell'esempio di codice seguente viene illustrato come una classe fortemente tipizzata StateManagedCollection implementa il CreateKnownType metodo . L'implementazione CycleCollection di CreateKnownType restituisce l'istanza predefinita di un Bicycle oggetto o Tricycle , a seconda dell'indice passato. Questo esempio di codice fa parte di un esempio più ampio fornito per la StateManagedCollection classe .

//////////////////////////////////////////////////////////////
//
// 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();
    }
}

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

Commenti

Il CreateKnownType metodo viene chiamato internamente dalla StateManagedCollection raccolta nell'implementazione del StateManagedCollection.IStateManager.LoadViewState metodo . Le raccolte derivate eseguono l'override del CreateKnownType metodo per restituire un'istanza predefinita del IStateManager tipo identificato dall'oggetto fornito index, che esegue il GetKnownTypes mapping a uno dei tipi restituiti dal metodo .

Si applica a

Vedi anche