MethodInfo.GetGenericMethodDefinition Метод

Определение

Пространство имен:

System.Reflection

Сборка:

System.Runtime.dll

Исходный код:

MethodInfo.cs

Возвращает объект MethodInfo, представляющий определение универсального метода, на основе которого можно сконструировать текущий метод.

public:
 virtual System::Reflection::MethodInfo ^ GetGenericMethodDefinition();

public virtual System.Reflection.MethodInfo GetGenericMethodDefinition ();

abstract member GetGenericMethodDefinition : unit -> System.Reflection.MethodInfo
override this.GetGenericMethodDefinition : unit -> System.Reflection.MethodInfo

Public Overridable Function GetGenericMethodDefinition () As MethodInfo

Возвращаемое значение

MethodInfo

Объект MethodInfo, представляющий определение универсального метода, на основе которого может быть сконструирован текущий метод.

Исключения

InvalidOperationException

Текущий метод не является универсальным. То есть IsGenericMethod возвращает false.

NotSupportedException

Этот метод не поддерживается.

Примеры

В следующем примере кода показан класс с универсальным методом и код, необходимый MethodInfo для получения для метода , привязки метода к аргументам типа и получения исходного определения универсального типа из связанного метода.

Этот пример является частью более крупного примера, предоставленного MakeGenericMethod для метода .

// Define a class with a generic method.
ref class Example
{
public:
    generic<typename T> static void Generic(T toDisplay)
    {
        Console::WriteLine("\r\nHere it is: {0}", toDisplay);
    }
};

// Define a class with a generic method.
public class Example
{
    public static void Generic<T>(T toDisplay)
    {
        Console.WriteLine("\r\nHere it is: {0}", toDisplay);
    }
}

' Define a class with a generic method.
Public Class Example
    Public Shared Sub Generic(Of T)(ByVal toDisplay As T)
        Console.WriteLine(vbCrLf & "Here it is: {0}", toDisplay)
    End Sub
End Class

// Create a Type object representing class Example, and
// get a MethodInfo representing the generic method.
//
Type^ ex = Example::typeid;
MethodInfo^ mi = ex->GetMethod("Generic");

DisplayGenericMethodInfo(mi);

// Assign the int type to the type parameter of the Example 
// method.
//
MethodInfo^ miConstructed = mi->MakeGenericMethod(int::typeid);

DisplayGenericMethodInfo(miConstructed);

// Create a Type object representing class Example, and
// get a MethodInfo representing the generic method.
//
Type ex = typeof(Example);
MethodInfo mi = ex.GetMethod("Generic");

DisplayGenericMethodInfo(mi);

// Assign the int type to the type parameter of the Example
// method.
//
MethodInfo miConstructed = mi.MakeGenericMethod(typeof(int));

DisplayGenericMethodInfo(miConstructed);

' Create a Type object representing class Example, and
' get a MethodInfo representing the generic method.
'
Dim ex As Type = GetType(Example)
Dim mi As MethodInfo = ex.GetMethod("Generic")

DisplayGenericMethodInfo(mi)

' Assign the Integer type to the type parameter of the Example 
' method.
'
Dim arguments() As Type = { GetType(Integer) }
Dim miConstructed As MethodInfo = mi.MakeGenericMethod(arguments)

DisplayGenericMethodInfo(miConstructed)

// Get the generic type definition from the closed method,
// and show it's the same as the original definition.
//
MethodInfo^ miDef = miConstructed->GetGenericMethodDefinition();
Console::WriteLine("\r\nThe definition is the same: {0}",
        miDef == mi);

// Get the generic type definition from the closed method,
// and show it's the same as the original definition.
//
MethodInfo miDef = miConstructed.GetGenericMethodDefinition();
Console.WriteLine("\r\nThe definition is the same: {0}",
    miDef == mi);

' Get the generic type definition from the constructed method,
' and show that it's the same as the original definition.
'
Dim miDef As MethodInfo = miConstructed.GetGenericMethodDefinition()
Console.WriteLine(vbCrLf & "The definition is the same: {0}", _
    miDef Is mi)

Комментарии

Определение универсального метода — это шаблон, на основе которого можно создать методы. Например, из определения T M<T>(T t) универсального метода (выраженного в синтаксисе C#; Function M(Of T)(ByVal tVal As T) As T в Visual Basic) можно создать и вызвать метод int M<int>(int t) (Function M(Of Integer)(ByVal tVal As Integer) As Integer в Visual Basic). При выборе объекта, MethodInfo представляющего этот сконструированный метод, GetGenericMethodDefinition метод возвращает определение универсального метода.

Если два сконструированных метода создаются из одного определения универсального GetGenericMethodDefinition метода, метод возвращает один и тот же MethodInfo объект для обоих методов.

При вызове GetGenericMethodDefinition для объекта , MethodInfo который уже представляет определение универсального метода, он возвращает текущий MethodInfo.

Если определение универсального метода содержит универсальные параметры объявляющего типа, будет использоваться определение универсального метода, относяющееся к каждому сконструированному типу. Например, рассмотрим следующий код C#, Visual Basic и C++:

class B<U,V> {}
class C<T> { public B<T,S> M<S>() {...}}

Class B(Of U, V)
End Class
Class C(Of T)
    Public Function M(Of S)() As B(Of T, S)
        ...
    End Function
End Class

generic <typename U, typename V> ref class B {};
generic <typename T> ref class C
{
public:
    generic <typename S> B<T,S>^ M() {...};
};

В созданном типе C<int> (C(Of Integer) в Visual Basic) универсальный метод M возвращает B<int, S>. В открытом типе C<T>M возвращает .B<T, S> В обоих случаях свойство возвращает true значение для MethodInfo объекта , IsGenericMethodDefinition представляющего M, поэтому MakeGenericMethod может вызываться для обоих MethodInfo объектов. В случае созданного типа результатом вызова MakeGenericMethod является MethodInfo , который можно вызвать. В случае открытого типа метод , MethodInfo возвращаемый методом MakeGenericMethod , не может быть вызван.

Список инвариантных условий для терминов, относящихся к универсальным методам, см. в свойстве IsGenericMethod . Список инвариантных условий для других терминов, используемых в универсальном отражении, см. в свойстве IsGenericType .

См. также раздел

• MakeGenericMethod(Type[])
• IsGenericMethod
• IsGenericMethodDefinition
• Отражение и универсальные типы
• Введение в универсальные шаблоны. (Руководство по программированию на C#)