FixedAddressValueTypeAttribute Klasse

Definition

Namespace:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Quelle:

FixedAddressValueTypeAttribute.cs

Korrigiert die Adresse eines statischen Werttypfelds während dessen gesamter Lebensdauer. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

Attribute

FixedAddressValueTypeAttribute

Attribute

AttributeUsageAttribute

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung des FixedAddressValueTypeAttribute Attributs, um ein statisches Feld im Arbeitsspeicher anzuheften. Es definiert eine Age -Struktur und initialisiert zwei Klassen mit statischen Feldern vom Typ Age. Die zweite Klasse gilt für FixedAddressValueTypeAttribute das Anheften der Adresse des Felds. Eine Reihe von Speicherzuordnungen werden vor und nach dem Instanziieren dieser beiden Objekte vorgenommen und der Garbage Collector aufgerufen. Die Ausgabe des Beispiels zeigt, dass sich die Adresse des ersten Age Felds zwar nach der Garbage Collection geändert hat, die Adresse des Felds, auf das FixedAddressValueTypeAttribute angewendet wird, nicht.

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

Hinweise

Verwenden Sie das FixedAddressValueTypeAttribute -Attribut, um statische Werttypen als bei der Erstellung angeheftet zu markieren.

Dieses Attribut wird vom Microsoft Visual C++-Compiler verwendet.

Felder vom Typ statischer Werte werden als Boxobjekte erstellt. Dies bedeutet, dass sich ihre Adresse ändern kann, wenn die Garbage Collection ausgeführt wird. Wenn Sie dieses Attribut auf einen statischen Werttyp anwenden, bleibt seine Adresse während seiner Lebensdauer konstant.

Konstruktoren

FixedAddressValueTypeAttribute()

Initialisiert eine neue Instanz der FixedAddressValueTypeAttribute-Klasse.

Eigenschaften

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)