StringFreezingAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

StringFreezingAttribute

Attributi

AttributeUsageAttribute SerializableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come applicare l'oggetto StringFreezingAttribute a un 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

Commenti

Una stringa bloccata è un oggetto letterale stringa compatibile con l'heap gestito ed è stato serializzato in un'immagine nativa dal Ngen.exe (Generatore di immagini native). L'attributo StringFreezingAttribute consente di ottimizzare il codice pre-allocando valori letterali stringa durante la generazione di immagini native anziché in fase di esecuzione. Dopo che un valore letterale stringa è stato bloccato, il codice può semplicemente fare riferimento alla stringa usando l'indirizzo nell'immagine nativa.

L'oggetto StringFreezingAttribute deve essere applicato a livello di assembly.

Si noti che Common Language Runtime (CLR) non può scaricare un'immagine nativa con una stringa bloccata perché qualsiasi oggetto nell'heap potrebbe fare riferimento alla stringa bloccata. Pertanto, è consigliabile usare la StringFreezingAttribute classe solo nei casi in cui l'immagine nativa che contiene la stringa bloccata viene condivisa pesantemente.