Widok listy (GroupBy)List View (GroupBy)

Ten przykład pokazuje, jak zaimplementować widok listy oddzielający wiersze listy do grup.This example shows how to implement a list view that separates the rows of the list into groups. Ten widok listy wyświetla właściwości System. ServiceProcess. ServiceController? DisplayProperty = FullName obiekty zwrócone przez polecenie cmdlet Get-Service .This list view displays the properties of the System.Serviceprocess.Servicecontroller?Displayproperty=Fullname objects returned by the Get-Service cmdlet. Aby uzyskać więcej informacji na temat składników widoku listy, zobacz Tworzenie widoku listy.For more information about the components of a list view, see Creating a List View.

Aby załadować ten plik formatowaniaTo load this formatting file

  1. Skopiuj plik XML z przykładowej sekcji tego tematu do pliku tekstowego.Copy the XML from the Example section of this topic into a text file.

  2. Zapisz plik tekstowy.Save the text file. Pamiętaj o dodaniu format.ps1xml rozszerzenia do pliku, aby zidentyfikować go jako plik formatowania.Be sure to add the format.ps1xml extension to the file to identify it as a formatting file.

  3. Otwórz program Windows PowerShell i uruchom następujące polecenie, aby załadować plik formatowania do bieżącej sesji: 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.

    Ostrzeżenie

    Ten plik formatowania definiuje sposób wyświetlania obiektu, który jest już zdefiniowany przez plik formatowania programu Windows PowerShell.This formatting file defines the display of an object that is already defined by a Windows PowerShell formatting file. Należy użyć prependPath parametru podczas uruchamiania polecenia cmdlet i nie można załadować tego pliku formatowania jako modułu.You must use the prependPath parameter when you run the cmdlet, and you cannot load this formatting file as a module.

DemonstracjeDemonstrates

Ten plik formatowania ilustruje następujące elementy XML:This formatting file demonstrates the following XML elements:

  • Nazwa elementu widoku.The Name element for the view.

  • Element ViewSelectedBy , który określa, jakie obiekty są wyświetlane w widoku.The ViewSelectedBy element that defines what objects are displayed by the view.

  • Element GroupBy , który definiuje sposób wyświetlania nowej grupy obiektów.The GroupBy element that defines how a new group of objects is displayed.

  • Element ListControl zostanie zmieniona , który definiuje właściwość, która jest wyświetlana w widoku.The ListControl element that defines what property is displayed by the view.

  • Element ListItem , który definiuje elementy wyświetlane w wierszu widoku listy.The ListItem element that defines what is displayed in a row of the list view.

  • Element PropertyName , który definiuje właściwość, która jest wyświetlana.The PropertyName element that defines which property is displayed.

PrzykładExample

Poniższy kod XML definiuje widok listy, który uruchamia nową grupę za każdym razem, gdy wartość właściwości System. ServiceProcess. ServiceController. status jest zmieniana.The following XML defines a list view that starts a new group whenever the value of the System.Serviceprocess.Servicecontroller.Status property changes. Po rozpoczęciu każdej grupy jest wyświetlana etykieta niestandardowa, która zawiera nową wartość właściwości.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>

Poniższy przykład pokazuje, jak program Windows PowerShell wyświetla System. ServiceProcess. ServiceController? DisplayProperty = FullName obiekty po załadowaniu tego pliku formatu.The following example shows how Windows PowerShell displays the System.Serviceprocess.Servicecontroller?Displayproperty=Fullname objects after this format file is loaded. Puste wiersze dodane przed i po etykiecie grupy są automatycznie dodawane przez program Windows PowerShell.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

Zobacz teżSee Also

Przykłady plików formatującychExamples of Formatting Files

Pisanie pliku formatującego programu PowerShellWriting a PowerShell Formatting File