StringFreezingAttribute StringFreezingAttribute StringFreezingAttribute StringFreezingAttribute Class

Definizione

Deprecato.Deprecated. Blocca una stringa letterale durante la creazione di immagini native mediante Ngen.exe (generatore di immagini native).Freezes a string literal when creating native images using the Ngen.exe (Native Image Generator). Questa classe non può essere ereditata.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
Ereditarietà
StringFreezingAttributeStringFreezingAttributeStringFreezingAttributeStringFreezingAttribute
Attributi

Esempi

Esempio di codice seguente viene illustrato come applicare il StringFreezingAttribute a 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

Commenti

Nota

Il StringFreezingAttribute classe è stata deprecata in .NET Framework versione 3.5 Service Pack 1 (SP1) e versioni successive.The StringFreezingAttribute class has been deprecated in the .NET Framework version 3.5 Service Pack 1 (SP1) and later versions.

Una stringa bloccata è un oggetto di valore letterale stringa che è compatibile con l'heap gestito ed è stato serializzato in un'immagine nativa per la Ngen.exe (Native Image Generator).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). Il StringFreezingAttribute attributo consente di ottimizzare il codice allocando i valori letterali stringa durante la generazione di immagini native invece che in fase di esecuzione.The StringFreezingAttribute attribute allows you to optimize your code by pre-allocating string literals during native image generation rather than at run time. Dopo che un valore letterale stringa è stata bloccata, codice è sufficiente farvi riferimento nella stringa usando l'indirizzo nell'immagine nativa.After a string literal has been frozen, code can simply refer to the string using the address in the native image.

Il StringFreezingAttribute deve essere applicato a livello di assembly.The StringFreezingAttribute must be applied on the assembly level.

Si noti che common language runtime (CLR) non è possibile scaricare un'immagine nativa con una stringa bloccata perché qualsiasi oggetto nell'heap potrebbe fare riferimento alla stringa bloccata.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. Pertanto, è necessario utilizzare il StringFreezingAttribute classe solo nei casi in cui l'immagine nativa che contiene la stringa bloccata è ampiamente condivisa.Therefore, you should use the StringFreezingAttribute class only in cases where the native image that contains the frozen string is shared heavily.

Costruttori

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

Inizializza una nuova istanza della classe StringFreezingAttribute.Initializes a new instance of the StringFreezingAttribute class.

Metodi

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

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

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

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.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)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.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()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID 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)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.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)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 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)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Proprietà

TypeId TypeId TypeId TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Si applica a