Omówienie plików formatującychFormatting File Overview

Format wyświetlania obiektów, które są zwracane przez polecenia (polecenia cmdlet, funkcje i skrypty), jest definiowany przy użyciu plików formatowania (format.ps1plików XML).The display format for the objects that are returned by commands (cmdlets, functions, and scripts) are defined by using formatting files (format.ps1xml files). Niektóre z tych plików są udostępniane przez program PowerShell w celu zdefiniowania formatu wyświetlania tych obiektów zwracanych przez polecenia dostarczone przez program PowerShell, takich jak obiekt System. Diagnostics. Process zwrócony przez Get-Process polecenie cmdlet.Several of these files are provided by PowerShell to define the display format for those objects returned by PowerShell-provided commands, such as the System.Diagnostics.Process object returned by the Get-Process cmdlet. Można jednak również utworzyć własne niestandardowe pliki formatowania, aby zastąpić domyślne formaty wyświetlania, lub napisać niestandardowy plik formatowania w celu zdefiniowania wyświetlania obiektów zwracanych przez własne polecenia.However, you can also create your own custom formatting files to overwrite the default display formats or you can write a custom formatting file to define the display of objects returned by your own commands.

Ważne

Formatowanie plików nie określa elementów obiektu, które są zwracane do potoku.Formatting files do not determine the elements of an object that are returned to the pipeline. Gdy obiekt jest zwracany do potoku, wszystkie elementy członkowskie tego obiektu są dostępne nawet wtedy, gdy nie są wyświetlane.When an object is returned to the pipeline, all members of that object are available even if some are not displayed.

Program PowerShell używa danych z tych plików formatowania, aby określić, co jest wyświetlane i jak są sformatowane wyświetlane dane.PowerShell uses the data in these formatting files to determine what is displayed and how the displayed data is formatted. Wyświetlane dane mogą zawierać właściwości obiektu lub wartości skryptu.The displayed data can include the properties of an object or the value of a script. Skrypty są używane, jeśli chcesz wyświetlić pewną wartość, która nie jest dostępna bezpośrednio z właściwości obiektu, na przykład dodając wartość dwóch właściwości obiektu, a następnie wyświetlając sumę jako element danych.Scripts are used if you want to display some value that is not available directly from the properties of an object, such as adding the value of two properties of an object and then displaying the sum as a piece of data. Formatowanie wyświetlanych danych odbywa się przez zdefiniowanie widoków dla obiektów, które mają być wyświetlane.Formatting of the displayed data is done by defining views for the objects that you want to display. Można zdefiniować pojedynczy widok dla każdego obiektu, można zdefiniować pojedynczy widok dla wielu obiektów lub zdefiniować wiele widoków dla tego samego obiektu.You can define a single view for each object, you can define a single view for multiple objects, or you can define multiple views for the same object. Nie ma żadnego limitu liczby widoków, które można zdefiniować.There is no limit to the number of views that you can define.

Typowe funkcje formatowania plikówCommon Features of Formatting Files

Każdy plik formatowania może definiować następujące składniki, które mogą być współużytkowane przez wszystkie widoki zdefiniowane przez ten plik:Each formatting file can define the following components that can be shared across all the views defined by the file:

  • Domyślne ustawienie konfiguracji, takie jak, czy dane wyświetlane w wierszach tabel będą wyświetlane w następnym wierszu, jeśli dane są dłuższe niż szerokość kolumny.Default configuration setting, such as whether the data displayed in the rows of tables will be displayed on the next line if the data is longer than the width of the column. Aby uzyskać więcej informacji na temat tych ustawień, zobacz Definiowanie wspólnych ustawień konfiguracji.For more information about these settings, see Defining Common Configuration Settings.

  • Zestawy obiektów, które mogą być wyświetlane w dowolnym z widoków pliku formatowania.Sets of objects that can be displayed by any of the views of the formatting file. Aby uzyskać więcej informacji o tych zestawach (nazywanych zestawami wyboru ), zobacz Definiowanie zestawów obiektów.For more information about these sets (referred to as selection sets ), see Defining Sets of Objects.

  • Typowe kontrolki, które mogą być używane przez wszystkie widoki pliku formatowania.Common controls that can be used by all the views of the formatting file. Formanty zapewniają dokładniejszą kontrolę nad sposobem wyświetlania danych.Controls give you finer control on how data is displayed. Aby uzyskać więcej informacji na temat kontrolek, zobacz Definiowanie formantów niestandardowych.For more information about controls, see Defining Custom Controls.

Widoki formatowaniaFormatting Views

Widoki formatowania mogą wyświetlać obiekty w formacie tabeli, formacie listy, formacie szerokim i formacie niestandardowym.Formatting views can display objects in a table format, list format, wide format, and custom format. W większości, każda definicja formatowania jest opisana przez zestaw tagów XML, które opisują widok.For the most part, each formatting definition is described by a set of XML tags that describe the view. Każdy widok zawiera nazwę widoku, obiekty korzystające z widoku oraz elementy widoku, takie jak informacje o kolumnie i wierszu widoku tabeli.Each view contains the name of the view, the objects that use the view, and the elements of the view, such as the column and row information for a table view.

Widok tabeli zawiera właściwości obiektu lub wartości bloku skryptu w co najmniej jednej kolumnie.Table View Lists the properties of an object or a script block value in one or more columns. Każda kolumna reprezentuje pojedynczą właściwość obiektu lub wartości skryptu.Each column represents a single property of the object or a script value. Można zdefiniować widok tabeli, który wyświetla wszystkie właściwości obiektu, podzbiór właściwości obiektu lub kombinację właściwości i wartości skryptu.You can define a table view that displays all the properties of an object, a subset of the properties of an object, or a combination of properties and script values. Każdy wiersz tabeli reprezentuje zwracany obiekt.Each row of the table represents a returned object. Tworzenie widoku tabeli jest bardzo podobne do po potoku obiektu do Format-Table polecenia cmdlet.Creating a table view is very similar to when you pipe an object to the Format-Table cmdlet. Aby uzyskać więcej informacji na temat tego widoku, zobacz Widok tabeli.For more information about this view, see Table View.

Widok listy wyświetla właściwości obiektu lub wartości skryptu w pojedynczej kolumnie.List View Lists the properties of an object or a script value in a single column. Każdy wiersz na liście wyświetla opcjonalną etykietę lub nazwę właściwości, po której następuje wartość właściwości lub skryptu.Each row of the list displays an optional label or the property name followed by the value of the property or script. Tworzenie widoku listy jest bardzo podobne do potoku obiektu do Format-List polecenia cmdlet.Creating a list view is very similar to piping an object to the Format-List cmdlet. Aby uzyskać więcej informacji na temat tego widoku, zobacz Widok listy.For more information about this view, see List View.

Widok szeroki powoduje wyświetlenie pojedynczej właściwości obiektu lub wartości skryptu w co najmniej jednej kolumnie.Wide View Lists a single property of an object or a script value in one or more columns. Brak etykiety lub nagłówka dla tego widoku.There is no label or header for this view. Tworzenie widoku szerokiego jest bardzo podobne do potoku obiektu do Format-Wide polecenia cmdlet.Creating a wide view is very similar to piping an object to the Format-Wide cmdlet. Aby uzyskać więcej informacji na temat tego widoku, zobacz szeroki widok.For more information about this view, see Wide View.

Widok niestandardowy wyświetla dostosowywalny widok właściwości obiektu lub wartości skryptów, które nie są zgodne ze sztywną strukturą widoków tabel, widoków list lub szerokich widoków.Custom View Displays a customizable view of object properties or script values that does not adhere to the rigid structure of table views, list views, or wide views. Można zdefiniować autonomiczny widok niestandardowy lub zdefiniować niestandardowy widok, który jest używany przez inny widok, taki jak widok tabeli lub widok listy.You can define a stand-alone custom view, or you can define a custom view that is used by another view, such as a table view or list view. Tworzenie widoku niestandardowego jest bardzo podobne do potoku obiektu do Format-Custom polecenia cmdlet.Creating a custom view is very similar to piping an object to the Format-Custom cmdlet. Aby uzyskać więcej informacji na temat tego widoku, zobacz widok niestandardowy.For more information about this view, see Custom View.

Składniki widokuComponents of a View

W poniższych przykładach XML przedstawiono podstawowe składniki XML widoku.The following XML examples show the basic XML components of a view. Poszczególne elementy XML różnią się w zależności od tego, który widok chcesz utworzyć, ale podstawowe składniki widoków są takie same.The individual XML elements vary depending on which view you want to create, but the basic components of the views are all the same.

Aby rozpocząć od, każdy widok ma Name element, który określa przyjazną nazwę użytkownika, która jest używana do odwoływania się do widoku.To start with, each view has a Name element that specifies a user friendly name that is used to reference the view. ViewSelectedByelement określający, które obiekty .NET są wyświetlane przez widok, i element kontrolny , który definiuje widok.a ViewSelectedBy element that defines which .NET objects are displayed by the view, and a control element that defines the view.

<ViewDefinitions>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <TableControl>...</TableControl>
  </View>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <ListControl>...</ListControl>
  <View>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <WideControl>...</WideControl>
  <View>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <CustomControl>...</CustomControl>
  </View>
</ViewDefinitions>

W elemencie Control można zdefiniować jeden lub więcej elementów wpisów .Within the control element, you can define one or more entry elements. W przypadku korzystania z wielu definicji należy określić, które obiekty .NET będą używać każdej definicji.If you use multiple definitions, you must specify which .NET objects use each definition. Zwykle tylko jeden wpis z tylko jedną definicją jest wymagany dla każdej kontrolki.Typically only one entry, with only one definition, is needed for each control.

<ListControl>
  <ListEntries>
    <ListEntry>
      <EntrySelectedBy>...</EntrySelectedBy>
      <ListItems>...</ListItems>
    <ListEntry>
    <ListEntry>
        <EntrySelectedBy>...</EntrySelectedBy>
      <ListItems>...</ListItems>
    <ListEntry>
    <ListEntry>
        <EntrySelectedBy>...</EntrySelectedBy>
      <ListItems>...</ListItems>
    <ListEntry>
  </ListEntries>
</ListControl>

W każdym elemencie wpisu widoku należy określić elementy elementu definiujące właściwości platformy .NET lub skrypty, które są wyświetlane w tym widoku.Within each entry element of a view, you specify the item elements that define the .NET properties or scripts that are displayed by that view.


<ListItems>
  <ListItem>...</ListItem>
  <ListItem>...</ListItem>
  <ListItem>...</ListItem>
</ListItems>

Jak pokazano w powyższych przykładach, plik formatowania może zawierać wiele widoków, widok może zawierać wiele definicji, a każda definicja może zawierać wiele elementów.As shown in the preceding examples, the formatting file can contain multiple views, a view can contain multiple definitions, and each definition can contain multiple items.

Przykład widoku tabeliExample of a Table View

W poniższym przykładzie przedstawiono tagi XML używane do definiowania widoku tabeli, który zawiera dwie kolumny.The following example shows the XML tags used to define a table view that contains two columns. Element ViewDefinitions jest elementem kontenera dla wszystkich widoków zdefiniowanych w pliku formatowania.The ViewDefinitions element is the container element for all the views defined in the formatting file. Element widoku definiuje określoną tabelę, listę, szerokie lub widok niestandardowy.The View element defines the specific table, list, wide, or custom view. W każdym elemencie widoku element name określa nazwę widoku, element ViewSelectedBy definiuje obiekty, które używają widoku, a różne elementy kontrolki (takie jak TableControl element przedstawiony w poniższym przykładzie) definiują typ widoku.Within each View element, the Name element specifies the name of the view, the ViewSelectedBy element defines the objects that use the view, and the different control elements (such as the TableControl element shown in the following example) define the type of the view.

<ViewDefinitions>
  <View>
    <Name>Name of View</Name>
    <ViewSelectedBy>
      <TypeName>Object to display using this view</TypeName>
      <TypeName>Object to display using this view</TypeName>
    </ViewSelectedBy>
    <TableControl>
      <TableHeaders>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
      </TableHeaders>
      <TableRowEntries>
        <TableRowEntry>
          <TableColumnItems>
            <TableColumnItem>
              <PropertyName>Header for column 1</PropertyName>
            </TableColumnItem>
            <TableColumnItem>
              <PropertyName>Header for column 2</PropertyName>
            </TableColumnItem>
          </TableColumnItems>
        </TableRowEntry>
      </TableRowEntries>
    </TableControl)
  </View>
</ViewDefinitions>

Zobacz teżSee Also

Tworzenie widoku listyCreating a List View

Tworzenie widoku tabeliCreating a Table View

Tworzenie widoku szerokiegoCreating a Wide View

Tworzenie kontrolek niestandardowychCreating Custom Controls

Pisanie pliku formatowania i typów programu PowerShellWriting a PowerShell Formatting and Types File