Listanézet (GroupBy)List View (GroupBy)

Ebből a példából megtudhatja, hogyan implementálhat egy olyan listanézet-nézetet, amely elválasztja a lista sorait csoportokba.This example shows how to implement a list view that separates the rows of the list into groups. Ez a listanézet a System. Serviceprocess. ServiceController tulajdonságait jeleníti meg? Displayproperty = a Get-Service parancsmag által visszaadott FullName objektumok.This list view displays the properties of the System.Serviceprocess.Servicecontroller?Displayproperty=Fullname objects returned by the Get-Service cmdlet. A listanézet összetevőivel kapcsolatos további információkért tekintse meg a listanézet létrehozásacímű témakört.For more information about the components of a list view, see Creating a List View.

A formázási fájl betöltéseTo load this formatting file

  1. Másolja az XML-t a témakör példa részéből egy szövegfájlba.Copy the XML from the Example section of this topic into a text file.

  2. Mentse a szövegfájlt.Save the text file. Ügyeljen arra, hogy a format.ps1xml kiterjesztést a fájlhoz adja, hogy az azonosítsa a fájlt formázó fájlként.Be sure to add the format.ps1xml extension to the file to identify it as a formatting file.

  3. Nyissa meg a Windows PowerShellt, és futtassa a következő parancsot a formázó fájl aktuális munkamenetbe való betöltéséhez: Update-formatdata -prependpath PathToFormattingFile .Open Windows PowerShell, and run the following command to load the formatting file into the current session: Update-formatdata -prependpath PathToFormattingFile.

    Figyelmeztetés

    Ez a formázó fájl egy olyan objektum megjelenítését határozza meg, amelyet egy Windows PowerShell-formázó fájl már definiált.This formatting file defines the display of an object that is already defined by a Windows PowerShell formatting file. A (z prependPath ) paramétert a parancsmag futtatásakor kell használnia, és nem tudja betölteni a formázó fájlt modulként.You must use the prependPath parameter when you run the cmdlet, and you cannot load this formatting file as a module.

Útmutató ehhez:Demonstrates

Ez a formázó fájl a következő XML-elemeket mutatja be:This formatting file demonstrates the following XML elements:

  • A nézet Name eleme.The Name element for the view.

  • Az ViewSelectedBy elem, amely meghatározza, hogy a nézet milyen objektumokat jelenít meg.The ViewSelectedBy element that defines what objects are displayed by the view.

  • A GroupBy elem, amely meghatározza az objektumok új csoportjának megjelenítését.The GroupBy element that defines how a new group of objects is displayed.

  • Az a ListControl elem, amely meghatározza, hogy a nézet milyen tulajdonságot jelenít meg.The ListControl element that defines what property is displayed by the view.

  • A listaelem elem, amely meghatározza, hogy mi jelenjen meg a listanézet egy sorában.The ListItem element that defines what is displayed in a row of the list view.

  • A PropertyName elem, amely meghatározza, hogy melyik tulajdonság jelenik meg.The PropertyName element that defines which property is displayed.

PéldaExample

A következő XML-lista egy új csoportot indít el, amikor a System. Serviceprocess. ServiceController. status tulajdonság értéke megváltozik.The following XML defines a list view that starts a new group whenever the value of the System.Serviceprocess.Servicecontroller.Status property changes. Az egyes csoportok indításakor egy egyéni felirat jelenik meg, amely tartalmazza a tulajdonság új értékét.When each group is started, a custom label is displayed that includes the new value of the property.

<Configuration>
  <ViewDefinitions>
    <View>
      <Name>System.ServiceProcess.ServiceController</Name>
      <ViewSelectedBy>
        <TypeName>System.ServiceProcess.ServiceController</TypeName>
      </ViewSelectedBy>
      <GroupBy>
        <PropertyName>Status</PropertyName>
        <Label>New Service Status</Label>
      </GroupBy>
      <ListControl>
        <ListEntries>
          <ListEntry>
            <ListItems>
              <ListItem>
                <PropertyName>Name</PropertyName>
              </ListItem>
              <ListItem>
                <PropertyName>DisplayName</PropertyName>
              </ListItem>
              <ListItem>
                <PropertyName>ServiceType</PropertyName>
              </ListItem>
            </ListItems>
          </ListEntry>
        </ListEntries>
      </ListControl>
    </View>
  </ViewDefinitions>
</Configuration>

Az alábbi példa bemutatja, hogyan jeleníti meg a Windows PowerShell a System. Serviceprocess. ServiceController? Displayproperty = a formázott fájl betöltése után FullName objektumok.The following example shows how Windows PowerShell displays the System.Serviceprocess.Servicecontroller?Displayproperty=Fullname objects after this format file is loaded. A Windows PowerShell automatikusan hozzáadja a csoport címkéje előtt és után hozzáadott üres sorokat.The blank lines added before and after the group label are automatically added by Windows PowerShell.

Get-Service f*
   New Service Status: Stopped

Name        : Fax
DisplayName : Fax
ServiceType : Win32OwnProcess

   New Service Status: Running

Name        : FCSAM
DisplayName : Microsoft Antimalware Service
ServiceType : Win32OwnProcess

   New Service Status: Stopped

Name        : fdPHost
DisplayName : Function Discovery Provider Host
ServiceType : Win32ShareProcess

   New Service Status: Running

Name        : FDResPub
DisplayName : Function Discovery Resource Publication
ServiceType : Win32ShareProcess

Name        : FontCache
DisplayName : Windows Font Cache Service
ServiceType : Win32ShareProcess

   New Service Status: Stopped

Name        : FontCache3.0.0.0
DisplayName : Windows Presentation Foundation Font Cache 3.0.0.0
ServiceType : Win32OwnProcess

   New Service Status: Running

Name        : FSysAgent
DisplayName : Microsoft Forefront System Agent
ServiceType : Win32OwnProcess

Name        : FwcAgent
DisplayName : Firewall Client Agent
ServiceType : Win32OwnProcess

Lásd még:See Also

Formázási fájlok példáiExamples of Formatting Files

PowerShelles formázási fájl írásaWriting a PowerShell Formatting File