StringFreezingAttribute クラス

定義

public ref class StringFreezingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
[System.Serializable]
public sealed class StringFreezingAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
public sealed class StringFreezingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
[<System.Serializable>]
type StringFreezingAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
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 クラスを使用する必要があります。