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 bitových kopií 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 na StringFreezingAttribute 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.

Ukotvený řetězec je objekt řetězcového literálu, 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 ukotvení řetězcového literálu může kód jednoduše odkazovat na řetězec pomocí adresy v nativní bitové kopii.

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

Modul CLR (Common Language Runtime) nemůže uvolnit žádnou nativní bitovou kopii, která obsahuje zamrznutý řetězec, protože jakýkoli objekt v haldě může odkazovat na zamrznutý řetězec. Proto byste měli použít StringFreezingAttribute třídu pouze v případech, kdy je nativní bitová kopie obsahující zamrznutý řetězec hodně sdílena.

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()	Type Získá z aktuální instance. (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)