EnumerationOptions

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

EnumerationOptions クラス

クエリと列挙関連のオプション オブジェクト用の基本クラスを用意しています。

名前空間: System.Management
アセンブリ: System.Management (system.management.dll 内)
構文

Visual Basic (宣言)

Public Class EnumerationOptions
    Inherits ManagementOptions

Visual Basic (使用法)

Dim instance As EnumerationOptions

C#

public class EnumerationOptions : ManagementOptions

C++

public ref class EnumerationOptions : public
 ManagementOptions

J#

public class EnumerationOptions extends ManagementOptions

JScript

public class EnumerationOptions extends
 ManagementOptions

使用例

EnumerationOptions コンストラクタを使用して EnumerationOptions 変数を初期化し、WMI クラスおよびそのサブクラスのすべてのインスタンスを取得する例を次に示します。

Visual Basic

Imports System
Imports System.Management
Public Class RemoteConnect

    Public Overloads Shared
 Function Main( _
    ByVal args() As String)
 As Integer

        Dim opt As New EnumerationOptions
        ' Will enumerate instances of the given class
        ' and any subclasses.
        opt.EnumerateDeep = True
        Dim mngmtClass As New
 ManagementClass("CIM_Service")
        Dim o As ManagementObject
        For Each o In mngmtClass.GetInstances(opt)
            Console.WriteLine(o("Name"))
        Next o

        Return 0
    End Function
End Class

C#

using System;
using System.Management;
public class RemoteConnect 
{
    public static void Main()
 
    {
        EnumerationOptions opt = new EnumerationOptions();
        // Will enumerate instances of the given class
        // and any subclasses.
        opt.EnumerateDeep = true;
        ManagementClass c = new ManagementClass("CIM_Service");
        foreach (ManagementObject o in c.GetInstances(opt))
            Console.WriteLine(o["Name"]);
    }
}

継承階層

System.Object
   System.Management.ManagementOptions
    System.Management.EnumerationOptions

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
EnumerationOptions メンバ
System.Management 名前空間

EnumerationOptions コンストラクタ ()

既定値を使用して、EnumerationOptions クラスの新しいインスタンスを初期化します。既定値については、それぞれのプロパティの説明を参照してください。これは既定のコンストラクタです。

名前空間: System.Management
アセンブリ: System.Management (system.management.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New EnumerationOptions

C#

public EnumerationOptions ()

C++

public:
EnumerationOptions ()

J#

public EnumerationOptions ()

JScript

public function EnumerationOptions ()

使用例

EnumerationOptions コンストラクタを使用して EnumerationOptions 変数を初期化し、WMI クラスおよびそのサブクラスのすべてのインスタンスを取得する例を次に示します。

Visual Basic

Imports System
Imports System.Management
Public Class RemoteConnect

    Public Overloads Shared
 Function Main( _
    ByVal args() As String)
 As Integer

        Dim opt As New EnumerationOptions
        ' Will enumerate instances of the given class
        ' and any subclasses.
        opt.EnumerateDeep = True
        Dim mngmtClass As New
 ManagementClass("CIM_Service")
        Dim o As ManagementObject
        For Each o In mngmtClass.GetInstances(opt)
            Console.WriteLine(o("Name"))
        Next o

        Return 0
    End Function
End Class

C#

using System;
using System.Management;
public class RemoteConnect 
{
    public static void Main()
 
    {
        EnumerationOptions opt = new EnumerationOptions();
        // Will enumerate instances of the given class
        // and any subclasses.
        opt.EnumerateDeep = true;
        ManagementClass c = new ManagementClass("CIM_Service");
        foreach (ManagementObject o in c.GetInstances(opt))
            Console.WriteLine(o["Name"]);
    }
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
EnumerationOptions クラス
EnumerationOptions メンバ
System.Management 名前空間

EnumerationOptions コンストラクタ (ManagementNamedValueCollection, TimeSpan, Int32, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean)

さまざまなオプション値の指定を許可して、クエリまたは列挙に使用する EnumerationOptions クラスの新しいインスタンスを初期化します。

名前空間: System.Management
アセンブリ: System.Management (system.management.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    context As ManagementNamedValueCollection, _
    timeout As TimeSpan, _
    blockSize As Integer, _
    rewindable As Boolean, _
    returnImmediatley As Boolean, _
    useAmendedQualifiers As Boolean, _
    ensureLocatable As Boolean, _
    prototypeOnly As Boolean, _
    directRead As Boolean, _
    enumerateDeep As Boolean _
)

Visual Basic (使用法)

Dim context As ManagementNamedValueCollection
Dim timeout As TimeSpan
Dim blockSize As Integer
Dim rewindable As Boolean
Dim returnImmediatley As Boolean
Dim useAmendedQualifiers As Boolean
Dim ensureLocatable As Boolean
Dim prototypeOnly As Boolean
Dim directRead As Boolean
Dim enumerateDeep As Boolean

Dim instance As New EnumerationOptions(context,
 timeout, blockSize, rewindable, returnImmediatley, useAmendedQualifiers, ensureLocatable,
 prototypeOnly, directRead, enumerateDeep)

C#

public EnumerationOptions (
    ManagementNamedValueCollection context,
    TimeSpan timeout,
    int blockSize,
    bool rewindable,
    bool returnImmediatley,
    bool useAmendedQualifiers,
    bool ensureLocatable,
    bool prototypeOnly,
    bool directRead,
    bool enumerateDeep
)

C++

public:
EnumerationOptions (
    ManagementNamedValueCollection^ context, 
    TimeSpan timeout, 
    int blockSize, 
    bool rewindable, 
    bool returnImmediatley, 
    bool useAmendedQualifiers, 
    bool ensureLocatable, 
    bool prototypeOnly, 
    bool directRead, 
    bool enumerateDeep
)

J#

public EnumerationOptions (
    ManagementNamedValueCollection context, 
    TimeSpan timeout, 
    int blockSize, 
    boolean rewindable, 
    boolean returnImmediatley, 
    boolean useAmendedQualifiers, 
    boolean ensureLocatable, 
    boolean prototypeOnly, 
    boolean directRead, 
    boolean enumerateDeep
)

JScript

public function EnumerationOptions (
    context : ManagementNamedValueCollection, 
    timeout : TimeSpan, 
    blockSize : int, 
    rewindable : boolean, 
    returnImmediatley : boolean, 
    useAmendedQualifiers : boolean, 
    ensureLocatable : boolean, 
    prototypeOnly : boolean, 
    directRead : boolean, 
    enumerateDeep : boolean
)

パラメータ

context

プロバイダに渡すことができるプロバイダ固有情報を格納しているオプション コンテキスト オブジェクト。

timeout

結果を列挙するためのタイムアウト値。

blockSize

WMI (Windows Management Instrumentation) から一度に取得する項目数。

rewindable

結果セットを巻き戻すことができる (つまり、複数回の走査を許可する) かどうかを示すには true。それ以外の場合は false。

returnImmediatley

操作をすぐに返すか (半同期)、またはすべての結果が得られるまでブロックすることを示すには true。それ以外の場合は false。

useAmendedQualifiers

返されたオブジェクトが変更された (ロケール対応) 修飾子を格納していることを示すには true。それ以外の場合は false。

ensureLocatable

返されたすべてのオブジェクトのパスが有効であることを確認する場合は true。それ以外の場合は false。

prototypeOnly

実際の結果ではなく、結果セットのプロトタイプを返すには true。それ以外の場合は false。

directRead

指定したクラスだけのオブジェクトを取得するか、派生クラスからもオブジェクトを取得するには true。それ以外の場合は false。

enumerateDeep

サブクラスの再帰的な列挙を使用するには true。それ以外の場合は false。

使用例

EnumerationOptions コンストラクタを使用して EnumerationOptions 変数を初期化し、WMI クラスおよびそのサブクラスのすべてのインスタンスを取得する例を次に示します。

Visual Basic

Imports System
Imports System.Management
Public Class RemoteConnect

    Public Overloads Shared
 Function Main( _
    ByVal args() As String)
 As Integer

        Dim opt As EnumerationOptions
        Opt = New EnumerationOptions( _
            Nothing, System.TimeSpan.MaxValue, _
            1, True, True, False,
 _
            True, False, False,
 True)

        Dim mngmtClass As New
 ManagementClass("CIM_Service")
        Dim o As ManagementObject
        For Each o In mngmtClass.GetInstances(opt)
            Console.WriteLine(o("Name"))
        Next o

        Return 0
    End Function
End Class

C#

using System;
using System.Management;
public class RemoteConnect 
{
    public static void Main()
 
    {
        EnumerationOptions opt = new EnumerationOptions(
            null, System.TimeSpan.MaxValue,
            1, true, true, false,
 
            true, false, false,
 true);

        ManagementClass c = new ManagementClass("CIM_Service");
        foreach (ManagementObject o in c.GetInstances(opt))
            Console.WriteLine(o["Name"]);
    }
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
EnumerationOptions クラス
EnumerationOptions メンバ
System.Management 名前空間

EnumerationOptions コンストラクタ

オーバーロードの一覧

名前	説明
EnumerationOptions ()	既定値を使用して、EnumerationOptions クラスの新しいインスタンスを初期化します。既定値については、それぞれのプロパティの説明を参照してください。これは既定のコンストラクタです。
EnumerationOptions (ManagementNamedValueCollection, TimeSpan, Int32, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean)	さまざまなオプション値の指定を許可して、クエリまたは列挙に使用する EnumerationOptions クラスの新しいインスタンスを初期化します。

参照

関連項目

EnumerationOptions クラス
EnumerationOptions メンバ
System.Management 名前空間

EnumerationOptions プロパティ

パブリック プロパティ

	名前	説明
	BlockSize	ブロック操作のブロック サイズを取得または設定します。コレクションを列挙する場合、WMI は指定したサイズのグループで結果を返します。
	Context	WMI (Windows Management Instrumentation) コンテキスト オブジェクトを取得または設定します。これは、カスタマイズされた操作のためのコンテキスト情報をサポートしている WMI プロバイダに渡す名前/値ペア リストです。 ( ManagementOptions から継承されます。)
	DirectRead	スーパー クラスまたは派生クラスを考慮せずに、指定したクラスに対して、WMI プロバイダへの直接アクセスが要求されるかどうかを示す値を取得または設定します。
	EnsureLocatable	返されるオブジェクトがロケール情報を格納するかどうかを示す値を取得または設定します。これにより、__PATH、__RELPATH、__SERVER などのシステム プロパティは NULL になりません。このフラグは、クエリだけで使用でき、列挙では無視されます。
	EnumerateDeep	指定したスーパークラスから派生したすべてのクラスに対して、再帰的な列挙を要求するかどうかを示す値を取得または設定します。false の場合は、直接の派生クラスのメンバだけが返されます。
	PrototypeOnly	クエリが実際の結果ではなく、結果セットのプロトタイプを返すかどうかを示す値を取得または設定します。このフラグは、プロトタイプ作成のために使用します。
	ReturnImmediately	呼び出された操作を同期的または半同期的に実行するかどうかを示す値を取得または設定します。このプロパティを true に設定した場合、列挙体を呼び出すと、その呼び出しはすぐに返されます。結果の実際の取得は、結果として得られるコレクションをウォークするときに発生します。
	Rewindable	コレクションが巻き戻し可能と見なされるかどうかを示す値を取得または設定します。true の場合、コレクション内のオブジェクトは、複数回の列挙のために使用できます。false の場合、そのコレクションは 1 回だけ列挙できます。
	Timeout	操作に適用するタイムアウトを取得または設定します。コレクションを返す操作では、このタイムアウトはその操作自体ではなく、結果として得られるコレクションの列挙に適用されます。操作自体に適用するには、ReturnImmediately プロパティを使用します。このプロパティは、操作が半同期的に実行されることを示すために使用されます。 ( ManagementOptions から継承されます。)
	UseAmendedQualifiers	WMI から返されたオブジェクトに修正済みの情報が含まれているかどうかを示す値を取得または設定します。通常、修正された情報は、オブジェクトやプロパティの説明のように、WMI オブジェクトに結び付けられたローカライズ可能な情報になります。

参照

関連項目

EnumerationOptions クラス
System.Management 名前空間

EnumerationOptions メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Clone	オーバーライドされます。 オブジェクトのコピーを返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

EnumerationOptions クラス
System.Management 名前空間

EnumerationOptions メンバ

クエリと列挙関連のオプション オブジェクト用の基本クラスを用意しています。

EnumerationOptions データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	EnumerationOptions	オーバーロードされます。

パブリック プロパティ

	名前	説明
	BlockSize	ブロック操作のブロック サイズを取得または設定します。コレクションを列挙する場合、WMI は指定したサイズのグループで結果を返します。
	Context	WMI (Windows Management Instrumentation) コンテキスト オブジェクトを取得または設定します。これは、カスタマイズされた操作のためのコンテキスト情報をサポートしている WMI プロバイダに渡す名前/値ペア リストです。 (ManagementOptions から継承されます。)
	DirectRead	スーパー クラスまたは派生クラスを考慮せずに、指定したクラスに対して、WMI プロバイダへの直接アクセスが要求されるかどうかを示す値を取得または設定します。
	EnsureLocatable	返されるオブジェクトがロケール情報を格納するかどうかを示す値を取得または設定します。これにより、__PATH、__RELPATH、__SERVER などのシステム プロパティは NULL になりません。このフラグは、クエリだけで使用でき、列挙では無視されます。
	EnumerateDeep	指定したスーパークラスから派生したすべてのクラスに対して、再帰的な列挙を要求するかどうかを示す値を取得または設定します。false の場合は、直接の派生クラスのメンバだけが返されます。
	PrototypeOnly	クエリが実際の結果ではなく、結果セットのプロトタイプを返すかどうかを示す値を取得または設定します。このフラグは、プロトタイプ作成のために使用します。
	ReturnImmediately	呼び出された操作を同期的または半同期的に実行するかどうかを示す値を取得または設定します。このプロパティを true に設定した場合、列挙体を呼び出すと、その呼び出しはすぐに返されます。結果の実際の取得は、結果として得られるコレクションをウォークするときに発生します。
	Rewindable	コレクションが巻き戻し可能と見なされるかどうかを示す値を取得または設定します。true の場合、コレクション内のオブジェクトは、複数回の列挙のために使用できます。false の場合、そのコレクションは 1 回だけ列挙できます。
	Timeout	操作に適用するタイムアウトを取得または設定します。コレクションを返す操作では、このタイムアウトはその操作自体ではなく、結果として得られるコレクションの列挙に適用されます。操作自体に適用するには、ReturnImmediately プロパティを使用します。このプロパティは、操作が半同期的に実行されることを示すために使用されます。 (ManagementOptions から継承されます。)
	UseAmendedQualifiers	WMI から返されたオブジェクトに修正済みの情報が含まれているかどうかを示す値を取得または設定します。通常、修正された情報は、オブジェクトやプロパティの説明のように、WMI オブジェクトに結び付けられたローカライズ可能な情報になります。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Clone	オーバーライドされます。 オブジェクトのコピーを返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

EnumerationOptions クラス
System.Management 名前空間