StringFreezingAttribute クラス

.NET Framework クラス ライブラリ リファレンス

StringFreezingAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ネイティブ イメージ ジェネレータ (Ngen.exe) を使用してネイティブ イメージを作成するときにリテラル文字列を固定します。このクラスは継承できません。

名前空間: System.Runtime.CompilerServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited:=False)> _
Public NotInheritable Class
 StringFreezingAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As StringFreezingAttribute

C#

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

C++

[SerializableAttribute] 
[AttributeUsageAttribute(AttributeTargets::Assembly, Inherited=false)]
 
public ref class StringFreezingAttribute sealed
 : public Attribute

J#

/** @attribute SerializableAttribute() */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false)
 */ 
public final class StringFreezingAttribute
 extends Attribute

JScript

SerializableAttribute 
AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false)
 
public final class StringFreezingAttribute
 extends Attribute

解説

固定文字列とは、マネージ ヒープと互換性があるリテラル文字列オブジェクトであり、ネイティブ イメージ ジェネレータ (Ngen.exe) によってネイティブ イメージにシリアル化されています。StringFreezingAttribute 属性では、実行時ではなく、ネイティブ イメージの生成時にリテラル文字列をあらかじめ割り当てておくことによってコードを最適化できます。リテラル文字列が固定されると、コードは、ネイティブ イメージに含まれるアドレスを使用して簡単に文字列を参照できます。

StringFreezingAttribute は、アセンブリ レベルで適用される必要があります。

ヒープ内のオブジェクトが固定文字列を参照する可能性があるため、共通言語ランタイム (CLR) は、固定文字列を含むネイティブ イメージをアンロードできません。このため、StringFreezingAttribute クラスは、固定文字列を格納するネイティブ イメージの大部分を共有している場合のみ使用します。

使用例

StringFreezingAttribute をアセンブリに適用する方法を次のコード例に示します。

Visual Basic

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

C#

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.");

    }
}

継承階層

System.Object
   System.Attribute
    System.Runtime.CompilerServices.StringFreezingAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
StringFreezingAttribute メンバ
System.Runtime.CompilerServices 名前空間