Definiera valuppsättningar

När du skapar flera vyer och kontroller kan du definiera uppsättningar med objekt som kallas urvalsuppsättningar. Med en urvalsuppsättning kan du definiera objekten en gång, utan att behöva definiera dem upprepade gånger för varje vy eller kontroll. Normalt används urvalsuppsättningar när du har en uppsättning relaterade .NET-objekt. Formateringsfilen (FileSystem.format.ps1xml) definierar till exempel en urvalsuppsättning av de FileSystem filsystemtyper som används i flera vyer.

Var urvalsuppsättningar definieras och refereras

Du definierar urvalsuppsättningar som en del av gemensamma data som kan användas av alla vyer och kontroller som definieras i formateringsfilen. I följande exempel visas hur du definierar tre urvalsuppsättningar.

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

Du kan referera till en urvalsuppsättningar på följande sätt:

• Varje vy har ett ViewSelectedBy -element som definierar vilka objekt som visas med hjälp av vyn. Elementet ViewSelectedBy har ett SelectionSetName underställt element som anger den urvalsuppsättning som alla definitioner av vyn använder. Det finns ingen begränsning för antalet urvalsuppsättningar som du kan referera till från en vy.

• I varje definition av en vy eller kontroll EntrySelectedBy definierar elementet vilka objekt som visas med hjälp av den definitionen. Normalt har en vy eller kontroll bara en definition, så objekten definieras av ViewSelectedBy elementet . Elementet EntrySelectedBy i definitionen har ett SelectionSetName underställt element som anger urvalsuppsättningen. Om du anger urvalsuppsättningen för en definition kan du inte ange något av de andra underordnade elementen i EntrySelectedBy elementet.

• I varje definition av en vy eller kontroll SelectionCondition kan elementet användas för att ange ett villkor för när definitionen används. Elementet SelectionCondition har ett SelectionSetName underställt element som anger den urvalsuppsättning som utlöser villkoret. Villkoret utlöses när något av de objekt som definierats i urvalsuppsättningen visas. Mer information om hur du anger dessa villkor finns i Definiera villkor för när data visas.

Exempel på urvalsuppsättning

I följande exempel visas en urvalsuppsättning som tas direkt från FileSystem formateringsfilen som tillhandahålls av Windows PowerShell. Mer information om andra Windows PowerShell formateringsfiler finns i Windows PowerShell formateringsfiler.

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

Föregående urvalsuppsättning refereras till i ViewSelectedBy elementet i en tabellvy.

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

XML-element

Det finns ingen gräns för hur många urvalsuppsättningar som du kan definiera. Följande XML-element används för att skapa en urvalsuppsättning.

• Elementet SelectionSets definierar de uppsättningar av .NET-objekt som refereras till av vyer och kontroller i formateringsfilen.

• Elementet SelectionSet definierar en enskild uppsättning .NET-objekt.

• Elementet Name anger det namn som används för att referera till urvalsuppsättningen.

• Elementet Types anger .NET-typerna för objekten i urvalsuppsättningen. (I formateringsfiler anges objekt efter .NET-typ.)

Följande XML-element används för att ange en urvalsuppsättning.

• Följande element anger den urvalsuppsättning som ska användas i alla definitioner av vyn:

  • SelectionSetName-element för ViewSelectedBy (format)

  • SelectionSetName-element för EntrySelectedBy för GroupBy (format)

• Följande element anger den urvalsuppsättning som används av en enda vydefinition:

  • SelectionSetName-element för EntrySelectedBy för ListControl (format)

  • SelectionSetName-element för EntrySelectedBy för TableControl (format)

  • SelectionSetName-element för EntrySelectedBy för WideControl (format)

  • SelectionSetName-element för EntrySelectedBy för CustomControl för View (format)

• Följande element anger den urvalsuppsättning som används av vanliga definitioner och visa kontrolldefinitioner:

  • SelectionSetName-element för EntrySelectedBy för Controls för View (format)

  • SelectionSetName-element för EntrySelectedBy för Controls för Configuration (format)

• Följande element anger den urvalsuppsättning som används när du definierar vilket objekt som ska expanderas:

  • SelectionSetName-element för EntrySelectedBy för EnumerableExpansion (format)

• Följande element anger den urvalsuppsättning som används av urvalsvillkor.

  • SelectionSetName-element för SelectionCondition för Controls för Configuration (format)

  • SelectionSetName-element för SelectionCondition för Controls för View (format)

  • SelectionSetName-element för SelectionCondition för CustomControl för View (format)

  • SelectionSetName-element för SelectionCondition för EntrySelectedBy för EnumerableExpansion (format)

  • SelectionSetName-element för SelectionCondition för EntrySelectedBy för ListEntry (format)

  • SelectionSetName-element för SelectionCondition för EntrySelectedBy för TableControl (format)

  • SelectionSetName-element för SelectionCondition för EntrySelectedBy för WideEntry (format)

  • SelectionSetName-element för SelectionCondition för GroupBy (format)

Se även

SelectionSets

SelectionSet

Namn

Typer

PowerShell-formateringsfiler

Definiera villkor för när data ska visas

Skriva en PowerShell-fil för formatering och typer