StringFreezingAttribute Klasse

Referenz

Definition

Namespace:: System.Runtime.CompilerServices

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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)]
[System.Serializable]
public sealed class StringFreezingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
type StringFreezingAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
[<System.Serializable>]
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 die StringFreezingAttribute Anwendung 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

Hinweis

Die StringFreezingAttribute Klasse wurde in den .NET Framework Version 3.5 Service Pack 1 (SP1) und höherer Versionen veraltet.

Eine Zeichenfolge ist ein Zeichenfolgen-Literalobjekt, das mit dem verwalteten Heap kompatibel ist und in ein systemeigenes Bild durch den Ngen.exe (Native Image Generator) serialisiert wurde. Mit dem StringFreezingAttribute Attribut können Sie Ihren Code optimieren, indem Sie Zeichenfolgenliterale während der nativen Bildgenerierung vorverwenden und nicht zur Laufzeit. Nachdem ein Zeichenfolgen literal eingefroren wurde, kann Code einfach auf die Zeichenfolge verweisen, indem sie die Adresse im nativen Bild verwendet.

Dies StringFreezingAttribute muss auf der Assemblyebene angewendet werden.

Beachten Sie, dass die allgemeine Sprachlaufzeit (CLR) kein natives Bild ausladen kann, das eine Zeichenfolge enthält, da ein Objekt im Heap möglicherweise auf die gefrorene Zeichenfolge verweist. Daher sollten Sie die Klasse nur in Fällen verwenden, in denen das StringFreezingAttribute systemeigene Bild, das die 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)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für