WqlEventQuery.GroupWithinInterval Property

Definition

Gets or sets the interval to be used for grouping events of the same type.

public:
 property TimeSpan GroupWithinInterval { TimeSpan get(); void set(TimeSpan value); };
public TimeSpan GroupWithinInterval { get; set; }
member this.GroupWithinInterval : TimeSpan with get, set
Public Property GroupWithinInterval As TimeSpan

Property Value

Returns a TimeSpan value containing the interval used for grouping events of the same type.

Examples

The following example initializes a new WqlEventQuery and displays the event query string.

using System;
using System.Management;

public class EventSample
{
    public static void Main(string[] args)
    {
        WqlEventQuery query = new WqlEventQuery();
        query.EventClassName = "__InstanceCreationEvent";
        query.Condition = "TargetInstance ISA 'Win32_NTLogEvent'";
        query.GroupWithinInterval = new TimeSpan(0, 0, 10);
        System.Collections.Specialized.StringCollection collection =
            new System.Collections.Specialized.StringCollection();
        collection.Add("TargetInstance.SourceName");
        query.GroupByPropertyList = collection;
        query.HavingCondition = "NumberOfEvents > 25";

        Console.WriteLine(query.QueryString);
        return;
    }
}
Imports System.Management


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

        Dim query As New WqlEventQuery
        query.EventClassName = "__InstanceCreationEvent"
        query.Condition = "TargetInstance ISA 'Win32_NTLogEvent'"
        query.GroupWithinInterval = New TimeSpan(0, 0, 10)
        Dim collection As New System.Collections.Specialized. _
            StringCollection
        collection.Add("TargetInstance.SourceName")
        query.GroupByPropertyList = collection
        query.HavingCondition = "NumberOfEvents > 25"

        MessageBox.Show(query.QueryString)

    End Function 'Main
End Class

Remarks

Setting this property value overrides any previous value stored in the object. The query string is rebuilt to reflect the new interval.

Property Value

Null, if there is no grouping involved; otherwise, the interval in which WMI should group events of the same type.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Applies to