ContextStack Třída

Definice

Poskytuje objekt zásobníku, který lze použít serializátor k zpřístupnění informací pro vnořené serializátory.

public ref class ContextStack sealed
public sealed class ContextStack
type ContextStack = class
Public NotInheritable Class ContextStack
Dědičnost
ContextStack

Příklady

Následující příklad kódu ukazuje použití ContextStack k vložení a následné odebrání 10 hodnot.

#using <System.Windows.Forms.dll>
#using <System.dll>

using namespace System;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::ComponentModel::Design::Serialization;
using namespace System::Windows::Forms;

int main()
{
   // Create a ContextStack.
   ContextStack^ stack = gcnew ContextStack;
   
   // Push ten items on to the stack and output the value of each.
   for ( int number = 0; number < 10; number++ )
   {
      Console::WriteLine( "Value pushed to stack: {0}", number );
      stack->Push( number );
   }
   
   // Pop each item off the stack.
   Object^ item = nullptr;
   while ( (item = stack->Pop()) != 0 )
      Console::WriteLine( "Value popped from stack: {0}", item );
}
using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.ComponentModel.Design.Serialization;
using System.Windows.Forms;

namespace ContextStackExample
{
    class ContextStackExample
    {
        [STAThread]
        static void Main(string[] args)
        {            
            // Create a ContextStack.
            ContextStack stack = new ContextStack();
            
            // Push ten items on to the stack and output the value of each.
            for( int number = 0; number < 10; number ++ )
            {
                Console.WriteLine( "Value pushed to stack: "+number.ToString() );
                stack.Push( number );
            }

            // Pop each item off the stack.
            object item = null;
            while( (item = stack.Pop()) != null )
                Console.WriteLine( "Value popped from stack: "+item.ToString() );
        }
    }
}
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.ComponentModel.Design.Serialization

Module ContextStackExample

    Sub Main()
        ' Create a ContextStack.
        Dim stack As New ContextStack

        ' Push ten items on to the stack and output the value of each.
        Dim number As Integer
        For number = 0 To 9
            Console.WriteLine(("Value pushed to stack: " + number.ToString()))
            stack.Push(number)
        Next number

        ' Pop each item off the stack.        
        Dim item As Object = stack.Pop()
        While item IsNot Nothing
            Console.WriteLine(("Value popped from stack: " + item.ToString()))
            item = stack.Pop()
        End While
    End Sub

End Module

Poznámky

Některé serializátory vyžadují informace o kontextu objektu k správnému zachování jejich stavu. Třída ContextStack umožňuje serializátoru nastavit data o kontextu objektu, který je serializován do zásobníku, kde k němu má přístup jiný serializátor. Hodnota Context vlastnosti je poskytována sdílení IDesignerSerializationManager informací o použití některých serializátorů.

Kontextový zásobník je užitečný, protože proces serializace dokumentu návrhu může být hluboce vnořený a objekty na každé úrovni vnoření mohou vyžadovat, aby kontextové informace správně zachovaly stav objektu. Serializátor může nastavit kontextový objekt do zásobníku před vyvoláním vnořené serializátoru. Každý objekt nastavený na zásobník by měl být odebrán serializátorem, který ho nastavil po volání vnořené serializátoru vrátí.

Objekty v zásobníku obvykle obsahují informace o kontextu aktuálního objektu, který je serializován. Nadřazený serializátor přidá do zásobníku kontextové informace o dalším objektu, který se má serializovat, zavolá odpovídající serializátor a při dokončení serializátoru na objektu odebere kontextové informace ze zásobníku. Je na implementaci každého serializátoru, aby bylo možné určit, které objekty se v tomto zásobníku nasdílí.

Například objekt s vlastností s názvem Enabled má datový typ Boolean. Pokud serializátor zapíše tuto hodnotu do datového streamu, může být nutné zahrnout kontext nebo typ vlastnosti, kterou píše. Serializátor však tyto informace nemá, protože je určen pouze k zápisu Boolean hodnoty. Chcete-li poskytnout tyto informace serializátoru, nadřazený serializátor může odeslat PropertyDescriptor odkaz, který odkazuje na Enabled vlastnost v kontextovém zásobníku.

Konstruktory

ContextStack()

Inicializuje novou instanci ContextStack třídy.

Vlastnosti

Current

Získá aktuální objekt v zásobníku.

Item[Int32]

Získá objekt v zásobníku na zadané úrovni.

Item[Type]

Získá první objekt v zásobníku, který dědí z nebo implementuje zadaný typ.

Metody

Append(Object)

Připojí objekt na konec zásobníku místo toho, aby ho nasdílel na začátek zásobníku.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
Pop()

Odebere aktuální objekt ze zásobníku a vrátí jeho hodnotu.

Push(Object)

Vloží nebo umístí zadaný objekt do zásobníku.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Viz také