StringFreezingAttribute StringFreezingAttribute StringFreezingAttribute StringFreezingAttribute Class

Définition

Obsolète.Deprecated. Fige un littéral de chaîne lors de la création d’images natives à l’aide de Ngen.exe (générateur d’images natives).Freezes a string literal when creating native images using the Ngen.exe (Native Image Generator). Cette classe ne peut pas être héritée.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
Héritage
StringFreezingAttributeStringFreezingAttributeStringFreezingAttributeStringFreezingAttribute
Attributs

Exemples

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

Remarques

Notes

La StringFreezingAttribute classe a été dépréciée dans le .NET Framework version 3,5 Service Pack 1 (SP1) et versions ultérieures.The StringFreezingAttribute class has been deprecated in the .NET Framework version 3.5 Service Pack 1 (SP1) and later versions.

Une chaîne figée est un objet de littéral de chaîne qui est compatible avec le tas managé et qui a été sérialisé dans une image native par le Ngen. exe (générateur d’images natives).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). L' StringFreezingAttribute attribut vous permet d’optimiser votre code en préallouant des littéraux de chaîne pendant la génération d’images natives plutôt qu’au moment de l’exécution.The StringFreezingAttribute attribute allows you to optimize your code by pre-allocating string literals during native image generation rather than at run time. 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.After a string literal has been frozen, code can simply refer to the string using the address in the native image.

Le StringFreezingAttribute doit être appliqué au niveau de l’assembly.The StringFreezingAttribute must be applied on the assembly level.

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.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. Par conséquent, vous devez utiliser StringFreezingAttribute la classe uniquement dans les cas où l’image native qui contient la chaîne figée est fortement partagée.Therefore, you should use the StringFreezingAttribute class only in cases where the native image that contains the frozen string is shared heavily.

Constructeurs

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

Initialise une nouvelle instance de la classe StringFreezingAttribute.Initializes a new instance of the StringFreezingAttribute class.

Méthodes

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

Retourne une valeur qui indique si cette instance est égale à un objet spécifié.Returns a value that indicates whether this instance is equal to a specified object.

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

Retourne le code de hachage de cette instance.Returns the hash code for this instance.

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

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée.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)

En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié.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()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

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

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

_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)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.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)

Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface.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)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 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)

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Propriétés

TypeId TypeId TypeId TypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

S’applique à