Определение наборов выделенных фрагментов

2021-09-24

При создании нескольких представлений и элементов управления можно определить наборы объектов, которые называются наборами выбора. Набор выбора позволяет определять объекты один раз без необходимости их многократного определения для каждого представления или элемента управления. Обычно наборы выбора используются при наличии набора связанных объектов .NET. Например, FileSystem файл форматирования (FileSystem. Format. ps1xml) определяет набор типов файловой системы, используемых несколькими представлениями.

Где определяются и указываются наборы выбора

Наборы выбора определяются как часть общих данных, которые могут использоваться всеми представлениями и элементами управления, определенными в файле форматирования. В следующем примере показано, как определить три набора выбора.

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

Ссылаться на наборы выбора можно следующими способами.

Каждое представление содержит ViewSelectedBy элемент, который определяет, какие объекты отображаются с помощью представления. ViewSelectedByЭлемент имеет SelectionSetName дочерний элемент, указывающий набор выбора, который используется всеми определениями представления. На количество наборов выбора, на которые можно ссылаться из представления, нет ограничений.
В каждом определении представления или элемента управления EntrySelectedBy элемент определяет, какие объекты отображаются с помощью этого определения. Как правило, представление или элемент управления имеет только одно определение, поэтому объекты определяются ViewSelectedBy элементом. EntrySelectedByЭлемент определения содержит SelectionSetName дочерний элемент, указывающий набор выбора. При указании набора, выбранного для определения, нельзя указать какие-либо другие дочерние элементы EntrySelectedBy элемента.
В каждом определении представления или элемента управления SelectionCondition элемент можно использовать для указания условия использования определения. SelectionConditionЭлемент имеет SelectionSetName дочерний элемент, указывающий набор выбора, который запускает условие. Условие активируется при отображении любого из объектов, определенных в наборе выбора. Дополнительные сведения о настройке этих условий см. в разделе Определение условий для отображения данных.

Пример набора выбора

В следующем примере показан набор выбора, который берется непосредственно из FileSystem файла форматирования, предоставленного Windows PowerShell. дополнительные сведения о других файлах форматирования Windows PowerShell см. в разделе Windows PowerShell файлы форматирования.

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

В элементе табличного представления имеется ссылка на предыдущий набор элементов ViewSelectedBy .

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

Элементы XML

Количество наборов выбора, которые можно определить, не ограничено. Для создания набора выбора используются следующие XML-элементы.

Элемент селектионсетс определяет наборы объектов .NET, на которые ссылаются представления и элементы управления файла форматирования.
Элемент Selection определяет один набор объектов .NET.
Элемент Name указывает имя, используемое для ссылки на набор выбора.
Элемент types указывает типы .NET объектов набора выбора. (В файлах форматирования объекты задаются типом .NET.)

Для указания набора выбора используются следующие XML-элементы.