Compartir a través de


Restricciones de parámetros de tipo genérico (C++/CLI)

En las declaraciones de método o tipo genérico, puede calificar un parámetro de tipo con restricciones. Una restricción es un requisito que deben satisfacer los tipos usados como argumentos de tipo. Por ejemplo, una restricción podría ser que el argumento de tipo debe implementar una determinada interfaz o heredar de una clase específica.

Las restricciones son opcionales; no especificar una restricción sobre un parámetro es equivalente a usar una restricción Object.

Sintaxis

where type-parameter : constraint-list

Parámetros

type-parameter
Uno de los identificadores de parámetro de tipo que se van a restringir.

constraint-list
Lista separada por comas de especificaciones de restricción. La lista puede incluir interfaces que se van a implementar por el type-parameter.

La lista puede incluir también una clase. Para que el argumento de tipo satisfaga una restricción de clase base, debe ser de la misma clase que la restricción o derivarse de ella. Especifique ref class para indicar que el argumento de tipo debe ser un tipo de referencia, incluido cualquier tipo class, interface, delegate o array. Especifique value class para indicar que el argumento de tipo debe ser un tipo de valor. Cualquier tipo de valor excepto Nullable<T> puede especificarse.

También puede especificar gcnew() para indicar que el argumento de tipo debe tener un constructor público sin parámetros.

También puede especificar un parámetro genérico como restricción. El argumento de tipo proporcionado para el tipo que se va a restringir debe ser o derivarse del tipo de restricción. Este parámetro se conoce como restricción de tipo "naked".

Comentarios

La cláusula de restricción consta de where seguido de un parámetro de tipo, dos puntos (:) y la restricción, que especifica la naturaleza de la restricción sobre el parámetro de tipo. where es una palabra clave contextual. Para obtener más información, consulte Palabras clave contextuales. Separe varias cláusulas where con un espacio.

Se aplican restricciones a parámetros de tipo para imponer limitaciones sobre los tipos que se pueden usar como argumentos con un tipo o método genérico.

Las restricciones de clase e interfaz especifican que los tipos de argumento deben ser o heredar de una clase especificada o implementar una interfaz especificada.

La aplicación de restricciones a un tipo o método genérico permite que el código de ese tipo o método aproveche las ventajas de las características conocidas de los tipos restringidos. Por ejemplo, se puede declarar una clase genérica como que el tipo de parámetro implementa la interfaz IComparable<T>:

// generics_constraints_1.cpp
// compile with: /c /clr
using namespace System;
generic <typename T>
where T : IComparable<T>
ref class List {};

Esta restricción requiere que un argumento de tipo usado para T implemente IComparable<T> en tiempo de compilación. También permite la llamada a métodos de interfaz, como CompareTo. Para llamar a métodos de interfaz, no hace falta ninguna conversión sobre una instancia del parámetro de tipo.

Los métodos estáticos de la clase del argumento de tipo no se pueden llamar mediante el parámetro de tipo, sino solo mediante el tipo con nombre real.

Una restricción no puede ser un tipo de valor, incluidos tipos integrados como int o double. Puesto que los tipos de valor no pueden tener clases derivadas, solo una clase podría satisfacer la restricción. En ese caso, el genérico se puede reescribir con el parámetro de tipo reemplazado por el tipo de valor específico.

En ocasiones, las restricciones son necesarias ya que el compilador no permitirá el uso de métodos u otras características de un tipo desconocido a menos que las restricciones impliquen que el tipo desconocido admite los métodos o interfaces.

Se pueden especificar varias restricciones para el mismo parámetro de tipo en una lista separada por comas

// generics_constraints_2.cpp
// compile with: /c /clr
using namespace System;
using namespace System::Collections::Generic;
generic <typename T>
where T : List<T>, IComparable<T>
ref class List {};

Con varios parámetros de tipo, use una cláusula where para cada uno. Por ejemplo:

// generics_constraints_3.cpp
// compile with: /c /clr
using namespace System;
using namespace System::Collections::Generic;

generic <typename K, typename V>
   where K: IComparable<K>
   where V: IComparable<K>
ref class Dictionary {};

Para usar restricciones en el código, siga las reglas siguientes:

  • Si aparecen varias restricciones, estas pueden mostrarse en cualquier orden.

  • Las restricciones también pueden ser tipos de clase, como clases base abstractas. Sin embargo, las restricciones no pueden ser tipos de valor o clases sealed.

  • Las restricciones no pueden ser por sí solas parámetros de tipo, pero pueden estar relacionadas con ellos en un tipo construido abierto. Por ejemplo:

    // generics_constraints_4.cpp
    // compile with: /c /clr
    generic <typename T>
    ref class G1 {};
    
    generic <typename Type1, typename Type2>
    where Type1 : G1<Type2>   // OK, G1 takes one type parameter
    ref class G2{};
    

Ejemplos

En el ejemplo siguiente se muestra cómo usar restricciones para llamar a métodos de instancia en parámetros de tipo.

// generics_constraints_5.cpp
// compile with: /clr
using namespace System;

interface class IAge {
   int Age();
};

ref class MyClass {
public:
   generic <class ItemType> where ItemType : IAge
   bool isSenior(ItemType item) {
      // Because of the constraint,
      // the Age method can be called on ItemType.
      if (item->Age() >= 65)
         return true;
      else
         return false;
   }
};

ref class Senior : IAge {
public:
   virtual int Age() {
      return 70;
   }
};

ref class Adult: IAge {
public:
   virtual int Age() {
      return 30;
   }
};

int main() {
   MyClass^ ageGuess = gcnew MyClass();
   Adult^ parent = gcnew Adult();
   Senior^ grandfather = gcnew Senior();

   if (ageGuess->isSenior<Adult^>(parent))
      Console::WriteLine("\"parent\" is a senior");
   else
      Console::WriteLine("\"parent\" is not a senior");

   if (ageGuess->isSenior<Senior^>(grandfather))
      Console::WriteLine("\"grandfather\" is a senior");
   else
      Console::WriteLine("\"grandfather\" is not a senior");
}
"parent" is not a senior
"grandfather" is a senior

Cuando se usa un parámetro de tipo genérico como restricción, esto se conoce como restricción de tipo "naked". Las restricciones de tipo "naked" son útiles cuando una función miembro con su propio parámetro de tipo tiene que restringir ese parámetro al parámetro de tipo del tipo contenedor.

En el ejemplo siguiente, T es una restricción de tipo "naked" en el contexto del método Add.

Las restricciones de tipo "naked" también se pueden utilizar en definiciones de clase genéricas. La utilidad de las restricciones de tipo "naked" con clases genéricas es limitada, ya que el compilador no puede dar por supuesto nada sobre la restricción de tipo "naked", excepto que se deriva de Object. Use restricciones de tipo "naked" sobre clases genéricas en situaciones en las que quiera aplicar una relación de herencia entre dos parámetros de tipo.

// generics_constraints_6.cpp
// compile with: /clr /c
generic <class T>
ref struct List {
   generic <class U>
   where U : T
   void Add(List<U> items)  {}
};

generic <class A, class B, class C>
where A : C
ref struct SampleClass {};

Consulte también

Genéricos