WqlEventQuery.WithinInterval プロパティ

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

WqlEventQuery.WithinInterval プロパティ

クエリで使用するポーリング間隔を取得または設定します。

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

Visual Basic (宣言)

Public Property WithinInterval As
 TimeSpan

Visual Basic (使用法)

Dim instance As WqlEventQuery
Dim value As TimeSpan

value = instance.WithinInterval

instance.WithinInterval = value

C#

public TimeSpan WithinInterval { get; set;
 }

C++

public:
property TimeSpan WithinInterval {
    TimeSpan get ();
    void set (TimeSpan value);
}

J#

/** @property */
public TimeSpan get_WithinInterval ()

/** @property */
public void set_WithinInterval (TimeSpan value)

JScript

public function get WithinInterval
 () : TimeSpan

public function set WithinInterval
 (value : TimeSpan)

プロパティ値
イベント クエリで使用するポーリング間隔を格納している TimeSpan 値を返します。

解説

このプロパティは、要求するイベントに対してイベント プロバイダがないクラスだけで設定します。WMI は、要求された条件をポーリングする必要があります。

このプロパティ値を設定すると、それまでにオブジェクトに格納された値をすべてオーバーライドします。クエリ文字列は新しい間隔を反映するようにリビルドされます。

プロパティ値

ポーリングを使用しない場合は null。それ以外の場合は、ポーリングが要求される場合の有効な TimeSpan 値。

.NET Framework のセキュリティ

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

使用例

クエリ "SELECT * FROM __InstanceCreationEvent WITHIN 1 WHERE TargetInstance ISA 'Win32_Process'" を表す新しい WqlEventQuery を初期化する例を次に示します。

Visual Basic

Imports System
Imports System.Management

' This example shows synchronous consumption of events. 
' The client is blocked while waiting for events. 

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

        ' Create event query to be notified within 1 seconds of 
        ' a process being created
        Dim query As New
 WqlEventQuery( _
            "__InstanceCreationEvent", _
            New TimeSpan(0, 0, 1), _
            "TargetInstance isa ""Win32_Process""")

        ' Initialize an event watcher and subscribe to events 
        ' that match this query
        Dim watcher As New
 ManagementEventWatcher(query)
        ' times watcher.WaitForNextEvent in 5 seconds
        watcher.Options.Timeout = New TimeSpan(0, 0, 5)

        ' Block until the next event occurs 
        ' Note: this can be done in a loop
        ' if waiting for more than one occurrence
        Console.WriteLine( _
          "Open an application (notepad.exe) to trigger an event.")
        Dim e As ManagementBaseObject = _
            watcher.WaitForNextEvent()

        'Display information from the event
        Console.WriteLine( _
            "Process {0} has created, path is: {1}",
 _
            CType(e("TargetInstance"), _
                ManagementBaseObject)("Name"), _
            CType(e("TargetInstance"), _
                ManagementBaseObject)("ExecutablePath"))

        'Cancel the subscription
        watcher.Stop()
        Return 0

    End Function 'Main
End Class 'EventWatcherPolling

C#

using System;
using System.Management;

// This example shows synchronous consumption of events. 
// The client is blocked while waiting for events. 

public class EventWatcherPolling 
{
    public static int Main(string[]
 args) 
    {
        // Create event query to be notified within 1 second of 
        // a new process being created
        WqlEventQuery query = 
            new WqlEventQuery("__InstanceCreationEvent",
 
            new TimeSpan(0,0,1), 
            "TargetInstance isa \"Win32_Process\"");

        // Initialize an event watcher and subscribe to events 
        // that match this query
        ManagementEventWatcher watcher =
            new ManagementEventWatcher(query);
        // times out watcher.WaitForNextEvent in 5 seconds
        watcher.Options.Timeout = new TimeSpan(0,0,5);
      
        // Block until the next event occurs 
        // Note: this can be done in a loop if waiting for 
        //        more than one occurrence
        Console.WriteLine(
            "Open an application (notepad.exe) to trigger an event.");
        ManagementBaseObject e = watcher.WaitForNextEvent();

        //Display information from the event
        Console.WriteLine(
            "Process {0} has been created, path is: {1}", 
            ((ManagementBaseObject)e
            ["TargetInstance"])["Name"],
            ((ManagementBaseObject)e
            ["TargetInstance"])["ExecutablePath"]);

        //Cancel the subscription
        watcher.Stop();
        return 0;
    }
}

.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

参照

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