StringFreezingAttribute Classe

Définition

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

Héritage

Object

Attribute

StringFreezingAttribute

Attributs

AttributeUsageAttribute SerializableAttribute

Exemples

L’exemple de code suivant montre comment appliquer l’assembly StringFreezingAttribute à 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

Remarques

Une chaîne figée est un objet littéral de chaîne compatible avec le tas managé et qui a été sérialisé dans une image native par l' Ngen.exe (Générateur d’images natives) . L’attribut StringFreezingAttribute vous permet d’optimiser votre code en préaffectant des littéraux de chaîne pendant la génération d’images natives plutôt qu’au moment de l’exécution. Une fois qu’un littéral de chaîne a été figé, le code peut simplement faire référence à la chaîne à l’aide de l’adresse dans l’image native.

Doit StringFreezingAttribute être appliqué au niveau de l’assembly.

Notez que le Common Language Runtime (CLR) ne peut pas décharger une image native qui a une chaîne figée, car tout objet du tas peut faire référence à la chaîne figée. Par conséquent, vous devez utiliser la StringFreezingAttribute classe uniquement dans les cas où l’image native qui contient la chaîne figée est partagée fortement.