StringFreezingAttribute Třída

Definice

Obor názvů:

System.Runtime.CompilerServices

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

StringFreezingAttribute.cs

Deprecated. 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

Note

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 řetězcový literál objekt, který je kompatibilní se spravovanou haldou a byl serializován do nativní bitové kopie Ngen.exe (Native Image Generator). Tento StringFreezingAttribute atribut umožňuje optimalizovat kód předem 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í imagi.

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

Mějte na paměti, že modul CLR (Common Language Runtime) nemůže uvolnit žádnou nativní bitovou kopii s ukotveným řetězcem, protože jakýkoli objekt v haldě může odkazovat na zamrzlý řetězec. Proto byste měli použít StringFreezingAttribute třídu pouze v případech, kdy nativní image obsahující ukotvený řetězec je silně sdílena.

Konstruktory

Name	Description
StringFreezingAttribute()	Inicializuje novou instanci StringFreezingAttribute třídy.

Vlastnosti

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

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je 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á určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)