FixedAddressValueTypeAttribute Clase

Definición

Espacio de nombres:

System.Runtime.CompilerServices

Ensamblado:

System.Runtime.dll

Source:

FixedAddressValueTypeAttribute.cs

Fija la dirección de un campo de tipo de valor estático a lo largo de su período de duración. Esta clase no puede heredarse.

public ref class FixedAddressValueTypeAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Field)]
public sealed class FixedAddressValueTypeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field)>]
type FixedAddressValueTypeAttribute = class
    inherit Attribute

Public NotInheritable Class FixedAddressValueTypeAttribute
Inherits Attribute

Herencia

Object

Attribute

FixedAddressValueTypeAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se muestra el uso del FixedAddressValueTypeAttribute atributo para anclar un campo estático en la memoria. Define una Age estructura e inicializa dos clases que tienen campos estáticos de tipo Age. La segunda clase se aplica FixedAddressValueTypeAttribute para anclar la dirección del campo. Se crean varias asignaciones de memoria antes y después de crear instancias de estos dos objetos y se invoca al recolector de elementos no utilizados. La salida del ejemplo muestra que, aunque la dirección del primer Age campo ha cambiado después de la recolección de elementos no utilizados, la dirección del campo al que FixedAddressValueTypeAttribute se aplica no.

using System;
using System.Runtime.CompilerServices;

public struct Age {
   public int years;
   public int months;
}

public class FreeClass
{
   public static Age FreeAge;
   
   public static unsafe IntPtr AddressOfFreeAge()
   { 
      fixed (Age* pointer = &FreeAge) 
      { return (IntPtr) pointer; } 
   }
}

public class FixedClass
{
   [FixedAddressValueType]
   public static Age FixedAge;
   
   public static unsafe IntPtr AddressOfFixedAge()
   { 
      fixed (Age* pointer = &FixedAge) 
      { return (IntPtr) pointer; } 
   }   
}

public class Example
{
   public static void Main()
   {
      AllocateMemory();
      
      // Get addresses of static Age fields.
      IntPtr freePtr1 = FreeClass.AddressOfFreeAge();
      AllocateMemory();
      
      IntPtr fixedPtr1 = FixedClass.AddressOfFixedAge();
      AllocateMemory();

      // Garbage collection.
      GC.Collect();
      GC.WaitForPendingFinalizers();
      
      // Get addresses of static Age fields after garbage collection.
      IntPtr freePtr2 = FreeClass.AddressOfFreeAge();
      IntPtr fixedPtr2 = FixedClass.AddressOfFixedAge();
        
      // Display addresses before and after garbage collection
      Console.WriteLine("Normal static: {0} -> {1}", freePtr1, freePtr2);
      Console.WriteLine("Pinned static:  {0} -> {1}", fixedPtr1, fixedPtr2);  
   }

   // Allocate memory for 100,000 objects.
   static public void AllocateMemory()
   {
      for (int ctr = 0; ctr <= 100000; ctr++)
      {
         object o = new object();      
      }
   }
}
// The example displays output similar to the following:
//       Normal static: 19932420 -> 19863704
//       Pinned static:  19985508 -> 19985508

Comentarios

Use el FixedAddressValueTypeAttribute atributo para marcar los tipos de valor estáticos como anclados al crearse.

El compilador de Microsoft Visual C++ usa este atributo.

Los campos de tipo de valor estático se crean como objetos boxed. Esto significa que su dirección puede cambiar a medida que se realiza la recolección de elementos no utilizados. Cuando se aplica este atributo a un tipo de valor estático, su dirección permanece constante durante su vigencia.

Constructores

FixedAddressValueTypeAttribute()

Inicializa una nueva instancia de la clase FixedAddressValueTypeAttribute.

Propiedades

TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)