FixedAddressValueTypeAttribute Clase

Definición

public ref class FixedAddressValueTypeAttribute sealed : Attribute

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

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

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

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

Public NotInheritable Class FixedAddressValueTypeAttribute
Inherits Attribute

Herencia

Object

Attribute

FixedAddressValueTypeAttribute

Atributos

AttributeUsageAttribute SerializableAttribute

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

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a