ContextStack Класс

Определение

Содержит объект стека, который может использоваться сериализатором для обеспечения доступности данных вложенным сериализаторам.

public ref class ContextStack sealed
public sealed class ContextStack
type ContextStack = class
Public NotInheritable Class ContextStack
Наследование
ContextStack

Примеры

В следующем примере кода демонстрируется использование принудительной ContextStack отправки, а затем удаление 10 значений.

#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

Комментарии

Некоторым сериализаторам требуется информация о контексте объекта, чтобы правильно сохранить их состояние. Класс ContextStack позволяет сериализатору задавать данные о контексте объекта, сериализуемого в стек, к которому может получить доступ другой сериализатор. Значение Context свойства предоставляется общими сведениями IDesignerSerializationManager об использовании для некоторых сериализаторов.

Стек контекста полезен, так как процесс сериализации документа разработки может быть глубоко вложенным, а объекты на каждом уровне вложения могут требовать сведений о контексте для правильного сохранения состояния объекта. Сериализатор может задать объект контекста для стека перед вызовом вложенного сериализатора. Каждый объект, заданный для стека, должен быть удален сериализатором, который устанавливает его после вызова вложенного сериализатора.

Как правило, объекты в стеке содержат сведения о контексте сериализуемого текущего объекта. Родительский сериализатор добавляет контекстную информацию в стек о следующем объекте для сериализации, вызывает соответствующий сериализатор и, когда сериализатор завершает выполнение объекта, удаляет из стека сведения о контексте. Это зависит от реализации каждого сериализатора, чтобы определить, какие объекты помещают в этот стек.

Например, объект со свойством с именем Enabled имеет тип Booleanданных . Если сериализатор записывает это значение в поток данных, может потребоваться включить контекст или тип записываемого свойства. Однако сериализатор не содержит этих сведений, так как он указан только для записи Boolean значения. Чтобы предоставить эти сведения сериализатору, родительский сериализатор может отправить PropertyDescriptor объект, указывающий на Enabled свойство в стеке контекста.

Конструкторы

ContextStack()

Инициализирует новый экземпляр класса ContextStack.

Свойства

Current

Возвращает текущий объект в стеке.

Item[Int32]

Возвращает объект стека на указанном уровне.

Item[Type]

Возвращает первый объект стека, который наследует или использует заданный тип.

Методы

Append(Object)

Добавляет объект в конец стека, но не отправляет его на верх стека.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
Pop()

Удаляет текущий объект из стека, возвращая его значение.

Push(Object)

Отправляет или помещает указанный объект в стек.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел