FixedAddressValueTypeAttribute Klasa

Definicja

Przestrzeń nazw:

System.Runtime.CompilerServices

Zestaw:

System.Runtime.dll

Źródło:

FixedAddressValueTypeAttribute.cs

Naprawia adres pola typu wartości statycznej przez cały okres istnienia. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

Attribute

FixedAddressValueTypeAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

Poniższy przykład ilustruje użycie atrybutu FixedAddressValueTypeAttribute do przypinania pola statycznego w pamięci. Definiuje strukturę i inicjuje Age dwie klasy, które mają statyczne pola typu Age. Druga klasa ma zastosowanie FixedAddressValueTypeAttribute do przypinania adresu pola. Liczba alokacji pamięci jest dokonana przed utworzeniem i po utworzeniu wystąpienia tych dwóch obiektów, a moduł odśmiecenia pamięci jest wywoływany. Dane wyjściowe z przykładu pokazują, że mimo że adres pierwszego Age pola zmienił się po usunięciu pamięci, adres pola, do którego FixedAddressValueTypeAttribute zastosowano, nie został zastosowany.

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

Uwagi

Użyj atrybutu FixedAddressValueTypeAttribute , aby oznaczyć typy wartości statycznych jako przypięte podczas tworzenia.

Ten atrybut jest używany przez kompilator Microsoft Visual C++.

Pola typu wartości statycznej są tworzone jako obiekty pola. Oznacza to, że ich adres może ulec zmianie w miarę wykonywania odzyskiwania pamięci. Po zastosowaniu tego atrybutu do typu wartości statycznej jego adres pozostaje stały w okresie jego istnienia.

Konstruktory

FixedAddressValueTypeAttribute()

Inicjuje nowe wystąpienie klasy FixedAddressValueTypeAttribute.

Właściwości

TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	W przypadku zastąpienia w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)