MethodImplAttribute Klasse

Definition

Namespace:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Quelle:

MethodImplAttribute.cs

Gibt die Implementierungsdetails für eine Methode an. Diese Klasse kann nicht vererbt werden.

public ref class MethodImplAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Constructor | System.AttributeTargets.Method, Inherited=false)]
public sealed class MethodImplAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Constructor | System.AttributeTargets.Method, Inherited=false)>]
type MethodImplAttribute = class
    inherit Attribute

Public NotInheritable Class MethodImplAttribute
Inherits Attribute

Vererbung

Object

Attribute

MethodImplAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird auf MethodImplAttribute die GetCalendarName -Methode angewendet, um sicherzustellen, dass sie nicht zur Laufzeit vom JIT-Compiler (Just-in-Time) inlineiert wird.

using System;
using System.Globalization;
using System.Runtime.CompilerServices;

public class Utility
{
   [MethodImplAttribute(MethodImplOptions.NoInlining)] 
   public static string GetCalendarName(Calendar cal)
   {
      return cal.ToString().Replace("System.Globalization.", "").
                 Replace("Calendar", "");
   }
}

Imports System.Globalization
Imports System.Runtime.CompilerServices

Public Class Utility
   <MethodImplAttribute(MethodImplOptions.NoInlining)>
   Public Shared Function GetCalendarName(cal As Calendar) As String
      Return cal.ToString().Replace("System.Globalization.", "").Replace("Calendar", "")
   End Function
End Class

Im folgenden Beispiel wird dann die MethodInfo.GetMethodImplementationFlags -Methode aufgerufen, um zu bestimmen, welche Flags für die GetCalendarName -Methode festgelegt sind. Außerdem wird veranschaulicht, dass diese Informationen nicht von der MemberInfo.GetCustomAttributes -Methode abgerufen werden.

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Use reflection to get a reference to the GetCalendarName method.
      Assembly assem = Assembly.LoadFrom(@".\Example.dll");
      Type type = assem.GetType("Utility");
      MethodInfo methodInfo = type.GetMethod("GetCalendarName");
      
      // Determine whether the method has any custom attributes.
      Console.Write("Utility.GetCalendarName custom attributes:");
      object[] attribs = methodInfo.GetCustomAttributes(false);
      if (attribs.Length > 0) {
         Console.WriteLine();
         foreach (var attrib in attribs)
            Console.WriteLine("   " + attrib.ToString());   
      }
      else {
         Console.WriteLine("   <None>");
      }

      // Get the method's metadata flags.
      MethodImplAttributes flags = methodInfo.GetMethodImplementationFlags();
      Console.WriteLine("Utility.GetCalendarName flags: {0}", 
                        flags.ToString());      
   }
}
// The example displays the following output:
//     Utility.GetCalendarName custom attributes:   <None>
//     Utility.GetCalendarName flags: NoInlining

Imports System.Reflection

Module Example
   Public Sub Main()
      ' Use reflection to get a reference to the GetCalendarName method.
      Dim assem As Assembly = Assembly.LoadFrom(".\Example.dll")
      Dim type As Type = assem.GetType("Utility")
      Dim methodInfo As MethodInfo = type.GetMethod("GetCalendarName")
      
      ' Determine whether the method has any custom attributes.
      Console.Write("Utility.GetCalendarName custom attributes:")
      Dim attribs() As Object = methodInfo.GetCustomAttributes(False)
      If attribs.Length > 0 Then
         Console.WriteLine()
         For Each attrib As Object In attribs
            Console.WriteLine("   " + attrib.ToString())   
         Next
      Else
         Console.WriteLine("   <None>")
      End If

      ' Get the method's metadata flags.
      Dim flags As MethodImplAttributes = methodInfo.GetMethodImplementationFlags()
      Console.WriteLine("Utility.GetCalendarName flags: {0}", flags.ToString())      
   End Sub
End Module
' The example displays the following output:
'     Utility.GetCalendarName custom attributes:   <None>
'     Utility.GetCalendarName flags: NoInlining

Hinweise

Sie können dieses Attribut auf Methoden oder Konstruktoren anwenden.

Mit diesem Attribut können Sie die Konfiguration der Methode oder des Konstruktors anpassen, auf die es angewendet wird, indem Sie einen MethodImplOptions Wert für den Klassenkonstruktor angeben. Die Member der MethodImplOptions Enumeration entsprechen Bitfeldern in der CorMethodImpl Metadatentabelle. Dies bedeutet, dass Informationen zum Attribut nicht zur Laufzeit durch Aufrufen der MemberInfo.GetCustomAttributes -Methode abgerufen werden können. Stattdessen werden sie durch Aufrufen der MethodInfo.GetMethodImplementationFlags -Methode oder der ConstructorInfo.GetMethodImplementationFlags -Methode abgerufen.

Konstruktoren

MethodImplAttribute()	Initialisiert eine neue Instanz der MethodImplAttribute-Klasse.
MethodImplAttribute(Int16)	Initialisiert eine neue Instanz der MethodImplAttribute-Klasse mit dem angegebenen MethodImplOptions-Wert.
MethodImplAttribute(MethodImplOptions)	Initialisiert eine neue Instanz der MethodImplAttribute-Klasse mit dem angegebenen MethodImplOptions-Wert.

Felder

MethodCodeType

Ein MethodCodeType-Wert, der angibt, welche Art von Implementierung für diese Methode bereitgestellt wird.

Eigenschaften

TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
Value	Ruft den MethodImplOptions-Wert ab, der die attributierte Methode beschreibt.

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• GetMethodImplementationFlags()