StringFreezingAttribute Klasse

Definition

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

Vererbung

Object

Attribute

StringFreezingAttribute

Attribute

AttributeUsageAttribute SerializableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Dies StringFreezingAttribute auf eine Assembly angewendet wird.

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

Hinweise

Eine fixierte Zeichenfolge ist ein Zeichenfolgenliteralobjekt, das mit dem verwalteten Heap kompatibel ist und von der Ngen.exe (Native Image Generator) in ein systemeigenes Bild serialisiert wurde. Mit dem StringFreezingAttribute Attribut können Sie Ihren Code optimieren, indem Sie Zeichenfolgenliterale während der systemeigenen Bildgenerierung vorab zuweisen und nicht zur Laufzeit. Nachdem ein Zeichenfolgenliteral fixiert wurde, kann Code einfach mithilfe der Adresse im systemeigenen Bild auf die Zeichenfolge verweisen.

Die StringFreezingAttribute Muss auf Assemblyebene angewendet werden.

Beachten Sie, dass die Common Language Runtime (CLR) kein systemeigenes Bild entladen kann, das eine fixierte Zeichenfolge enthält, da ein Objekt im Heap möglicherweise auf die fixierte Zeichenfolge verweist. Daher sollten Sie die StringFreezingAttribute Klasse nur in Fällen verwenden, in denen das systemeigene Bild, das die fixierte Zeichenfolge enthält, stark freigegeben wird.