WqlEventQuery.GroupByPropertyList Property

Definition

Namespace:

System.Management

Assembly:

System.Management.dll

Package:

System.Management v9.0.0-rc.2.24473.5

Gets or sets properties in the event to be used for grouping events of the same type.

public:
 property System::Collections::Specialized::StringCollection ^ GroupByPropertyList { System::Collections::Specialized::StringCollection ^ get(); void set(System::Collections::Specialized::StringCollection ^ value); };

public System.Collections.Specialized.StringCollection GroupByPropertyList { get; set; }

member this.GroupByPropertyList : System.Collections.Specialized.StringCollection with get, set

Public Property GroupByPropertyList As StringCollection

Property Value

StringCollection

Returns a StringCollection containing the properties in the event to be 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 grouping.

Property Value

Null, if no grouping is required; otherwise, a collection of event property names.

.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.