StringFreezingAttribute 類別

定義

命名空間:

System.Runtime.CompilerServices

組件:

System.Runtime.dll

來源:

StringFreezingAttribute.cs

已取代。 使用 Ngen.exe (原生映像產生器) 建立原生映像時，凍結字串常值。 此類別無法獲得繼承。

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)>]
type StringFreezingAttribute = class
    inherit Attribute

Public NotInheritable Class StringFreezingAttribute
Inherits Attribute

繼承

Object

Attribute

StringFreezingAttribute

屬性

AttributeUsageAttribute

範例

下列程式代碼範例示範如何將 套用 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

備註

注意

類別 StringFreezingAttribute 在 .NET Framework 3.5 Service Pack 1 版中已被取代 (SP1) 和更新版本。

凍結字串是與 Managed 堆積相容的字串常值物件，而且已由 原生映射產生器Ngen.exe (串行化為原生映射) 。 屬性 StringFreezingAttribute 可讓您在原生映射產生期間預先配置字串常值，而不是在運行時間配置字串常值，以優化程序代碼。 凍結字串常值之後，程式代碼可以直接使用原生映像中的地址來參考字串。

StringFreezingAttribute必須在元件層層級上套用 。

請注意，Common Language Runtime (CLR) 無法卸除任何具有凍結字串的原生映像，因為堆積中的任何物件都可能參考凍結的字元串。 因此，只有在包含凍結字串的原生映像大量共用時，才應該使用 StringFreezingAttribute 類別。

建構函式

StringFreezingAttribute()

初始化 StringFreezingAttribute 類別的新執行個體。

屬性

TypeId

在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)