Formázási fájl – ÁttekintésFormatting File Overview

A parancsok által visszaadott objektumok megjelenítési formátuma (parancsmagok, függvények és parancsfájlok) a fájlok formázása (format.ps1XML-fájlok) használatával van definiálva.The display format for the objects that are returned by commands (cmdlets, functions, and scripts) are defined by using formatting files (format.ps1xml files). A PowerShell számos ilyen fájlt biztosít, hogy meghatározza a PowerShell által megadott parancsok által visszaadott objektumok megjelenítési formátumát, például a System. Diagnostics. Process objektumot, amelyet a parancsmag adott vissza Get-Process .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. Létrehozhat azonban saját egyéni formázó fájlokat is, amelyek felülírják az alapértelmezett megjelenítési formátumokat, vagy írhat egyéni formázási fájlt a saját parancsai által visszaadott objektumok megjelenítésének meghatározásához.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.

Fontos

A formázási fájlok nem határozzák meg a folyamatnak visszaadott objektum elemeit.Formatting files do not determine the elements of an object that are returned to the pipeline. Ha egy objektum visszakerül a folyamatba, az adott objektum összes tagja akkor is elérhető, ha néhány nem jelenik meg.When an object is returned to the pipeline, all members of that object are available even if some are not displayed.

A PowerShell az ezekben a formázási fájlokban található adat alapján határozza meg, hogy mi jelenjen meg, és hogy a megjelenített adat hogyan legyen formázva.PowerShell uses the data in these formatting files to determine what is displayed and how the displayed data is formatted. A megjelenített adatmennyiség tartalmazhat egy objektum tulajdonságait vagy egy parancsfájl értékét is.The displayed data can include the properties of an object or the value of a script. A parancsfájlok akkor használhatók, ha olyan értéket szeretne megjeleníteni, amely nem érhető el közvetlenül az objektum tulajdonságaiból, például egy objektum két tulajdonságának értékét, majd az összeget egy adatként jeleníti meg.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. A megjelenített információk formázása a megjeleníteni kívánt objektumok nézeteinek definiálásával történik.Formatting of the displayed data is done by defining views for the objects that you want to display. Egyetlen nézetet is meghatározhat az egyes objektumokhoz, egyetlen nézetet is meghatározhat több objektumhoz, vagy több nézetet is megadhat ugyanahhoz az objektumhoz.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. A megadható nézetek száma nincs korlátozva.There is no limit to the number of views that you can define.

A fájlok formázásának gyakori funkcióiCommon Features of Formatting Files

Az egyes formázási fájlok a következő összetevőket határozhatják meg, amelyek megoszthatók a fájl által definiált összes nézet között:Each formatting file can define the following components that can be shared across all the views defined by the file:

  • Az alapértelmezett konfigurációs beállítás, például azt, hogy a táblák soraiban megjelenő adatmennyiség a következő sorban jelenjen-e meg, ha az adatmennyiség hosszabb az oszlop szélességében.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. További információ ezekről a beállításokról: általános konfigurációs beállítások definiálása.For more information about these settings, see Defining Common Configuration Settings.

  • A formázási fájl bármelyik nézetében megjeleníthető objektumok csoportja.Sets of objects that can be displayed by any of the views of the formatting file. További információ ezekről a készletekről (úgynevezett kiválasztási készletekről ): objektumok készletének meghatározása.For more information about these sets (referred to as selection sets ), see Defining Sets of Objects.

  • Általános vezérlők, amelyeket a formázó fájl összes nézete használhat.Common controls that can be used by all the views of the formatting file. A vezérlőelemek finomabban szabályozzák az adatmegjelenítés módját.Controls give you finer control on how data is displayed. A vezérlőkkel kapcsolatos további információkért lásd: Egyéni vezérlők definiálása.For more information about controls, see Defining Custom Controls.

Nézetek formázásaFormatting Views

A formázási nézetek táblázatos formátumú objektumokat, a lista formátumát, a széles formátumot és az egyéni formátumot tudják megjeleníteni.Formatting views can display objects in a table format, list format, wide format, and custom format. A legtöbb esetben az egyes formázási definíciókat a nézetet leíró XML-címkék egy halmaza írja le.For the most part, each formatting definition is described by a set of XML tags that describe the view. Minden nézet tartalmazza a nézet nevét, a nézetet használó objektumokat, valamint a nézet elemeit, például a tábla nézet oszlopát és sorát.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.

A táblázat nézet egy objektum vagy egy parancsfájl-blokk értékeit sorolja fel egy vagy több oszlopban.Table View Lists the properties of an object or a script block value in one or more columns. Minden oszlop az objektum vagy egy parancsfájl értékének egyetlen tulajdonságát jelöli.Each column represents a single property of the object or a script value. Megadhat egy olyan táblázat nézetet, amely megjeleníti egy objektum összes tulajdonságát, egy objektum tulajdonságainak egy részhalmazát, illetve a tulajdonságok és a parancsfájl-értékek kombinációját.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. A tábla minden sora egy visszaadott objektumot jelöl.Each row of the table represents a returned object. A táblázatos nézetek létrehozása nagyon hasonlít a parancsmaghoz tartozó objektumok adatcsatornához való átadásához Format-Table .Creating a table view is very similar to when you pipe an object to the Format-Table cmdlet. További információ erről a nézetről: Table View.For more information about this view, see Table View.

A listanézet egy objektum vagy egy parancsfájl értékének egy adott oszlopban való megjelenítését sorolja fel.List View Lists the properties of an object or a script value in a single column. A lista minden egyes sora egy opcionális címkét vagy a tulajdonság nevét, majd a tulajdonság vagy a parancsfájl értékét is megjeleníti.Each row of the list displays an optional label or the property name followed by the value of the property or script. A listanézet létrehozása nagyon hasonlít az objektumnak a parancsmaghoz való átirányításához Format-List .Creating a list view is very similar to piping an object to the Format-List cmdlet. További információ erről a nézetről: listanézet.For more information about this view, see List View.

A széles nézet egy objektum vagy egy parancsfájl értékének egyetlen tulajdonságát listázza egy vagy több oszlopban.Wide View Lists a single property of an object or a script value in one or more columns. Ehhez a nézethez nincs felirat vagy fejléc.There is no label or header for this view. A széles nézet létrehozása nagyon hasonlít az objektumnak a parancsmaghoz való átirányításához Format-Wide .Creating a wide view is very similar to piping an object to the Format-Wide cmdlet. További információ erről a nézetről: széles nézet.For more information about this view, see Wide View.

Az egyéni nézet az objektumok tulajdonságainak testreszabható nézetét jeleníti meg, amelyek nem felelnek meg a táblák nézeteinek, nézeteinek vagy széles nézeteinek merev szerkezetének.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. Megadhat egy önálló egyéni nézetet, vagy megadhat egy olyan egyéni nézetet, amelyet egy másik nézet használ, például egy táblázat nézet vagy listanézet.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. Az egyéni nézetek létrehozása nagyon hasonlít az objektumnak a parancsmaghoz való átirányításához Format-Custom .Creating a custom view is very similar to piping an object to the Format-Custom cmdlet. További információ erről a nézetről: Egyéni nézet.For more information about this view, see Custom View.

Nézet összetevőiComponents of a View

Az alábbi XML-példák egy nézet alapszintű XML-összetevőit mutatják be.The following XML examples show the basic XML components of a view. Az egyedi XML-elemek attól függően változnak, hogy melyik nézetet szeretné létrehozni, de a nézetek alapvető összetevői ugyanazok.The individual XML elements vary depending on which view you want to create, but the basic components of the views are all the same.

A kezdéshez minden nézet tartalmaz egy olyan Name elemet, amely a nézetre való hivatkozáshoz használt felhasználóbarát nevet adja meg.To start with, each view has a Name element that specifies a user friendly name that is used to reference the view. egy ViewSelectedBy elem, amely meghatározza, hogy a nézet mely .net-objektumokat jeleníti meg, valamint egy vezérlő elemet, amely meghatározza a nézetet.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>

A vezérlő elemen belül megadhat egy vagy több bejegyzési elemet.Within the control element, you can define one or more entry elements. Ha több definíciót használ, meg kell adnia, hogy mely .NET-objektumok használják a definíciókat.If you use multiple definitions, you must specify which .NET objects use each definition. Általában csak egy olyan bejegyzés szükséges, amely csak egy definícióval rendelkezik.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>

A nézetek minden egyes belépési elemén megadhatja azokat az elemeket, amelyek meghatározzák a .net-tulajdonságokat vagy a nézet által megjelenített parancsfájlokat.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>

Ahogy az előző példákban is látható, a formázó fájl több nézetet is tartalmazhat, a nézetek több definíciót is tartalmazhatnak, és mindegyik definíció több elemet is tartalmazhat.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.

Táblázatos nézet – példaExample of a Table View

Az alábbi példa egy két oszlopot tartalmazó táblázatos nézet definiálásához használt XML-címkéket mutatja be.The following example shows the XML tags used to define a table view that contains two columns. A ViewDefinitions elem a formázó fájlban meghatározott összes nézet tároló eleme.The ViewDefinitions element is the container element for all the views defined in the formatting file. A View elem határozza meg az adott táblázatot, listát, széles vagy egyéni nézetet.The View element defines the specific table, list, wide, or custom view. Az egyes nézetekben a Name (név ) elem megadja a nézet nevét, a ViewSelectedBy elem pedig meghatározza a nézetet használó objektumokat, valamint a különböző vezérlő elemeket (például a TableControl következő példában látható elemet) a nézet típusának meghatározásához.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>

Lásd még:See Also

Listanézet létrehozásaCreating a List View

Tábla nézet létrehozásaCreating a Table View

Széles nézet létrehozásaCreating a Wide View

Egyéni vezérlők létrehozásaCreating Custom Controls

PowerShell-formázás és-típusok fájljának írásaWriting a PowerShell Formatting and Types File