StringFreezingAttribute Classe

Définition

Espace de noms:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Obsolète. 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). Cette classe ne peut pas être héritée.

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

Héritage

Object

Attribute

StringFreezingAttribute

Attributs

AttributeUsageAttribute SerializableAttribute

Exemples

L’exemple de code suivant montre comment appliquer l’assembly StringFreezingAttribute .

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éconseillée dans le .NET Framework version 3.5 Service Pack 1 (SP1) et versions ultérieures.

Une chaîne figée est un objet littéral de chaîne compatible avec le tas managé et a été sérialisé dans une image native par le Ngen.exe (Générateur d’images native). L’attribut StringFreezingAttribute vous permet d’optimiser votre code en préaffectant des littéraux de chaîne pendant la génération d’images natives plutôt qu’au moment de l’exécution. 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.

La StringFreezingAttribute valeur doit être appliquée au niveau de l’assembly.

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 dans le tas peut faire référence à la chaîne figée. Par conséquent, vous devez utiliser la StringFreezingAttribute classe uniquement dans les cas où l’image native qui contient la chaîne figée est partagée fortement.

Constructeurs

StringFreezingAttribute()

Initialise une nouvelle instance de la classe StringFreezingAttribute.

Propriétés

TypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
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. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_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. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_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. (Hérité de Attribute)