Udostępnij za pośrednictwem

Tworzenie widoku listy

  • Artykuł

Widok listy wyświetla dane w jednej kolumnie (w kolejności sekwencyjnej). Dane wyświetlane na liście mogą być wartością właściwości .NET lub wartością skryptu.

Wyświetlanie widoku listy

Poniższe dane wyjściowe pokazują, jak program Windows PowerShell wyświetla właściwości System.ServiceProcess.ServiceControl ler obiektów zwracanych przez polecenie cmdlet Get-Service. W tym przykładzie zostały zwrócone trzy obiekty, z których każdy obiekt jest oddzielony od poprzedniego obiektu pustym wierszem.

Get-Service | Format-List

Name                : AEADIFilters
DisplayName         : Andrea ADI Filters Service
Status              : Running
DependentServices   : {}
ServicesDependedOn  : {}
CanPauseAndContinue : False
CanShutdown         : False
CanStop             : True
ServiceType         : Win32OwnProcess

Name                : AeLookupSvc
DisplayName         : Application Experience
Status              : Running
DependentServices   : {}
ServicesDependedOn  : {}
CanPauseAndContinue : False
CanShutdown         : False
CanStop             : True
ServiceType         : Win32ShareProcess

Name                : AgereModemAudio
DisplayName         : Agere Modem Call Progress Audio
Status              : Running
DependentServices   : {}
ServicesDependedOn  : {}
CanPauseAndContinue : False
CanShutdown         : False
CanStop             : True
ServiceType         : Win32OwnProcess
...

Definiowanie widoku listy

Poniższy kod XML przedstawia schemat widoku listy służący do wyświetlania kilku właściwości obiektu System.ServiceProcess.ServiceController. Należy określić każdą właściwość, która ma być wyświetlana w widoku listy.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <TypeName>System.ServiceProcess.ServiceController</TypeName>
  </ViewSelectedBy>
  <ListControl>
    <ListEntries>
      <ListEntry>
        <ListItems>
          <ListItem>
            <PropertyName>Name</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>DisplayName</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>Status</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>ServiceType</PropertyName>
          </ListItem>
        </ListItems>
      </ListEntry>
    </ListEntries>
  </ListControl>
</View>

Następujące elementy XML służą do definiowania widoku listy:

  • Element View jest elementem nadrzędnym widoku listy. (Jest to ten sam element nadrzędny dla tabel, szerokich i niestandardowych widoków kontrolek).

  • Element Nazwa określa nazwę widoku. Ten element jest wymagany dla wszystkich widoków.

  • Element ViewSelectedBy definiuje obiekty korzystające z widoku. Ten element jest wymagany.

  • Element GroupBy określa, kiedy zostanie wyświetlona nowa grupa obiektów. Nowa grupa jest uruchamiana za każdym razem, gdy wartość określonej właściwości lub skryptu ulegnie zmianie. Ten element jest opcjonalny.

  • Element Controls definiuje kontrolki niestandardowe zdefiniowane przez widok listy. Kontrolki umożliwiają dalsze określanie sposobu wyświetlania danych. Ten element jest opcjonalny. Widok może definiować własne kontrolki niestandardowe lub używać typowych kontrolek, które mogą być używane przez dowolny widok w pliku formatowania. Aby uzyskać więcej informacji na temat kontrolek niestandardowych, zobacz Creating Custom Controls.

  • Element ListControl definiuje, co jest wyświetlane w widoku i jak jest sformatowany. Podobnie jak w przypadku wszystkich innych widoków, widok listy może wyświetlać wartości właściwości obiektu lub wartości generowane przez skrypt.

Aby zapoznać się z przykładem kompletnego pliku formatowania definiującego prosty widok listy, zobacz Widok listy (podstawowy).

Podawanie definicji widoku listy

Widoki listy mogą udostępniać co najmniej jedną definicję przy użyciu elementów podrzędnych ListControl. Zazwyczaj widok będzie miał tylko jedną definicję. W poniższym przykładzie widok zawiera jedną definicję, która wyświetla kilka właściwości obiektu System.Diagnostics.Process. Widok listy może wyświetlać wartość właściwości lub wartość skryptu (nie pokazano w przykładzie).

<ListControl>
    <ListEntries>
      <ListEntry>
        <ListItems>
          <ListItem>
            <PropertyName>Name</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>DisplayName</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>Status</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>ServiceType</PropertyName>
          </ListItem>
        </ListItems>
      </ListEntry>
    </ListEntries>
  </ListControl>

Następujące elementy XML mogą służyć do udostępniania definicji widoku listy:

  • Element ListControl i jego elementy podrzędne definiują, co jest wyświetlane w widoku.

  • Element ListEntries zawiera definicje widoku. W większości przypadków widok będzie miał tylko jedną definicję. Ten element jest wymagany.

  • Element ListEntry zawiera definicję widoku. Wymagana jest co najmniej jedna ListEntry; nie ma jednak maksymalnego limitu liczby elementów, które można dodać. W większości przypadków widok będzie miał tylko jedną definicję.

  • Element EntrySelectedBy określa obiekty wyświetlane według określonej definicji. Ten element jest opcjonalny i jest potrzebny tylko podczas definiowania wielu elementów ListEntry, które wyświetlają różne obiekty.

  • Element ListItems określa właściwości i skrypty, których wartości są wyświetlane w wierszach widoku listy.

  • Element ListItem określa właściwość lub skrypt, którego wartość jest wyświetlana w wierszu widoku listy. Widok listy musi określać co najmniej jedną właściwość lub skrypt. Nie ma maksymalnego limitu liczby wierszy, które można określić.

  • Element PropertyName określa właściwość, której wartość jest wyświetlana w wierszu. Należy określić właściwość lub skrypt, ale nie można określić obu tych właściwości.

  • Element ScriptBlock określa skrypt, którego wartość jest wyświetlana w wierszu. Należy określić skrypt lub właściwość, ale nie można określić obu.

  • Element Label określa etykietę wyświetlaną po lewej stronie właściwości lub wartości skryptu w wierszu. Ten element jest opcjonalny. Jeśli etykieta nie zostanie określona, zostanie wyświetlona nazwa właściwości lub skryptu. Aby uzyskać pełny przykład, zobacz Widok listy (etykiety).

  • Element ItemSelectionCondition określa warunek, który musi istnieć, aby wiersz był wyświetlany. Aby uzyskać więcej informacji na temat dodawania warunków do widoku listy, zobacz Definiowanie warunków wyświetlania danych. Ten element jest opcjonalny.

  • Element FormatString określa wzorzec używany do wyświetlania wartości właściwości lub skryptu. Ten element jest opcjonalny.

Aby zapoznać się z przykładem kompletnego pliku formatowania definiującego prosty widok listy, zobacz Widok listy (podstawowy).

Definiowanie obiektów korzystających z widoku listy

Istnieją dwa sposoby definiowania, które obiekty platformy .NET używają widoku listy. Za pomocą elementu ViewSelectedBy można zdefiniować obiekty, które mogą być wyświetlane przez wszystkie definicje widoku, lub użyć elementu EntrySelectedBy do zdefiniowania obiektów wyświetlanych przez określoną definicję widoku. W większości przypadków widok ma tylko jedną definicję, dlatego obiekty są zwykle definiowane przez element ViewSelectedBy.

W poniższym przykładzie pokazano, jak zdefiniować obiekty wyświetlane w widoku listy przy użyciu elementów ViewSelectedBy i TypeName. Nie ma limitu liczby TypeName elementów, które można określić, a ich kolejność nie jest znacząca.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <TypeName>System.Diagnostics.Process</TypeName>
  </ViewSelectedBy>
  <ListControl>...</ListControl>
</View>

Następujące elementy XML mogą służyć do określania obiektów używanych przez widok listy:

  • Element ViewSelectedBy definiuje, które obiekty są wyświetlane przez widok listy.

  • Element TypeName określa obiekt platformy .NET wyświetlany przez widok. Wymagana jest w pełni kwalifikowana nazwa typu .NET. Musisz określić co najmniej jeden typ lub zestaw zaznaczeń dla widoku, ale nie ma maksymalnej liczby elementów, które można określić.

Aby zapoznać się z przykładem kompletnego pliku formatowania, zobacz Widok listy (podstawowy).

W poniższym przykładzie użyto elementów ViewSelectedBy i SelectionSetName. Użyj zestawów wyboru, w których masz powiązany zestaw obiektów wyświetlanych przy użyciu wielu widoków, takich jak podczas definiowania widoku listy i widoku tabeli dla tych samych obiektów. Aby uzyskać więcej informacji na temat tworzenia zestawu wyboru, zobacz Definiowanie zestawów wyboru.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <SelectionSetName>.NET Type Set</SelectionSetName>
  </ViewSelectedBy>
  <ListControl>...</ListControl>
</View>

Następujące elementy XML mogą służyć do określania obiektów używanych przez widok listy:

  • Element ViewSelectedBy definiuje, które obiekty są wyświetlane przez widok listy.

  • Element SelectionSetName określa zestaw obiektów, które mogą być wyświetlane przez widok. Należy określić co najmniej jeden zestaw zaznaczenia lub typ widoku, ale nie ma maksymalnej liczby elementów, które można określić.

W poniższym przykładzie pokazano, jak zdefiniować obiekty wyświetlane według określonej definicji widoku listy przy użyciu elementu EntrySelectedBy. Za pomocą tego elementu można określić nazwę typu platformy .NET obiektu, zestaw zaznaczenia obiektów lub warunek wyboru, który określa, kiedy definicja jest używana. Aby uzyskać więcej informacji na temat tworzenia warunków wyboru, zobacz Definiowanie warunków wyświetlania danych.

<ListEntry>
  <EntrySelectedBy>
    <TypeName>.NET Type</TypeName>
  </EntrySelectedBy>
</ListEntry>

Następujące elementy XML mogą służyć do określania obiektów używanych przez określoną definicję widoku listy:

  • Element EntrySelectedBy definiuje, które obiekty są wyświetlane według definicji.

  • Element TypeName określa obiekt .NET wyświetlany przez definicję. W przypadku korzystania z tego elementu wymagana jest w pełni kwalifikowana nazwa typu .NET. Musisz określić co najmniej jeden typ, zestaw zaznaczenia lub warunek wyboru dla definicji, ale nie ma maksymalnej liczby elementów, które można określić.

  • Element SelectionSetName (nie pokazano) określa zestaw obiektów, które mogą być wyświetlane przez tę definicję. Musisz określić co najmniej jeden typ, zestaw zaznaczenia lub warunek wyboru dla definicji, ale nie ma maksymalnej liczby elementów, które można określić.

  • Element SelectionCondition (nie pokazany) określa warunek, który musi istnieć, aby ta definicja była używana. Musisz określić co najmniej jeden typ, zestaw zaznaczenia lub warunek wyboru dla definicji, ale nie ma maksymalnej liczby elementów, które można określić. Aby uzyskać więcej informacji na temat definiowania warunków wyboru, zobacz Definiowanie warunków wyświetlania danych.

Wyświetlanie grup obiektów w widoku listy

Obiekty wyświetlane w widoku listy można rozdzielić na grupy. Nie oznacza to, że definiujesz grupę, tylko że program Windows PowerShell uruchamia nową grupę za każdym razem, gdy wartość określonej właściwości lub skryptu ulegnie zmianie. W poniższym przykładzie nowa grupa jest uruchamiana za każdym razem, gdy zmienia się wartość właściwości System.ServiceProcess.ServiceController.ServiceType.

<GroupBy>
  <Label>Service Type</Label>
  <PropertyName>ServiceType</PropertyName>
</GroupBy>

Następujące elementy XML są używane do definiowania, kiedy grupa jest uruchomiona:

  • Element GroupBy definiuje właściwość lub skrypt, który uruchamia nową grupę i definiuje sposób wyświetlania grupy.

  • Element PropertyName określa właściwość uruchamiającą nową grupę za każdym razem, gdy zmienia się jego wartość. Musisz określić właściwość lub skrypt, aby uruchomić grupę, ale nie można określić obu tych elementów.

  • Element ScriptBlock określa skrypt, który uruchamia nową grupę za każdym razem, gdy zmienia się jego wartość. Należy określić skrypt lub właściwość, aby uruchomić grupę, ale nie można określić obu tych elementów.

  • Element Label definiuje etykietę wyświetlaną na początku każdej grupy. Oprócz tekstu określonego przez ten element program Windows PowerShell wyświetla wartość, która wyzwoliła nową grupę i dodaje pusty wiersz przed etykietą i po nim. Ten element jest opcjonalny.

  • Element CustomControl definiuje kontrolkę używaną do wyświetlania danych. Ten element jest opcjonalny.

  • Element CustomControlName określa wspólną kontrolkę lub widok służącą do wyświetlania danych. Ten element jest opcjonalny.

Aby zapoznać się z przykładem kompletnego pliku formatowania definiującego grupy, zobacz Widok listy (GroupBy).

Używanie ciągów formatu

Ciągi formatowania można dodać do widoku, aby dokładniej zdefiniować sposób wyświetlania danych. W poniższym przykładzie pokazano, jak zdefiniować ciąg formatowania dla wartości właściwości StartTime.

<ListItem>
  <PropertyName>StartTime</PropertyName>
  <FormatString>{0:MMM} {0:DD} {0:HH}:{0:MM}</FormatString>
</ListItem>

Następujące elementy XML mogą służyć do określania wzorca formatu:

  • Element ListItem określa dane wyświetlane przez widok.

  • Element PropertyName określa właściwość, której wartość jest wyświetlana przez widok. Należy określić właściwość lub skrypt, ale nie można określić obu tych właściwości.

  • Element FormatString określa wzorzec formatu definiujący sposób wyświetlania wartości właściwości lub skryptu w widoku.

  • Element ScriptBlock (nie pokazany) określa skrypt, którego wartość jest wyświetlana przez widok. Należy określić skrypt lub właściwość, ale nie można określić obu.

W poniższym przykładzie metoda ToString jest wywoływana w celu sformatowania wartości skryptu. Skrypty mogą wywoływać dowolną metodę obiektu. W związku z tym jeśli obiekt ma metodę, taką jak ToString, która ma parametry formatowania, skrypt może wywołać tę metodę, aby sformatować wartość wyjściową skryptu.

<ListItem>
  <ScriptBlock>
    [string]::Format("{0,-10} {1,-8}", $_.LastWriteTime.ToString("d"), $_.LastWriteTime.ToString("t"))
  </ScriptBlock>
</ListItem>

Do wywoływania metody ToString można użyć następującego elementu XML:

  • Element ListItem określa dane wyświetlane przez widok.

  • Element ScriptBlock (nie pokazany) określa skrypt, którego wartość jest wyświetlana przez widok. Należy określić skrypt lub właściwość, ale nie można określić obu.

Zobacz też

pisanie polecenia cmdlet programu Windows PowerShell