FixedAddressValueTypeAttribute Klas

Definitie

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

Overname

Object

Attribute

FixedAddressValueTypeAttribute

Kenmerken

AttributeUsageAttribute SerializableAttribute

Voorbeelden

In het volgende voorbeeld ziet u het gebruik van het FixedAddressValueTypeAttribute kenmerk om een statisch veld in het geheugen vast te maken. Hiermee definieert u een Age structuur en initialiseert u twee klassen met statische velden van het type Age. De tweede klasse is van toepassing FixedAddressValueTypeAttribute op het vastmaken van het adres van het veld. Er worden een aantal geheugentoewijzingen gemaakt voor en nadat deze twee objecten zijn geïnstantieerd en wordt de garbagecollection aangeroepen. In de uitvoer van het voorbeeld ziet u dat hoewel het adres van het eerste Age veld is gewijzigd na garbagecollection, het adres van het veld waarop FixedAddressValueTypeAttribute wordt toegepast, niet heeft.

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

Opmerkingen

Gebruik het FixedAddressValueTypeAttribute kenmerk om statische waardetypen te markeren als vastgemaakt bij het maken.

Dit kenmerk wordt gebruikt door de Microsoft Visual C++-compiler.

Velden van het type statische waarde worden gemaakt als vakkenobjecten. Dit betekent dat hun adres kan worden gewijzigd wanneer garbagecollection wordt uitgevoerd. Wanneer u dit kenmerk toepast op een type statische waarde, blijft het adres tijdens de levensduur constant.