Définition de jeux de sélections

Article
09/24/2021

Lorsque vous créez plusieurs vues et contrôles, vous pouvez définir des ensembles d’objets appelés jeux de sélection. Un jeu de sélection vous permet de définir les objets une seule fois, sans avoir à les définir à plusieurs reprises pour chaque vue ou contrôle. En règle générale, les jeux de sélection sont utilisés lorsque vous avez un ensemble d’objets .NET associés. Par exemple, le FileSystem fichier de mise en forme (FileSystem. format. ps1xml) définit un jeu de sélection des types de système de fichiers utilisés par plusieurs vues.

Où les jeux de sélection sont définis et référencés

Vous définissez des jeux de sélection dans le cadre des données communes qui peuvent être utilisées par toutes les vues et tous les contrôles définis dans le fichier de mise en forme. L’exemple suivant montre comment définir trois jeux de sélection.

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

Vous pouvez référencer un jeu de sélection des manières suivantes :

Chaque vue a un ViewSelectedBy élément qui définit les objets qui sont affichés à l’aide de la vue. L' ViewSelectedBy élément a un SelectionSetName élément enfant qui spécifie le jeu de sélection utilisé par toutes les définitions de la vue. Il n’existe aucune restriction sur le nombre de jeux de sélection que vous pouvez référencer à partir d’une vue.
Dans chaque définition d’une vue ou d’un contrôle, l' EntrySelectedBy élément définit les objets qui sont affichés à l’aide de cette définition. En général, une vue ou un contrôle n’a qu’une seule définition, de sorte que les objets sont définis par l' ViewSelectedBy élément. L' EntrySelectedBy élément de la définition a un SelectionSetName élément enfant qui spécifie le jeu de sélection. Si vous spécifiez le jeu de sélection pour une définition, vous ne pouvez pas spécifier d’autres éléments enfants de l' EntrySelectedBy élément.
Dans chaque définition d’une vue ou d’un contrôle, l' SelectionCondition élément peut être utilisé pour spécifier une condition lorsque la définition est utilisée. L' SelectionCondition élément a un SelectionSetName élément enfant qui spécifie le jeu de sélection qui déclenche la condition. La condition est déclenchée lorsque l’un des objets définis dans le jeu de sélection est affiché. Pour plus d’informations sur la façon de définir ces conditions, consultez définition des conditions d’affichage des données.

Exemple de jeu de sélection

L’exemple suivant montre un jeu de sélection issu directement du fichier de FileSystem mise en forme fourni par Windows PowerShell. pour plus d’informations sur les autres Windows PowerShell les fichiers de mise en forme, consultez Windows PowerShell mise en forme des fichiers.

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

Le jeu de sélection précédent est référencé dans l' ViewSelectedBy élément d’une vue de table.

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

Éléments XML

Il n’existe aucune limite au nombre de jeux de sélection que vous pouvez définir. Les éléments XML suivants sont utilisés pour créer un jeu de sélection.

L’élément SelectionSets définit les jeux d’objets .net référencés par les vues et les contrôles du fichier de mise en forme.
L’élément SelectionSet définit un ensemble unique d’objets .net.
L’élément Name spécifie le nom utilisé pour référencer le jeu de sélection.
L’élément types spécifie les types .net des objets du jeu de sélection. (Dans les fichiers de mise en forme, les objets sont spécifiés par leur type .NET.)

Les éléments XML suivants sont utilisés pour spécifier un jeu de sélection.