Definieren von Auswahlgruppen

Artikel
09/24/2021

Wenn Sie mehrere Ansichten und Steuerelemente erstellen, können Sie Objektsätze definieren, die als Auswahlsätze bezeichnet werden. Mit einem Auswahlsatz können Sie die Objekte einmal definieren, ohne sie für jede Ansicht oder jedes Steuerelement wiederholt definieren zu müssen. In der Regel werden Auswahlsätze verwendet, wenn Sie über einen Satz verwandter .NET-Objekte verfügen. Beispielsweise definiert die FileSystem Formatierungsdatei (FileSystem.format.ps1xml) einen Auswahlsatz der Dateisystemtypen, die von mehreren Ansichten verwendet werden.

Where Selection Sets are Defined and Referenced

Sie definieren Auswahlsätze als Teil der allgemeinen Daten, die von allen Ansichten und Steuerelementen verwendet werden können, die in der Formatierungsdatei definiert sind. Im folgenden Beispiel wird gezeigt, wie drei Auswahlsätze definiert werden.

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

Sie können auf folgende Weise auf einen Auswahlsatz verweisen:

Jede Ansicht verfügt über ein ViewSelectedBy -Element, das definiert, welche Objekte mithilfe der Ansicht angezeigt werden. Das ViewSelectedBy -Element verfügt über ein SelectionSetName untergeordnetes Element, das den Auswahlsatz angibt, den alle Definitionen der Sicht verwenden. Es gibt keine Einschränkung hinsichtlich der Anzahl von Auswahlsätzen, auf die Sie in einer Ansicht verweisen können.
In jeder Definition einer Ansicht oder eines Steuerelements definiert das EntrySelectedBy -Element, welche Objekte mit dieser Definition angezeigt werden. In der Regel verfügt eine Ansicht oder ein Steuerelement nur über eine Definition, sodass die Objekte vom -Element definiert ViewSelectedBy werden. Das Element der Definition verfügt über EntrySelectedBy ein SelectionSetName untergeordnetes Element, das den Auswahlsatz angibt. Wenn Sie den Auswahlsatz für eine Definition angeben, können Sie keines der anderen untergeordneten Elemente des EntrySelectedBy Elements angeben.
In jeder Definition einer Sicht oder eines Steuerelements kann das SelectionCondition -Element verwendet werden, um eine Bedingung für die Verwendung der Definition anzugeben. Das SelectionCondition -Element verfügt über ein SelectionSetName untergeordnetes Element, das den Auswahlsatz angibt, der die Bedingung auslöst. Die Bedingung wird ausgelöst, wenn eines der im Auswahlsatz definierten Objekte angezeigt wird. Weitere Informationen zum Festlegen dieser Bedingungen finden Sie unter Definieren von Bedingungen für das Anzeigen von Daten.

Beispiel für Auswahlsatz

Das folgende Beispiel zeigt einen Auswahlsatz, der direkt aus der FileSystem von Windows PowerShell bereitgestellten Formatierungsdatei übernommen wird. Weitere Informationen zu anderen Windows PowerShell Formatierungsdateien finden Sie unter Windows PowerShell Formatierungsdateien.

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

Auf den vorherigen Auswahlsatz wird im ViewSelectedBy -Element einer Tabellenansicht verwiesen.

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

XML-Elemente

Es gibt keine Beschränkung für die Anzahl der Auswahlsätze, die Sie definieren können. Die folgenden XML-Elemente werden verwendet, um einen Auswahlsatz zu erstellen.

Das SelectionSets-Element definiert die Sätze von .NET-Objekten, auf die von den Ansichten und Steuerelementen der Formatierungsdatei verwiesen wird.
Das SelectionSet-Element definiert einen einzelnen Satz von .NET-Objekten.
Das Name-Element gibt den Namen an, der verwendet wird, um auf den Auswahlsatz zu verweisen.
Das Types-Element gibt die .NET-Typen der Objekte des Auswahlsatzes an. (Innerhalb von Formatierungsdateien werden Objekte durch ihren .NET-Typ angegeben.)

Die folgenden XML-Elemente werden verwendet, um einen Auswahlsatz anzugeben.