StringFreezingAttribute Klasse

Definition

Namespace:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Quelle:

StringFreezingAttribute.cs

Veraltet. Fixiert ein Zeichenfolgenliteral beim Erstellen von nativen Abbildern mit Ngen.exe (Native Image Generator). Diese Klasse kann nicht vererbt werden.

public ref class StringFreezingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
public sealed class StringFreezingAttribute : 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

Beispiele

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

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

Hinweis

Die StringFreezingAttribute -Klasse ist in .NET Framework Version 3.5 Service Pack 1 (SP1) und höheren Versionen veraltet.

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

Der StringFreezingAttribute muss auf Assemblyebene angewendet werden.

Beachten Sie, dass die Common Language Runtime (CLR) kein natives Image mit einer eingefrorenen Zeichenfolge entladen kann, da jedes Objekt im Heap auf die eingefrorene Zeichenfolge verweisen kann. Daher sollten Sie die StringFreezingAttribute -Klasse nur in Fällen verwenden, in denen das native Image, das die eingefrorene Zeichenfolge enthält, stark freigegeben wird.

Konstruktoren

StringFreezingAttribute()

Initialisiert eine neue Instanz der StringFreezingAttribute-Klasse.

Eigenschaften

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)