ContextStack Classe

Définition

public ref class ContextStack sealed

public sealed class ContextStack

type ContextStack = class

Public NotInheritable Class ContextStack

Héritage

Object

ContextStack

Exemples

L’exemple de code suivant illustre l’utilisation d’un ContextStack pour envoyer (push) puis supprimer 10 valeurs.

#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

Remarques

Certains sérialiseurs requièrent des informations sur le contexte d'un objet pour rendre leur état correctement persistant. La ContextStack classe permet à un sérialiseur de définir des données sur le contexte d’un objet sérialisé dans une pile à laquelle un autre sérialiseur peut y accéder. La valeur de la Context propriété est fournie par un IDesignerSerializationManager pour partager des informations d’utilisation avec certains sérialiseurs.

Une pile de contextes est utile, car le processus de sérialisation d’un document de conception peut être profondément imbriqué, et les objets à chaque niveau d’imbrication peuvent nécessiter des informations de contexte pour conserver correctement l’état de l’objet. Un sérialiseur peut définir un objet de contexte sur la pile avant d’appeler un sérialiseur imbriqué. Chaque objet défini sur la pile doit être supprimé par le sérialiseur qui le définit après un appel à un sérialiseur imbriqué retourné.

En règle générale, les objets de la pile contiennent des informations sur le contexte de l’objet actuel qui est sérialisé. Un sérialiseur parent ajoute des informations de contexte à la pile sur l’objet suivant à sérialiser, appelle un sérialiseur approprié et, lorsque l’exécution du sérialiseur se termine sur l’objet, supprime les informations de contexte de la pile. Il incombe à l’implémentation de chaque sérialiseur de déterminer quels objets sont envoyés sur cette pile.

Par exemple, un objet avec une propriété nommée Enabled a un type de données .Boolean Si un sérialiseur écrit cette valeur dans un flux de données, il peut avoir besoin d’inclure le contexte ou le type de propriété qu’il écrit. Toutefois, le sérialiseur ne dispose pas de ces informations, car il est uniquement demandé d’écrire la Boolean valeur. Pour fournir ces informations au sérialiseur, le sérialiseur parent peut envoyer (push) un PropertyDescriptor qui pointe vers la Enabled propriété sur la pile de contexte.

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• IDesignerSerializationManager