MethodImplAttribute Classe

Definizione

Spazio dei nomi:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Origine:

MethodImplAttribute.cs

Specifica i dettagli della modalità di implementazione di un metodo. La classe non può essere ereditata.

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

Ereditarietà

Object

Attribute

MethodImplAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio GetCalendarName seguente viene applicato il metodo MethodImplAttribute per assicurarsi che non sia inlined in fase di esecuzione dal compilatore JIT (Just-In-Time).

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

Nell'esempio seguente viene quindi chiamato il MethodInfo.GetMethodImplementationFlags metodo per determinare quali flag sono impostati per il GetCalendarName metodo. Dimostra inoltre che queste informazioni non vengono recuperate dal MemberInfo.GetCustomAttributes metodo .

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

Commenti

È possibile applicare questo attributo ai metodi o ai costruttori.

Questo attributo consente di personalizzare la configurazione del metodo o del costruttore a cui si applica fornendo un MethodImplOptions valore al costruttore della classe. I membri dell'enumerazione MethodImplOptions corrispondono ai campi bit nella CorMethodImpl tabella dei metadati. Ciò significa che le informazioni sull'attributo non possono essere recuperate in fase di esecuzione chiamando il metodo. Invece, viene recuperata chiamando il MemberInfo.GetCustomAttributesMethodInfo.GetMethodImplementationFlags metodo o .ConstructorInfo.GetMethodImplementationFlags

Costruttori

MethodImplAttribute()	Inizializza una nuova istanza della classe MethodImplAttribute.
MethodImplAttribute(Int16)	Inizializza una nuova istanza della classe MethodImplAttribute con il valore MethodImplOptions specificato.
MethodImplAttribute(MethodImplOptions)	Inizializza una nuova istanza della classe MethodImplAttribute con il valore MethodImplOptions specificato.

Campi

MethodCodeType

Valore MethodCodeType che indica il tipo di implementazione fornita per questo metodo.

Proprietà

TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)
Value	Ottiene il valore MethodImplOptions che descrive il metodo con attributi.

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• GetMethodImplementationFlags()