Kijelölési csoportok definiálása

Cikk
09/24/2021

Több nézet és vezérlő létrehozásakor objektumkészleteket definiálhat, amelyek más néven kijelölési halmazok. A kijelölési készlet lehetővé teszi, hogy az objektumokat egyszer definiálja anélkül, hogy azokat minden nézethez vagy vezérlőhez ismételten meg kell határoznia. A kijelölési halmazok általában akkor használatosak, ha kapcsolódó .NET-objektumok egy halmaza van. A formázási fájl (FileSystem.format.ps1xml) például a számos nézet által használt fájlrendszertípusok kiválasztási készletét FileSystem határozza meg.

A Kijelölési készletek meghatározása és hivatkozása

A kijelölési készleteket a formázási fájlban meghatározott összes nézet és vezérlő által használható közös adatok részeként definiálhatja. Az alábbi példa bemutatja, hogyan definiálhat három kijelölési halmazt.

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

A kijelölési készletekre a következő módokon hivatkozhat:

Minden nézet rendelkezik egy elemmel, amely meghatározza, hogy mely objektumok jelennek meg ViewSelectedBy a nézet használatával. A elem rendelkezik egy gyermekelemmel, amely meghatározza a nézet összes definíciója által ViewSelectedBy SelectionSetName használt kijelölési halmazt. A nézetből hivatkozható kijelölési készletek száma nem korlátozott.
Egy nézet vagy vezérlő minden definíciójában az elem határozza meg, hogy mely objektumok jelennek meg EntrySelectedBy a definíció használatával. Egy nézet vagy vezérlő általában csak egy definícióval rendelkezik, ezért az objektumokat az elem határozza ViewSelectedBy meg. A EntrySelectedBy definíció eleme tartalmaz egy gyermekelemet, amely meghatározza a SelectionSetName kijelölési készletet. Ha egy definícióhoz megadja a kijelölési készletet, akkor az elem többi gyermekelemét sem EntrySelectedBy adhatja meg.
Egy nézet vagy vezérlő minden definíciójában az elem használható a definícióhoz használt SelectionCondition feltétel megadására. A elem rendelkezik egy gyermekelemmel, amely meghatározza a feltételt SelectionCondition SelectionSetName aktiváló kijelölési halmazt. A feltétel akkor aktiválódik, ha a kijelölési halmazban meghatározott objektumok bármelyike megjelenik. A feltételek beállítására vonatkozó további információkért lásd: Feltételek definiálása adatok megjelenítéséhez.

Példa kijelöléshalmazra

Az alábbi példa egy olyan kijelölési halmazt mutat be, amely közvetlenül a fájl által biztosított FileSystem formázási fájlból Windows PowerShell. További információ a formázási fájlokról Windows PowerShell a Fájlok formázása Windows PowerShell tartalmaz.

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

Az előző kijelölési készletre a táblanézet ViewSelectedBy elemében hivatkozunk.

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

XML-elemek

A meghatározhat kijelölési készletek száma nincs korlátozva. A következő XML-elemek egy kijelölési készlet létrehozásához használhatók.

A SelectionSets elem határozza meg a formázási fájl nézetei és vezérlői által hivatkozott .NET-objektumok készletét.
A SelectionSet elem egyetlen .NET-objektumkészletet határoz meg.
A Név elem határozza meg a kijelölési készletre való hivatkozáshoz használt nevet.
A Típusok elem határozza meg a kijelölési készlet objektumának .NET-típusait. (A formázási fájlokon belül az objektumokat a .NET-típusuk adja meg.)

A következő XML-elemek kijelölési készlet megadására használhatók.