Definování sad výběru

Článek
09/24/2021

Při vytváření více zobrazení a ovládacích prvků můžete definovat sady objektů, které se označují jako sady pro výběr. Sada výběrů umožňuje definovat objekty jednou, aniž byste je museli definovat opakovaně pro každé zobrazení nebo ovládací prvek. Sady pro výběr se obvykle používají, pokud máte sadu souvisejících objektů .NET. Například FileSystem formátovací soubor (FileSystem. Format. ps1xml) definuje sadu výběrů typů systému souborů, které používá několik zobrazení.

Kde jsou definovány sady výběru a odkazovány

Sady pro výběr definujete jako součást společných dat, která mohou být používána všemi zobrazeními a ovládacími prvky definovanými v souboru formátování. Následující příklad ukazuje, jak definovat tři sady výběru.

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

Můžete odkazovat na sady pro výběr následujícími způsoby:

Každé zobrazení má ViewSelectedBy element, který definuje, které objekty se zobrazí pomocí zobrazení. ViewSelectedByElement má SelectionSetName podřízený element, který určuje sadu výběru, kterou používají všechny definice zobrazení. Počet sad výběru, na které můžete odkazovat ze zobrazení, není nijak omezen.
V každé definici zobrazení nebo ovládacího prvku EntrySelectedBy prvek definuje, které objekty se zobrazí pomocí této definice. Zobrazení nebo ovládací prvek obvykle obsahuje pouze jednu definici, aby objekty byly definovány ViewSelectedBy prvkem. EntrySelectedByElement definice má SelectionSetName podřízený element, který určuje sadu výběru. Pokud zadáte sadu výběru pro definici, nelze zadat žádné další podřízené prvky EntrySelectedBy elementu.
V každé definici zobrazení nebo ovládacího prvku SelectionCondition lze prvek použít k určení podmínky pro použití definice. SelectionConditionElement má SelectionSetName podřízený element, který určuje sadu výběru, která spouští podmínku. Podmínka se aktivuje při zobrazení libovolného objektu definovaného v sadě pro výběr. Další informace o tom, jak tyto podmínky nastavit, najdete v tématu definování podmínek pro zobrazení dat.

Příklad sady výběru

Následující příklad ukazuje sadu výběru, která je převedena přímo ze FileSystem souboru s formátováním, který poskytuje Windows PowerShell. další informace o dalších Windows PowerShell formátování souborů najdete v tématu Windows PowerShell formátování souborů.

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

Na předchozí sadu výběru se odkazuje v ViewSelectedBy prvku zobrazení tabulky.

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

XML – prvky

Počet sad výběru, které můžete definovat, není nijak omezený. Následující prvky XML slouží k vytvoření sady výběru.

Element SelectionSets definuje sady objektů .NET, na které odkazují zobrazení a ovládací prvky formátování souboru.
Element SelectionSet definuje jednu sadu objektů .NET.
Element Name Určuje název, který se používá k odkazování na sadu výběru.
Element Types určuje typy rozhraní .NET objektů sady pro výběr. (V rámci formátování souborů jsou objekty určeny podle typu .NET.)

K určení sady výběru se používají následující prvky XML.