Defining Selection Sets (Eliminar Conjuntos de Seleção)

Artigo
09/24/2021

Ao criar várias vistas e controlos, pode definir conjuntos de objetos que são referidos como conjuntos de seleção. Um conjunto de seleção permite-lhe definir os objetos uma vez, sem ter que defini-los repetidamente para cada vista ou controlo. Normalmente, os conjuntos de seleção são usados quando você tem um conjunto de objetos relacionados .NET. Por exemplo, o FileSystem ficheiro de formatação (FileSystem.format.ps1xml) define um conjunto de seleção dos tipos de sistema de ficheiros que utilizam várias visualizações.

Onde os conjuntos de seleção são definidos e referenciados

Define os conjuntos de seleção como parte dos dados comuns que podem ser utilizados por todas as vistas e controlos definidos no ficheiro 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>

Pode fazer referência a um conjunto de seleção das seguintes formas:

Cada vista tem um ViewSelectedBy elemento que define quais os objetos que são exibidos utilizando a vista. O ViewSelectedBy elemento tem um elemento infantil que especifica o conjunto de SelectionSetName seleção que todas as definições da utilização da vista. Não existe qualquer restrição ao número de conjuntos de seleção que possa fazer referência a partir de uma vista.
Em cada definição de uma vista ou controlo, o EntrySelectedBy elemento define quais os objetos que são exibidos utilizando essa definição. Tipicamente, uma vista ou controlo tem apenas uma definição para que os objetos sejam definidos pelo ViewSelectedBy elemento. O EntrySelectedBy elemento da definição tem um elemento infantil SelectionSetName que especifica o conjunto de seleção. Se especificar o conjunto de seleção para uma definição, não pode especificar nenhum dos outros elementos do EntrySelectedBy elemento.
Em cada definição de uma vista ou controlo, o SelectionCondition elemento pode ser usado para especificar uma condição para quando a definição é usada. O SelectionCondition elemento tem um elemento infantil que especifica o conjunto de SelectionSetName seleção que desencadeia a circunstância. A condição é ativada quando qualquer um dos objetos definidos no conjunto de seleção é apresentado. Para obter mais informações sobre como definir estas condições, consulte as condições de definição para quando os dados são apresentados.

Exemplo de conjunto de seleção

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

<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 vista de mesa.

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

Elementos XML

Não há limite para o número de conjuntos de seleção que pode definir. Os seguintes elementos XML são utilizados para criar um conjunto de seleção.

O elemento SelectionSets define os conjuntos de objetos .NET que são referenciados pelas vistas e controlos do ficheiro formatação.
O elemento SelectionSet define um único conjunto de objetos .NET.
O elemento Nome especifica o nome que é utilizado para fazer referência ao conjunto de seleção.
O elemento Tipos especifica os tipos .NET dos objetos do conjunto de seleção. (Dentro dos ficheiros de formatação, os objetos são especificados pelo seu tipo .NET.)

Os seguintes elementos XML são utilizados para especificar um conjunto de seleção.