ContextStack クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ContextStack クラス

入れ子のシリアライザで情報を使用できるように、シリアライザによって使用するスタックオブジェクトを提供します。

名前空間: System.ComponentModel.Design.Serialization
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 ContextStack

Visual Basic (使用法)

Dim instance As ContextStack

public sealed class ContextStack

C++

public ref class ContextStack sealed

public final class ContextStack

JScript

public final class ContextStack

解説

一部のシリアライザでは、オブジェクトの状態を一貫して正しく維持するために、オブジェクトのコンテキスト情報が必要です。ContextStack クラスを使用すると、シリアル化するオブジェクトのコンテキストデータを、シリアライザによって、他のシリアライザからアクセスできるスタックに設定できます。Context プロパティの値は、シリアライザの使用について情報を共有するために IDesignerSerializationManager によって提供されます。

デザインドキュメントをシリアル化するプロセスは、多階層の入れ子で構成される場合があります。オブジェクトの状態を正しく永続化するには、各入れ子レベルのオブジェクトでコンテキスト情報が必要です。このような状況では、コンテキストスタックを使用すると便利です。シリアライザは、入れ子のシリアライザを呼び出す前にコンテキストオブジェクトをスタックに設定できます。オブジェクトを設定したシリアライザは、入れ子のシリアライザへの呼び出しに対する戻り値が返された後で、スタックに設定された各オブジェクトを削除する必要があります。

通常、スタック上のオブジェクトには、シリアル化されている現在のオブジェクトのコンテキストについての情報が格納されます。親シリアライザは、次にシリアル化されるオブジェクトについてのコンテキスト情報をスタックに追加し、適切なシリアライザを呼び出し、そのシリアライザがオブジェクトへの実行を完了した時点でスタックからコンテキスト情報を削除します。このスタックでどのオブジェクトがプッシュされるかは、各シリアライザの実装によって異なります。

たとえば、Enabled というプロパティを持つオブジェクトに Boolean データ型があるとします。シリアライザがこの値をデータストリームに書き込む場合、コンテキストまたはプロパティの型も含める必要が生じる場合もあります。しかし、シリアライザに対しては Boolean 値の書き込みだけが命令されているため、シリアライザは必要な情報を取得できません。シリアライザにこの情報を提供するために、親シリアライザは、コンテキストスタック上で Enabled プロパティを指す PropertyDescriptor をプッシュできます。

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、SharedState です。HostProtectionAttribute は、デスクトップアプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

メモ

このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、SharedState です。HostProtectionAttribute は、デスクトップアプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

使用例

ContextStack を使用して 10 個の値をプッシュし、その後削除するコード例を次に示します。

Visual Basic

Imports System
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 Not item Is
 Nothing
            Console.WriteLine(("Value popped from stack: "
 + item.ToString()))
            item = stack.Pop()
        End While
    End Sub

End Module

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()
 );
        }
    }
}

C++

#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 );
}