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 定義し、 型の静的フィールドを持つ 2 つのクラスを初期化します Age。 2 番目のクラスは、フィールドのアドレスをピン留めするために適用されます FixedAddressValueTypeAttribute 。 これら 2 つのオブジェクトがインスタンス化される前と後に、多数のメモリ割り当てが行われ、ガベージ コレクターが呼び出されます。 この例の出力では、ガベージ コレクション後に最初 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)