ContextStack Clase

Definición

public ref class ContextStack sealed

public sealed class ContextStack

type ContextStack = class

Public NotInheritable Class ContextStack

Herencia

Object

ContextStack

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar para ContextStack insertar y, a continuación, quitar 10 valores.

#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

Comentarios

Algunos serializadores requieren información acerca del contexto de un objeto para conservar correctamente su estado. La ContextStack clase permite a un serializador establecer datos sobre el contexto de un objeto que se está serializando en una pila donde otro serializador puede acceder a él. El valor de la Context propiedad lo proporciona un IDesignerSerializationManager para compartir información de uso en algunos serializadores.

Una pila de contexto es útil porque el proceso de serialización de un documento de diseño se puede anidar profundamente, y los objetos en cada nivel de anidamiento pueden requerir información de contexto para conservar correctamente el estado del objeto. Un serializador puede establecer un objeto de contexto en la pila antes de invocar un serializador anidado. El serializador debe quitar cada objeto establecido en la pila que lo establezca después de una llamada a un serializador anidado.

Normalmente, los objetos de la pila contienen información sobre el contexto del objeto actual que se está serializando. Un serializador primario agrega información de contexto a la pila sobre el siguiente objeto que se va a serializar, llama a un serializador adecuado y, cuando el serializador termina de ejecutarse en el objeto, quita la información de contexto de la pila. Depende de la implementación de cada serializador determinar qué objetos se insertan en esta pila.

Por ejemplo, un objeto con una propiedad denominada Enabled tiene un tipo de datos de Boolean. Si un serializador escribe este valor en un flujo de datos, es posible que tenga que incluir el contexto o el tipo de propiedad que está escribiendo. Sin embargo, el serializador no tiene esta información, ya que solo se le indica que escriba el Boolean valor. Para proporcionar esta información al serializador, el serializador primario puede insertar un PropertyDescriptor que apunte a la propiedad en la Enabled pila de contexto.

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

• IDesignerSerializationManager