StringFreezingAttribute Classe

Definição

public ref class StringFreezingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
[System.Serializable]
public sealed class StringFreezingAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
public sealed class StringFreezingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
[<System.Serializable>]
type StringFreezingAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
type StringFreezingAttribute = class
    inherit Attribute

Public NotInheritable Class StringFreezingAttribute
Inherits Attribute

Herança

Object

Attribute

StringFreezingAttribute

Atributos

AttributeUsageAttribute SerializableAttribute

Exemplos

O exemplo de código seguinte demonstra como aplicar o StringFreezingAttribute a um assembly.

using System;
using System.Runtime.CompilerServices;

[assembly :StringFreezingAttribute()]

class Program
{

    string frozenString = "This is a frozen string after Ngen is run.";

    static void Main(string[] args)
    {

        Console.WriteLine("The StringFreezingAttribute attribute was applied.");
    }
}

Imports System.Runtime.CompilerServices

<Assembly: StringFreezingAttribute()> 

Module Program

    Dim frozenString = "This is a frozen string after Ngen is run."

    Sub Main(ByVal args() As String)
        Console.WriteLine("The FixedAddressValueTypeAttribute attribute was applied.")
    End Sub


End Module

Observações

Uma string congelada é um objeto literal de cadeia compatível com o heap gerido e que foi serializada numa imagem nativa pelo Ngen.exe (Gerador de Imagens Nativas). O StringFreezingAttribute atributo permite-lhe otimizar o seu código pré-alocando literais de cadeia durante a geração nativa de imagens, em vez de em tempo de execução. Depois de um literal de cadeia ser congelado, o código pode simplesmente referir-se à cadeia usando o endereço na imagem nativa.

Deve StringFreezingAttribute ser aplicado ao nível da montagem.

Note-se que o tempo de execução da common language (CLR) não pode descarregar qualquer imagem nativa que tenha uma string congelada porque qualquer objeto no heap pode referir-se à string congelada. Por isso, deve usar a StringFreezingAttribute classe apenas nos casos em que a imagem nativa que contém a string congelada seja partilhada de forma significativa.