FixedAddressValueTypeAttribute Класс

Определение

Пространство имен:

System.Runtime.CompilerServices

Сборка:

System.Runtime.dll

Исходный код:

FixedAddressValueTypeAttribute.cs

Фиксирует адрес поля со статическим типом значения в течение времени его существования. Этот класс не наследуется.

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

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

Object

Attribute

FixedAddressValueTypeAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере показано использование атрибута 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++.

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

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

FixedAddressValueTypeAttribute()

Инициализирует новый экземпляр класса FixedAddressValueTypeAttribute.

Свойства

TypeId

В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)

Методы

Equals(Object)	Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)