FixedAddressValueTypeAttribute Класс

Определение

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

Наследование

Object

Attribute

FixedAddressValueTypeAttribute

Атрибуты

AttributeUsageAttribute SerializableAttribute

Примеры

В следующем примере показано использование атрибута FixedAddressValueTypeAttribute для закрепления статического поля в памяти. Он определяет структуру Age и инициализирует два класса со статическими полями типа Age. Второй класс применяется FixedAddressValueTypeAttribute для закрепления адреса поля. Ряд выделений памяти выполняется до и после создания экземпляров этих двух объектов и вызова сборщика мусора. Выходные данные из примера показывают, что, хотя адрес первого Age поля изменился после сборки мусора, адрес поля, к которому FixedAddressValueTypeAttribute применяется, не был изменен.

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

Комментарии

Используйте атрибут , FixedAddressValueTypeAttribute чтобы пометить статические типы значений как закрепленные при создании.

Этот атрибут используется компилятором Microsoft Visual C++.

Поля типа статических значений создаются в виде упакованных объектов. Это означает, что их адрес может измениться по мере выполнения сборки мусора. При применении этого атрибута к типу статического значения его адрес остается постоянным в течение всего времени существования.

Конструкторы

Свойства

Методы

Явные реализации интерфейса

Применяется к