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

Egy táblázatos nézet egy vagy több oszlop adatait jeleníti meg.A table view displays data in one or more columns. A tábla minden sora egy .NET-objektumot jelöl, a tábla minden oszlopa pedig az objektum egy tulajdonságát vagy egy parancsfájl értékét jelöli.Each row in the table represents a .NET object, and each column of the table represents a 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 vagy egy objektum tulajdonságainak egy részhalmazát.You can define a table view that displays all the properties of an object or a subset of the properties of an object.

Táblázatos nézet megjelenítéseA Table View Display

Az alábbi példa bemutatja, hogyan jeleníti meg a Windows PowerShell a Get-Service parancsmag által visszaadott System. Serviceprocess. ServiceController objektumot.The following example shows how Windows PowerShell displays the System.Serviceprocess.Servicecontroller object that is returned by the Get-Service cmdlet. Ehhez az objektumhoz a Windows PowerShell definiált egy olyan táblázat nézetet, amely megjeleníti a Status tulajdonságot, a Name tulajdonságot (ez a tulajdonság a tulajdonság alias tulajdonsága ServiceName ) és a DisplayName tulajdonságot.For this object, Windows PowerShell has defined a table view that displays the Status property, the Name property (this property is an alias property for the ServiceName property), and the DisplayName property. A tábla minden sora a parancsmag által visszaadott objektumot jelöli.Each row in the table represents an object returned by the cmdlet.

Status   Name               DisplayName
------   ----               -----------
Stopped  AJRouter           AllJoyn Router Service
Stopped  ALG                Application Layer Gateway Service
Stopped  AppIDSvc           Application Identity
Running  Appinfo            Application Information

A tábla nézetének meghatározásaDefining the Table View

A következő XML a Table View sémát mutatja a System. Serviceprocess. ServiceController megjelenítéséhez? Displayproperty = FullName objektum.The following XML shows the table view schema for displaying the System.Serviceprocess.Servicecontroller?Displayproperty=Fullname object. Meg kell adnia minden olyan tulajdonságot, amelyet meg szeretne jeleníteni a táblázat nézetben.You must specify each property that you want displayed in the table view.

<View>
  <Name>service</Name>
  <ViewSelectedBy>
    <TypeName>System.ServiceProcess.ServiceController</TypeName>
  </ViewSelectedBy>
  <TableControl>
    <TableHeaders>
      <TableColumnHeader>
        <Width>8</Width>
      </TableColumnHeader>
      <TableColumnHeader>
        <Width>18</Width>
      </TableColumnHeader>
      <TableColumnHeader>
        <Width>38</Width>
      </TableColumnHeader>
    </TableHeaders>
    <TableRowEntries>
      <TableRowEntry>
        <TableColumnItems>
          <TableColumnItem>
           <PropertyName>Status</PropertyName>
          </TableColumnItem>
          <TableColumnItem>
            <PropertyName>Name</PropertyName>
          </TableColumnItem>
          <TableColumnItem>
            <PropertyName>DisplayName</PropertyName>
          </TableColumnItem>
        </TableColumnItems>
      </TableRowEntry>
    </TableRowEntries>
  </TableControl>
</View>

A következő XML-elemek a listanézet definiálására használhatók:The following XML elements are used to define a list view:

  • A View elem a tábla nézet szülő eleme.The View element is the parent element of the table view. (Ez ugyanaz a szülő elem a listához, a széles és az egyéni vezérlő nézetekhez.)(This is the same parent element for the list, wide, and custom control views.)

  • A név elem a nézet nevét adja meg.The Name element specifies the name of the view. Ez az elem minden nézet esetében kötelező.This element is required for all views.

  • A ViewSelectedBy elem a nézetet használó objektumokat határozza meg.The ViewSelectedBy element defines the objects that use the view. Ezt az elemet kötelező megadni.This element is required.

  • A GroupBy elem (ebben a példában nem látható) meghatározza, hogy mikor jelenjen meg egy új objektum.The GroupBy element (not shown in this example) defines when a new group of objects is displayed. Egy új csoport indul el, amikor egy adott tulajdonság vagy parancsfájl módosul.A new group is started whenever the value of a specific property or script changes. Ez az elem nem kötelező.This element is optional.

  • A Controls elem (ebben a példában nem látható) meghatározza a tábla nézet által definiált egyéni vezérlőket.The Controls element (not shown in this example) defines the custom controls that are defined by the table view. A vezérlők lehetővé teszik az adatmegjelenítés további megadását.Controls give you a way to further specify how the data is displayed. Ez az elem nem kötelező.This element is optional. A nézetek meghatározhatják saját egyéni vezérlőit, vagy használhatnak olyan közös vezérlőket is, amelyeket a formázó fájlban bármely nézet használhat.A view can define its own custom controls, or it can use common controls that can be used by any view in the formatting file. Az egyéni vezérlőkkel kapcsolatos további információkért lásd: Egyéni vezérlők létrehozása.For more information about custom controls, see Creating Custom Controls.

  • A HideTableHeaders elem (ebben a példában nem látható) azt adja meg, hogy a tábla nem jelenít meg feliratokat a tábla tetején.The HideTableHeaders element (not show in this example) specifies that the table will not show any labels at the top of the table. Ez az elem nem kötelező.This element is optional.

  • A tábla fejlécét és sorát meghatározó TableControl elem.The TableControl element that defines the header and row information of the table. Az összes többi nézethez hasonlóan a táblázatos nézetek is megjeleníthetik a parancsfájlok által generált objektumok tulajdonságainak vagy értékeinek értékeit.Similar to all other views, a table view can display the values of object properties or values generated by scripts.

Oszlopfejlécek definiálásaDefining Column Headers

  1. A TableHeaders elem és a hozzá tartozó alárendelt elemek határozzák meg, hogy mi jelenjen meg a tábla tetején.The TableHeaders element and its child elements define what is displayed at the top of the table.

  2. A TableColumnHeader elem határozza meg, hogy mi jelenjen meg a tábla oszlopainak tetején.The TableColumnHeader element defines what is displayed at the top of a column of the table. Ezeket az elemeket abban a sorrendben kell megadni, amelyet meg szeretne jeleníteni a fejlécekben.Specify these elements in the order that you want the headers displayed.

    A használható elemek száma nincs korlátozva, de a TableColumnHeader elemek számának meg kell egyeznie az Ön által használt TableRowEntry számával.There is no limit to the number of these element that you can use, but the number of TableColumnHeader elements in your table view must equal the number of TableRowEntry elements that you use.

  3. A label elem megadja a megjelenített szöveget.The Label element specifies the text that is displayed. Ez az elem nem kötelező.This element is optional.

  4. A Width (szélesség ) elem megadja az oszlop szélességét (karakterben).The Width element specifies the width (in characters) of the column. Ez az elem nem kötelező.This element is optional.

  5. Az igazítási elem megadja a felirat megjelenítésének módját.The Alignment element specifies how the label is displayed. A címke balra, jobbra vagy középre igazítható.The label can be aligned to the left, to the right, or centered. Ez az elem nem kötelező.This element is optional.

A tábla sorainak definiálásaDefining the Table Rows

A táblázatos nézetek egy vagy több olyan definíciót is megadhatnak, amelyek meghatározzák, hogy a tábla soraiban milyen adatokat jelenítenek meg a TableRowEntries elem alárendelt elemeinek használatával.Table views can provide one or more definitions that specify what data is displayed in the rows of the table by using the child elements of the TableRowEntries element. Figyelje meg, hogy a tábla soraihoz több definíció is megadható, de a sorok fejlécei változatlanok maradnak, függetlenül attól, hogy milyen sordefiníció van használatban.Notice that you can specify multiple definitions for the rows of the table, but the headers for the rows remains the same, regardless of what row definition is used. A táblák jellemzően csak egy definícióval rendelkeznek.Typically, a table will have only one definition.

A következő példában a nézet egyetlen definíciót tartalmaz, amely megjeleníti a System. Diagnostics. Process több tulajdonságának értékeit? Displayproperty = FullName objektum.In the following example, the view provides a single definition that displays the values of several properties of the System.Diagnostics.Process?Displayproperty=Fullname object. A táblázatos nézetek megjeleníthetik egy tulajdonság értékét vagy egy parancsfájl értékét (a példában nem látható) a sorokban.A table view can display the value of a property or the value of a script (not shown in the example) in its rows.

<TableRowEntries>
      <TableRowEntry>
        <TableColumnItems>
          <TableColumnItem>
           <PropertyName>Status</PropertyName>
          </TableColumnItem>
          <TableColumnItem>
            <PropertyName>Name</PropertyName>
          </TableColumnItem>
          <TableColumnItem>
            <PropertyName>DisplayName</PropertyName>
          </TableColumnItem>
        </TableColumnItems>
      </TableRowEntry>
    </TableRowEntries>

A következő XML-elemek használhatók egy sor definícióinak megadásához:The following XML elements can be used to provide definitions for a row:

  • A TableRowEntries elem és a hozzá tartozó alárendelt elemek határozzák meg, hogy mi jelenjen meg a tábla soraiban.The TableRowEntries element and its child elements define what is displayed in the rows of the table.

  • A TableRowEntry elem a sor definícióját tartalmazza.The TableRowEntry element provides a definition of the row. Legalább egy TableRowEntry megadása kötelező; a felvehető elemek száma azonban nem lehet felső korlát.At least one TableRowEntry is required; however, there is no maximum limit to the number of elements that you can add. A legtöbb esetben egy nézetnek csak egy definíciója lesz.In most cases, a view will have only one definition.

  • A EntrySelectedBy elem az adott definíció által megjelenített objektumokat határozza meg.The EntrySelectedBy element specifies the objects that are displayed by a specific definition. Ez az elem nem kötelező, és csak akkor szükséges, ha több TableRowEntry elemet ad meg, amelyek különböző objektumokat jelenítenek meg.This element is optional and is needed only when you define multiple TableRowEntry elements that display different objects.

  • A wrap elem azt adja meg, hogy az oszlopszélességet meghaladó szöveg a következő sorban jelenjen meg.The Wrap element specifies that text that exceeds the column width is displayed on the next line. Alapértelmezés szerint a rendszer csonkolja az oszlopszélességet meghaladó szöveget.By default, text that exceeds the column width is truncated.

  • A TableColumnItems elem azokat a tulajdonságokat vagy parancsfájlokat határozza meg, amelyek értékei megjelennek a sorban.The TableColumnItems element defines the properties or scripts whose values are displayed in the row.

  • A TableColumnItem elem határozza meg azt a tulajdonságot vagy parancsfájlt, amelynek értéke megjelenik a sor oszlopban.The TableColumnItem element defines the property or script whose value is displayed in the column of the row. A sor minden oszlopához meg kell adni egy TableColumnItem elemet.A TableColumnItem element is required for each column of the row. Az első bejegyzés az első oszlopban jelenik meg, a második oszlop második bejegyzése és így tovább.The first entry is displayed in first column, the second entry in the second column, and so on.

  • A PropertyName elem meghatározza azt a tulajdonságot, amelynek értéke megjelenik a sorban.The PropertyName element specifies the property whose value is displayed in the row. Meg kell adnia egy tulajdonságot vagy egy parancsfájlt, de mindkettőt nem adhatja meg.You must specify either a property or a script, but you cannot specify both.

  • A scriptblock kulcsszót elem meghatározza azt a parancsfájlt, amelynek értéke megjelenik a sorban.The ScriptBlock element specifies the script whose value is displayed in the row. Meg kell adnia egy parancsfájlt vagy egy tulajdonságot, de mindkettőt nem adhatja meg.You must specify either a script or a property, but you cannot specify both.

  • A FormatString elem a tulajdonság vagy a parancsfájl értékének megjelenítésére szolgáló formázási mintát határozza meg.The FormatString element specifies a format pattern that defines how the property or script value is displayed. Ez az elem nem kötelező.This element is optional.

  • Az igazítási elem megadja a tulajdonság vagy a parancsfájl értékének megjelenítését.The Alignment element specifies how the value of the property or script is displayed. Az érték balra, jobbra vagy középre igazítható.The value can be aligned to the left, to the right, or centered. Ez az elem nem kötelező.This element is optional.

A tábla nézetet használó objektumok meghatározásaDefining the Objects That Use the Table View

Két módon határozható meg, hogy mely .NET-objektumok használják a táblázat nézetet.There are two ways to define which .NET objects use the table view. A ViewSelectedBy elemmel definiálhatja azokat az objektumokat, amelyeket a nézet összes definíciója megjelenít, vagy a EntrySelectedBy elem használatával meghatározhatja, hogy mely objektumok jelenjenek meg a nézet adott definíciójában.You can use the ViewSelectedBy element to define the objects that can be displayed by all the definitions of the view, or you can use the EntrySelectedBy element to define which objects are displayed by a specific definition of the view. A legtöbb esetben a nézetnek csak egy definíciója van, így az objektumokat általában a ViewSelectedBy elem határozza meg.In most cases, a view has only one definition, so objects are typically defined by the ViewSelectedBy element.

Az alábbi példa bemutatja, hogyan határozhatja meg a Table View által megjelenített objektumokat a ViewSelectedBy és a TypeName elemek használatával.The following example shows how to define the objects that are displayed by the table view using the ViewSelectedBy and TypeName elements. A megadható TypeName elemek száma nincs korlátozva, és a sorrendjük nem jelentős.There is no limit to the number of TypeName elements that you can specify, and their order is not significant.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <TypeName>System.ServiceProcess.ServiceController</TypeName>
  </ViewSelectedBy>
  <TableControl>...</TableControl>
</View>

A következő XML-elemek használhatók a tábla nézet által használt objektumok megadásához:The following XML elements can be used to specify the objects that are used by the table view:

  • A ViewSelectedBy elem határozza meg, hogy mely objektumok jelenjenek meg a listanézet alapján.The ViewSelectedBy element defines which objects are displayed by the list view.

  • A TypeName elem a nézet által megjelenített .net-objektumot határozza meg.The TypeName element specifies the .NET object that is displayed by the view. A teljes .NET-típus nevének megadása kötelező.The fully qualified .NET type name is required. Meg kell adnia legalább egy típust vagy kiválasztási készletet a nézethez, de nem adhat meg maximális számú elemet.You must specify at least one type or selection set for the view, but there is no maximum number of elements that can be specified.

A következő példa a ViewSelectedBy és a SelectionSetName elemeket használja.The following example uses the ViewSelectedBy and SelectionSetName elements. Olyan kiválasztási készleteket használjon, amelyekben több nézet használatával megjelenő objektumok is megjelennek, például ha egy listanézet és egy tábla nézet is meg van határozva ugyanahhoz az objektumhoz.Use selection sets where you have a related set of objects that are displayed using multiple views, such as when you define a list view and a table view for the same objects. A kiválasztási csoportok létrehozásával kapcsolatos további információkért lásd: kiválasztási készletek meghatározása.For more information about how to create a selection set, see Defining Selection Sets.

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

A következő XML-elemek használatával adhatja meg a listanézet által használt objektumokat:The following XML elements can be used to specify the objects that are used by the list view:

  • A ViewSelectedBy elem határozza meg, hogy mely objektumok jelenjenek meg a listanézet alapján.The ViewSelectedBy element defines which objects are displayed by the list view.

  • A SelectionSetName elem a nézet által megjeleníthető objektumok halmazát határozza meg.The SelectionSetName element specifies a set of objects that can be displayed by the view. Meg kell adnia legalább egy kiválasztási készletet vagy típust a nézethez, de nem adhat meg maximális számú elemet.You must specify at least one selection set or type for the view, but there is no maximum number of elements that can be specified.

Az alábbi példa bemutatja, hogyan határozhatja meg a tábla nézet adott definíciója által megjelenített objektumokat a EntrySelectedBy elem használatával.The following example shows how to define the objects displayed by a specific definition of the table view using the EntrySelectedBy element. Ennek az elemnek a használatával megadhatja az objektum .NET-típusának nevét, az objektumok kiválasztási halmazát, vagy egy olyan kiválasztási feltételt, amely megadja, hogy a rendszer mikor használja a definíciót.Using this element, you can specify the .NET type name of the object, a selection set of objects, or a selection condition that specifies when the definition is used. A kiválasztási feltételek létrehozásával kapcsolatos további információkért lásd: az adatok megjelenítésére vonatkozó feltételek meghatározása.For more information about how to create a selection conditions, see Defining Conditions for Displaying Data.

Megjegyzés

A tábla nézet több definíciójának létrehozásakor nem adhat meg különböző oszlopfejléceket.When creating multiple definitions of the table view you cannot specify different column headers. Megadhatja, hogy csak mi jelenjen meg a tábla soraiban, például hogy milyen objektumok jelenjenek meg.You can specify only what is displayed in the rows of the table, such as what objects are displayed.

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

A következő XML-elemek használhatók a listanézet adott definíciója által használt objektumok megadására:The following XML elements can be used to specify the objects that are used by a specific definition of the list view:

  • A EntrySelectedBy elem határozza meg, hogy mely objektumok jelenjenek meg a definícióban.The EntrySelectedBy element defines which objects are displayed by the definition.

  • A TypeName elem a definícióban megjelenő .net-objektumot határozza meg.The TypeName element specifies the .NET object that is displayed by the definition. Ezen elem használatakor a teljes .NET-típus nevét kötelező megadni.When using this element, the fully qualified .NET type name is required. Meg kell adnia legalább egy típust, kiválasztási készletet vagy kiválasztási feltételt a definícióhoz, de nem adhat meg maximális számú elemet.You must specify at least one type, selection set, or selection condition for the definition, but there is no maximum number of elements that can be specified.

  • A SelectionSetName elem (nem látható) olyan objektumok készletét határozza meg, amelyeket ez a definíció megjelenít.The SelectionSetName element (not shown) specifies a set of objects that can be displayed by this definition. Meg kell adnia legalább egy típust, kiválasztási készletet vagy kiválasztási feltételt a definícióhoz, de nem adhat meg maximális számú elemet.You must specify at least one type, selection set, or selection condition for the definition, but there is no maximum number of elements that can be specified.

  • A SelectionCondition elem (nem látható) egy olyan feltételt határoz meg, amelynek léteznie kell ehhez a definícióhoz.The SelectionCondition element (not shown) specifies a condition that must exist for this definition to be used. Meg kell adnia legalább egy típust, kiválasztási készletet vagy kiválasztási feltételt a definícióhoz, de nem adhat meg maximális számú elemet.You must specify at least one type, selection set, or selection condition for the definition, but there is no maximum number of elements that can be specified. A kiválasztási feltételek definiálásával kapcsolatos további információkért lásd: az adatok megjelenítésére vonatkozó feltételek meghatározása.For more information about defining selection conditions, see Defining Conditions for Displaying Data.

Formázó sztringek használataUsing Format Strings

A formázási karakterláncok hozzáadhatók egy nézethez, hogy tovább lehessen meghatározni az adatmegjelenítés módját.Formatting strings can be added to a view to further define how the data is displayed. Az alábbi példa bemutatja, hogyan határozhat meg formázó karakterláncot a tulajdonság értékéhez StartTime .The following example shows how to define a formatting string for the value of the StartTime property.

<TableColumnItem>
  <PropertyName>StartTime</PropertyName>
  <FormatString>{0:MMM} (0:DD) (0:HH):(0:MM)</FormatString>
</TableColumnItem>

A következő XML-elemek használhatók a formátum mintázatának megadásához:The following XML elements can be used to specify a format pattern:

  • A TableColumnItem elem határozza meg azt a tulajdonságot vagy parancsfájlt, amelynek értéke megjelenik a sor oszlopban.The TableColumnItem element defines the property or script whose value is displayed in the column of the row. A sor minden oszlopához meg kell adni egy TableColumnItem elemet.A TableColumnItem element is required for each column of the row. Az első bejegyzés az első oszlopban jelenik meg, a második oszlop második bejegyzése és így tovább.The first entry is displayed in first column, the second entry in the second column, and so on.

  • A PropertyName elem meghatározza azt a tulajdonságot, amelynek értéke megjelenik a sorban.The PropertyName element specifies the property whose value is displayed in the row. Meg kell adnia egy tulajdonságot vagy egy parancsfájlt, de mindkettőt nem adhatja meg.You must specify either a property or a script, but you cannot specify both.

  • A FormatString elem a tulajdonság vagy a parancsfájl értékének megjelenítésére szolgáló formázási mintát határozza meg.The FormatString element specifies a format pattern that defines how the property or script value is displayed.

A következő példában a ToString metódust a rendszer a parancsfájl értékének formázására hívja meg.In the following example, the ToString method is called to format the value of the script. A parancsfájlok bármely objektum metódusát hívhatják.Scripts can call any method of an object. Ezért ha egy objektumnak van olyan metódusa (például ToString ), amely formázó paramétereket tartalmaz, a parancsfájl meghívhatja ezt a metódust a parancsfájl kimeneti értékének formázására.Therefore, if an object has a method, such as ToString, that has formatting parameters, the script can call that method to format the output value of the script.

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

A metódus meghívásához a következő XML-elemet használhatja ToString :The following XML element can be used to calling the ToString method:

  • A TableColumnItem elem határozza meg azt a tulajdonságot vagy parancsfájlt, amelynek értéke megjelenik a sor oszlopban.The TableColumnItem element defines the property or script whose value is displayed in the column of the row. A sor minden oszlopához meg kell adni egy TableColumnItem elemet.A TableColumnItem element is required for each column of the row. Az első bejegyzés az első oszlopban jelenik meg, a második oszlop második bejegyzése és így tovább.The first entry is displayed in first column, the second entry in the second column, and so on.

  • A scriptblock kulcsszót elem meghatározza azt a parancsfájlt, amelynek értéke megjelenik a sorban.The ScriptBlock element specifies the script whose value is displayed in the row. Meg kell adnia egy parancsfájlt vagy egy tulajdonságot, de mindkettőt nem adhatja meg.You must specify either a script or a property, but you cannot specify both.

Lásd még:See Also

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