Freigeben über

Generische Typparameter (C#-Programmierhandbuch)

  • Artikel

Bei der Definition eines generischen Typs oder einer Methode ist ein Typparameter ein Platzhalter für einen bestimmten Typ, den ein Client angibt, wenn eine Variable des generischen Typs instanziiert werden soll. Eine generische Klasse, z. B. die unter Einführung in Generika (C#-Programmierhandbuch) aufgelistete Klasse GenericList<T>, kann nicht ohne Anpassung verwendet werden, denn die Klasse ist nicht wirklich ein Typ. Sie ist mehr wie eine Kopie eines Typs. Um GenericList<T> verwenden zu können, muss der Clientcode einen konstruierten Typ deklarieren und instanziieren, indem er ein Typargument in spitzen Klammern angibt. Das Typargument für diese spezielle Klasse kann jeder Typ sein, der vom Compiler erkannt wird. Instanzen von konstruierten Typen können in beliebiger Zahl erstellt werden, wobei jede Instanz ein anderes Typargument verwendet, z. B.:

GenericList<float> list1 = new GenericList<float>();
GenericList<ExampleClass> list2 = new GenericList<ExampleClass>();
GenericList<ExampleStruct> list3 = new GenericList<ExampleStruct>();

Bei jeder dieser Instanzen von GenericList<T> wird jedes Vorkommen von T in der Klasse zur Laufzeit durch das Typargument ersetzt. Aufgrund dieser Ersetzung werden drei separate typsichere und effiziente Objekte mithilfe einer einzigen Klassendefinition erstellt. Weitere Informationen dazu, wie diese Ersetzung von der CLR ausgeführt wird, finden Sie unter Generika zur Laufzeit (C#-Programmierhandbuch).

Richtlinien für die Benennung von Typparametern

  • Verwenden Sie zur Benennung von generischen Typparametern beschreibende Namen, es sei denn, ein Name aus einem einzelnen Buchstaben reicht als Erklärung völlig aus, und ein beschreibender Name würde das Verständnis für den Namen nicht wirklich erhöhen.

    public interface ISessionChannel<TSession> { /*...*/ }
public delegate TOutput Converter<TInput, TOutput>(TInput from);
public class List<T> { /*...*/ }

  • Verwenden Sie T als Typparametername für Typen, die einen einzelnen Buchstaben als Typparameter haben.

    public int IComparer<T>() { return 0; }
public delegate bool Predicate<T>(T item);
public struct Nullable<T> where T : struct { /*...*/ }

  • Verwenden Sie das Präfix "T" für beschreibende Typparameternamen.

    public interface ISessionChannel<TSession>
{
    TSession Session { get; }
}

  • Überlegen Sie, ob Sie Einschränkungen, die für einen Typparameter gelten, im Namen des Parameters angeben möchten. Ein auf ISession eingeschränkter Parameter könnte z. B. TSession genannt werden.

Siehe auch

Referenz

Generika (C#-Programmierhandbuch)

Unterschiede zwischen C++-Vorlagen und C#-Generika (C#-Programmierhandbuch)

System.Collections.Generic

Konzepte

C#-Programmierhandbuch