GroupBy Element for View

Defines how a new group of objects is displayed. This element is used when defining a table, list, wide, or custom control view.

Schema

  • Configuration Element
  • ViewDefinitions Element
  • View Element
  • GroupBy Element

Syntax

<GroupBy>
  <PropertyName>.NetTypeProperty</PropertyName>
  <ScriptBlock>ScriptToEvaluate</ScriptBlock>
  <Label>TextToDisplay</Label>
  <CustomControl>...</CustomControl>
  <CustomControlName>NameOfControl</CustomControlName>
</GroupBy>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element Description
CustomControl Element for GroupBy Optional element.

Defines the custom control that display new groups.
CustomControlName Element for GroupBy Optional element.

Specifies the name of a control that is used to display the new group.
Label Element for GroupBy Optional element.

Specifies a label that is displayed when a new group is encountered.
PropertyName Element for GroupBy Optional element.

Specifies the .NET property the starts a new group whenever its value changes.
ScriptBlock Element for GroupBy Optional element.

Specifies the script that starts a new group whenever its value changes.

Parent Elements

Element Description
View Element Defines a view that displays one or more .NET objects.

Remarks

When defining how a new group of objects is displayed, you must specify the property or script that will start the new group; however, you cannot specify both.

See Also

CustomControlName Element for GroupBy

Label Element for GroupBy

PropertyName Element for GroupBy

ScriptBlock Element for GroupBy

View Element

Writing a PowerShell Formatting File