Selectiereeksen definiëren

Artikel
09/24/2021

Wanneer u meerdere weergaven en besturingselementen maakt, kunt u sets met objecten definiëren die selectiesets worden genoemd. Met een selectieset kunt u de objecten één keer definiëren, zonder dat u ze herhaaldelijk voor elke weergave of elk besturingselement moet definiëren. Selectiesets worden doorgaans gebruikt wanneer u een set gerelateerde .NET-objecten hebt. Het opmaakbestand (FileSystem.format.ps1xml) definieert bijvoorbeeld een selectieset van de bestandssysteemtypen die door verschillende FileSystem weergaven worden gebruikt.

Waar selectiesets zijn gedefinieerd en waarnaar wordt verwezen

U definieert selectiesets als onderdeel van de algemene gegevens die kunnen worden gebruikt door alle weergaven en besturingselementen die in het opmaakbestand zijn gedefinieerd. In het volgende voorbeeld ziet u hoe u drie selectiesets definieert.

<Configuration>
  <SelectionSets>
    <SelectionSet>...</SelectionSet>
    <SelectionSet>...</SelectionSet>
    <SelectionSet>...</SelectionSet>
  </SelectionSets>
</Configuration>

U kunt op de volgende manieren verwijzen naar een selectieset:

Elke weergave heeft een ViewSelectedBy element dat definieert welke objecten worden weergegeven met behulp van de weergave. Het ViewSelectedBy element heeft een onderliggend element dat de SelectionSetName selectieset specificeert die door alle definities van de weergave wordt gebruikt. Er is geen beperking voor het aantal selectiesets waarnaar u vanuit een weergave kunt verwijzen.
In elke definitie van een weergave of besturingselement definieert het EntrySelectedBy element welke objecten worden weergegeven met behulp van die definitie. Normaal gesproken heeft een weergave of besturingselement slechts één definitie, zodat de objecten worden gedefinieerd door het ViewSelectedBy -element. Het EntrySelectedBy element van de definitie heeft een onderliggend element dat de SelectionSetName selectieset specificeert. Als u de selectieset voor een definitie opgeeft, kunt u geen van de andere onderliggende elementen van het EntrySelectedBy element opgeven.
In elke definitie van een weergave of besturingselement kan het element worden gebruikt om een voorwaarde op te SelectionCondition geven voor wanneer de definitie wordt gebruikt. Het SelectionCondition element heeft een onderliggend element dat de SelectionSetName selectieset specificeert die de voorwaarde activeert. De voorwaarde wordt geactiveerd wanneer een van de objecten die in de selectieset zijn gedefinieerd, wordt weergegeven. Zie Voorwaarden definiëren voor wanneer gegevens worden weergegeven voor meer informatie over het instellen van deze voorwaarden.

Voorbeeld van selectieset

In het volgende voorbeeld ziet u een selectieset die rechtstreeks uit het opmaakbestand FileSystem van de Windows PowerShell. Zie Opmaakbestanden voor Windows PowerShell meer informatie over Windows PowerShell opmaakbestanden.

<SelectionSets>
  <SelectionSet>
    <Name>FileSystemTypes</Name>
    <Types>
     <TypeName>System.IO.DirectoryInfo</TypeName>
     <TypeName>System.IO.FileInfo</TypeName>
     <TypeName>Deserialized.System.IO.DirectoryInfo</TypeName>
     <TypeName>Deserialized.System.IO.FileInfo</TypeName>
    </Types>
  </SelectionSet>
</SelectionSets>

Naar de vorige selectieset wordt verwezen in het ViewSelectedBy element van een tabelweergave.

<ViewDefinitions>
  <View>
    <Name>Files</Name>
    <ViewSelectedBy>
      <SelectionSetName>FileSystemTypes</SelectionSetName>
    </ViewSelectedBy>
    <TableControl>...</TableControl>
  </View>
</ViewDefinitions>

XML-elementen

Er is geen limiet voor het aantal selectiesets dat u kunt definiëren. De volgende XML-elementen worden gebruikt om een selectieset te maken.

Het element SelectionSets definieert de sets .NET-objecten waarnaar wordt verwezen door de weergaven en besturingselementen van het opmaakbestand.
Het element SelectionSet definieert één set .NET-objecten.
Het element Naam geeft de naam op die wordt gebruikt om te verwijzen naar de selectieset.
Het element Typen specificeert de .NET-typen van de objecten van de selectieset. (Binnen opmaakbestanden worden objecten opgegeven door hun .NET-type.)

De volgende XML-elementen worden gebruikt om een selectieset op te geven.