FixedAddressValueTypeAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

FixedAddressValueTypeAttribute

Attributi

AttributeUsageAttribute SerializableAttribute

Esempio

Nell'esempio seguente viene illustrato l'uso dell'attributo FixedAddressValueTypeAttribute per aggiungere un campo statico in memoria. Definisce una Age struttura e inizializza due classi con campi statici di tipo Age. La seconda classe si applica FixedAddressValueTypeAttribute all'aggiunta dell'indirizzo del campo. Vengono eseguite diverse allocazioni di memoria prima e dopo la creazione di un'istanza di questi due oggetti e viene richiamato il Garbage Collector. L'output dell'esempio mostra che, anche se l'indirizzo del primo Age campo è stato modificato dopo l'operazione di Garbage Collection, l'indirizzo del campo a cui FixedAddressValueTypeAttribute è applicato non è stato applicato.

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

Commenti

Usare l'attributo FixedAddressValueTypeAttribute per contrassegnare i tipi di valore statici come aggiunti al momento della creazione.

Questo attributo viene usato dal compilatore di Visual C++ Microsoft.

I campi tipo valore statico vengono creati come oggetti boxed. Ciò significa che l'indirizzo può cambiare man mano che viene eseguita l'operazione di Garbage Collection. Quando si applica questo attributo a un tipo di valore statico, l'indirizzo rimane costante durante la durata.