StateManagedCollection.CreateKnownType(Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Quando substituído em uma classe derivada, cria uma instância de uma classe que implementa IStateManager. O tipo de objeto criado se baseia no membro especificado da coleção retornada pelo método GetKnownTypes().
protected:
virtual System::Object ^ CreateKnownType(int index);protected virtual object CreateKnownType (int index);abstract member CreateKnownType : int -> obj
override this.CreateKnownType : int -> objProtected Overridable Function CreateKnownType (index As Integer) As ObjectParâmetros
- index
- Int32
O índice, na lista ordenada de tipos retornados por GetKnownTypes(), do tipo de IStateManager a se criar.
Retornos
Uma instância de uma classe derivada de IStateManager, de acordo com o index fornecido.
Exceções
Em todos os casos quando não é substituído em uma classe derivada.
Exemplos
O exemplo de código a seguir demonstra como uma classe fortemente tipada StateManagedCollection implementa o CreateKnownType método. A CycleCollection implementação de CreateKnownType retorna a instância padrão de um Bicycle ou Tricycle objeto, dependendo do índice passado. Este exemplo de código faz parte de um exemplo maior fornecido para a 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
Comentários
O CreateKnownType método é chamado internamente pela StateManagedCollection coleção em sua implementação do StateManagedCollection.IStateManager.LoadViewState método. Coleções derivadas substituem o CreateKnownType método para retornar uma instância padrão do IStateManager tipo identificado pelo fornecido index, que mapeia para um dos tipos retornados GetKnownTypes pelo método.