FixedAddressValueTypeAttribute Classe

Definição

Namespace:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Origem:

FixedAddressValueTypeAttribute.cs

Corrige o endereço de um campo de tipo de valor estático durante seu tempo de vida. Essa classe não pode ser herdada.

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

Herança

Object

Attribute

FixedAddressValueTypeAttribute

Atributos

AttributeUsageAttribute

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

FixedAddressValueTypeAttribute()

Inicializa uma nova instância da classe FixedAddressValueTypeAttribute.

Propriedades

TypeId

Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)