FixedAddressValueTypeAttribute Classe

Definição

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

Herança

Object

Attribute

FixedAddressValueTypeAttribute

Atributos

AttributeUsageAttribute SerializableAttribute

Exemplos

O exemplo a seguir ilustra o uso do FixedAddressValueTypeAttribute atributo para fixar um campo estático na memória. Ele define uma Age estrutura e inicializa duas classes que têm campos estáticos do tipo Age. A segunda classe se aplica FixedAddressValueTypeAttribute para fixar o endereço do campo. Várias alocações de memória são feitas antes e depois que esses dois objetos são instanciados e o coletor de lixo é invocado. A saída do exemplo mostra que, embora o endereço do primeiro Age campo tenha sido alterado após a coleta de lixo, o endereço do campo ao qual FixedAddressValueTypeAttribute é aplicado não foi.

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

Comentários

Use o FixedAddressValueTypeAttribute atributo para marcar tipos de valor estáticos como fixados na criação.

Esse atributo é usado pelo compilador Microsoft Visual C++.

Os campos de tipo de valor estático são criados como objetos de caixa. Isso significa que seu endereço pode ser alterado à medida que a coleta de lixo é executada. Quando você aplica esse atributo a um tipo de valor estático, seu endereço permanece constante durante seu tempo de vida.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a