StringFreezingAttribute Clase

Definición

Espacio de nombres:

System.Runtime.CompilerServices

Ensamblado:

System.Runtime.dll

Ensamblado:

mscorlib.dll

Ensamblado:

netstandard.dll

Desusado. Inmoviliza un literal de cadena al crear imágenes nativas mediante Ngen.exe (Generador de imágenes nativo). Esta clase no puede heredarse.

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

Herencia

Object

Attribute

StringFreezingAttribute

Atributos

AttributeUsageAttribute SerializableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo aplicar a StringFreezingAttribute un ensamblado.

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

Comentarios

Nota

La StringFreezingAttribute clase ha quedado en desuso en la .NET Framework versión 3.5 Service Pack 1 (SP1) y versiones posteriores.

Una cadena inmovilizada es un objeto literal de cadena que es compatible con el montón administrado y que el Ngen.exe (Generador de imágenes nativas) ha serializado en una imagen nativa. El StringFreezingAttribute atributo permite optimizar el código asignando previamente literales de cadena durante la generación de imágenes nativas en lugar de en tiempo de ejecución. Una vez inmovilizado un literal de cadena, el código simplemente puede hacer referencia a la cadena mediante la dirección de la imagen nativa.

Debe StringFreezingAttribute aplicarse en el nivel de ensamblado.

Tenga en cuenta que Common Language Runtime (CLR) no puede descargar ninguna imagen nativa que tenga una cadena inmovilizada porque cualquier objeto del montón podría hacer referencia a la cadena inmovilizada. Por lo tanto, debe usar la StringFreezingAttribute clase solo en los casos en los que la imagen nativa que contiene la cadena inmovilizada se comparte en gran medida.

Constructores

StringFreezingAttribute()

Inicializa una nueva instancia de la clase StringFreezingAttribute.

Propiedades

TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a las propiedades y los métodos expuestos por un objeto. (Heredado de Attribute)