Definir conjuntos de seleção

Ao criar várias exibições e controles, você pode definir conjuntos de objetos chamados de conjuntos de seleção. Um conjunto de seleção permite que você defina os objetos uma vez, sem precisar defini-los repetidamente para cada exibição ou controle. Normalmente, os conjuntos de seleção são usados quando você tem um conjunto de objetos .NET relacionados. Por exemplo, o arquivo FileSystem de formatação (FileSystem.format.ps1xml) define um conjunto de seleção dos tipos de sistema de arquivos que várias exibições usam.

Em que conjuntos de seleção são definidos e referenciados

Você define conjuntos de seleção como parte dos dados comuns que podem ser usados por todas as exibições e controles definidos no arquivo de formatação. O exemplo a seguir mostra como definir três conjuntos de seleção.

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

Você pode referenciar um conjunto de seleção das seguintes maneiras:

Cada exibição tem ViewSelectedBy um elemento que define quais objetos são exibidos usando a exibição . O ViewSelectedBy elemento tem um elemento filho que especifica o conjunto de seleção que todas as SelectionSetName definições da exibição usam. Não há nenhuma restrição no número de conjuntos de seleção que você pode referenciar de uma exibição.
Em cada definição de uma exibição ou controle, o EntrySelectedBy elemento define quais objetos são exibidos usando essa definição. Normalmente, uma exibição ou controle tem apenas uma definição para que os objetos sejam definidos pelo ViewSelectedBy elemento . O EntrySelectedBy elemento da definição tem um elemento filho SelectionSetName que especifica o conjunto de seleção. Se você especificar o conjunto de seleção para uma definição, não poderá especificar nenhum dos outros elementos filho do EntrySelectedBy elemento.
Em cada definição de uma exibição ou controle, o elemento pode ser usado para especificar SelectionCondition uma condição para quando a definição é usada. O SelectionCondition elemento tem um elemento filho que especifica o conjunto de seleção que dispara a SelectionSetName condição. A condição é disparada quando qualquer um dos objetos definidos no conjunto de seleção é exibido. Para obter mais informações sobre como definir essas condições, consulte Definindo condições para quando os dados são exibidos.

Exemplo de conjunto de seleção

O exemplo a seguir mostra um conjunto de seleção que é retirado diretamente do arquivo FileSystem de formatação fornecido pelo Windows PowerShell. Para obter mais informações sobre outros Windows PowerShell de formatação, consulte arquivos Windows PowerShell formatação.

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

O conjunto de seleção anterior é referenciado no ViewSelectedBy elemento de uma exibição de tabela.

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

Elementos XML

Não há nenhum limite para o número de conjuntos de seleção que você pode definir. Os elementos XML a seguir são usados para criar um conjunto de seleção.

O elemento SelectionSets define os conjuntos de objetos .NET referenciados pelas exibições e controles do arquivo de formatação.
O elemento SelectionSet define um único conjunto de objetos .NET.
O elemento Name especifica o nome usado para referenciar o conjunto de seleção.
O elemento Types especifica os tipos .NET dos objetos do conjunto de seleção. (Em arquivos de formatação, os objetos são especificados pelo tipo .NET.)

Os elementos XML a seguir são usados para especificar um conjunto de seleção.

O elemento a seguir especifica o conjunto de seleção a ser usado em todas as definições da exibição:
- Elemento SelectionSetName para ViewSelectedBy (formato)
- Elemento SelectionSetName para EntrySelectedBy para GroupBy (formato)
Os seguintes elementos especificam o conjunto de seleção usado por uma única definição de exibição:
Os seguintes elementos especificam o conjunto de seleção usado por definições de controle comuns e de exibição:
- Elemento SelectionSetName para EntrySelectedBy para Controls para View (formato)
- Elemento SelectionSetName para EntrySelectedBy para Controls para Configuration (formato)
Os seguintes elementos especificam o conjunto de seleção usado quando você define qual objeto expandir:
- Elemento SelectionSetName para EntrySelectedBy para EnumerableExpansion (formato)
Os elementos a seguir especificam o conjunto de seleção usado pelas condições de seleção.

Consulte Também

Arquivos de formatação do PowerShell

Definindo condições para quando os dados são exibidos

Escrevendo um arquivo de formatação e tipos do PowerShell

Last updated on 2021-09-24