StringFreezingAttribute StringFreezingAttribute StringFreezingAttribute StringFreezingAttribute Class

Definition

Veraltet.Deprecated. Fixiert ein Zeichenfolgenliteral beim Erstellen von nativen Abbildern mit Ngen.exe (Native Image Generator).Freezes a string literal when creating native images using the Ngen.exe (Native Image Generator). Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class StringFreezingAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
[System.Serializable]
public sealed class StringFreezingAttribute : Attribute
type StringFreezingAttribute = class
    inherit Attribute
Public NotInheritable Class StringFreezingAttribute
Inherits Attribute
Vererbung
StringFreezingAttributeStringFreezingAttributeStringFreezingAttributeStringFreezingAttribute
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das StringFreezingAttribute auf eine Assembly angewendet wird.The following code example demonstrates how to apply the StringFreezingAttribute to an 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

Hinweise

Hinweis

Die StringFreezingAttribute -Klasse ist in der .NET Framework Version 3,5 Service Pack 1 (SP1) und höheren Versionen veraltet.The StringFreezingAttribute class has been deprecated in the .NET Framework version 3.5 Service Pack 1 (SP1) and later versions.

Eine fixierte Zeichenfolge ist ein zeichenfolgenliteralobjekt, das mit dem verwalteten Heap kompatibel ist und von Ngen. exe (Native Image Generator)in ein natives Image serialisiert wurde.A frozen string is a string literal object that is compatible with the managed heap and has been serialized into a native image by the Ngen.exe (Native Image Generator). Mithilfe StringFreezingAttribute des-Attributs können Sie Ihren Code optimieren, indem Sie Zeichen folgen Literale während der Generierung von nativem Image anstatt zur Laufzeit vorab zuordnen.The StringFreezingAttribute attribute allows you to optimize your code by pre-allocating string literals during native image generation rather than at run time. Nachdem ein Zeichenfolgenliteralzeichen eingefroren wurde, kann Code einfach auf die Zeichenfolge verweisen, indem die Adresse im systemeigenen Image verwendet wird.After a string literal has been frozen, code can simply refer to the string using the address in the native image.

StringFreezingAttribute Muss auf Assemblyebene angewendet werden.The StringFreezingAttribute must be applied on the assembly level.

Beachten Sie, dass die Common Language Runtime (CLR) keines der systemeigenen Images entladen kann, die über eine fixierte Zeichenfolge verfügen, da jedes Objekt im Heap auf die fixierte Zeichenfolge verweisen kann.Note that the common language runtime (CLR) cannot unload any native image that has a frozen string because any object in the heap might refer to the frozen string. Daher sollten Sie die StringFreezingAttribute -Klasse nur in Fällen verwenden, in denen das Native Image, das die fixierte Zeichenfolge enthält, stark freigegeben ist.Therefore, you should use the StringFreezingAttribute class only in cases where the native image that contains the frozen string is shared heavily.

Konstruktoren

StringFreezingAttribute() StringFreezingAttribute() StringFreezingAttribute() StringFreezingAttribute()

Initialisiert eine neue Instanz der StringFreezingAttribute-Klasse.Initializes a new instance of the StringFreezingAttribute class.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Eigenschaften

TypeId TypeId TypeId TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Gilt für: