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 a seguir demonstra como aplicar o StringFreezingAttribute assembly 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

Comentários

Uma cadeia de caracteres congelada é um objeto literal de cadeia de caracteres compatível com o heap gerenciado e foi serializado em uma imagem nativa pelo Ngen.exe (Gerador de Imagem Nativa). O StringFreezingAttribute atributo permite otimizar seu código alocando previamente literais de cadeia de caracteres durante a geração de imagem nativa em vez de em tempo de execução. Depois que um literal de cadeia de caracteres tiver sido congelado, o código pode simplesmente se referir à cadeia de caracteres usando o endereço na imagem nativa.

O StringFreezingAttribute valor deve ser aplicado no nível do assembly.

Observe que o CLR (Common Language Runtime) não pode descarregar nenhuma imagem nativa que tenha uma cadeia de caracteres congelada porque qualquer objeto no heap pode se referir à cadeia de caracteres congelada. Portanto, você deve usar a StringFreezingAttribute classe somente nos casos em que a imagem nativa que contém a cadeia de caracteres congelada seja muito compartilhada.