StringFreezingAttribute Třída

Definice

Obor názvů:

System.Runtime.CompilerServices

Sestavení:

System.Runtime.dll

Zdroj:

StringFreezingAttribute.cs

Zastaralé Zablokuje řetězcový literál při vytváření nativních imagí pomocí Ngen.exe (Native Image Generator). Tato třída se nemůže dědit.

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

Dědičnost

Object

Attribute

StringFreezingAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad kódu ukazuje, jak použít StringFreezingAttribute na sestavení.

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

Poznámky

Poznámka

Třída StringFreezingAttribute byla vyřazena v rozhraní .NET Framework verze 3.5 Service Pack 1 (SP1) a novějších verzích.

Zmrazený řetězec je řetězcový literál objekt, který je kompatibilní se spravovanou haldou a byl serializován do nativní bitové kopie Ngen.exe (Native Image Generator). Atribut StringFreezingAttribute umožňuje optimalizovat kód předběžným přidělením řetězcových literálů během generování nativní bitové kopie, nikoli za běhu. Po zmrazení řetězcového literálu může kód jednoduše odkazovat na řetězec pomocí adresy v nativní imagi.

Musí StringFreezingAttribute se použít na úrovni sestavení.

Všimněte si, že modul CLR (Common Language Runtime) nemůže uvolnit žádnou nativní image, která má zamrzlý řetězec, protože jakýkoli objekt v haldě může odkazovat na zamrznutý řetězec. Proto byste měli používat StringFreezingAttribute třídu pouze v případech, kdy je nativní image, která obsahuje zamrzlý řetězec, sdílena silně.

Konstruktory

StringFreezingAttribute()

Inicializuje novou instanci StringFreezingAttribute třídy.

Vlastnosti

TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)