StringFreezingAttribute Класс

Определение

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

Наследование

Object

Attribute

StringFreezingAttribute

Атрибуты

AttributeUsageAttribute SerializableAttribute

Примеры

В следующем примере кода показано, как применить 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

Комментарии

Замороженная строка — это строковый литеральный объект, совместимый с управляемой кучей и сериализованный в собственный образNgen.exe (генератор собственных образов). Атрибут StringFreezingAttribute позволяет оптимизировать код, предварительно распределив строковые литералы во время создания собственного образа, а не во время выполнения. После того как строковый литерал был заморожен, код может просто ссылаться на строку с помощью адреса в собственном изображении.

Необходимо StringFreezingAttribute применить его на уровне сборки.

Обратите внимание, что среда CLR не может выгрузить любой собственный образ, имеющий замороженную строку, так как любой объект в куче может ссылаться на замороженную строку. Поэтому следует использовать StringFreezingAttribute класс только в тех случаях, когда собственный образ, содержащий замороженную строку, используется в значительной степени.