Egyéni formázási fájlok

A parancsmagok, függvények és szkriptek által visszaadott objektumok megjelenítési formátuma formázási fájlok (format.ps1xml fájlok) használatával van definiálva. A Windows PowerShell számos ilyen fájlt biztosít a Windows PowerShell-parancsmagok által visszaadott objektumok alapértelmezett megjelenítési formátumának meghatározásához. Létrehozhat azonban saját egyéni formázási fájlokat is, amelyekkel felülírhatja az alapértelmezett megjelenítési formátumokat, vagy meghatározhatja a saját parancsai által visszaadott objektumok megjelenítését.

A Windows PowerShell az ezekben a formázási fájlokban szereplő adatokat használja annak meghatározására, hogy mi jelenjen meg, és hogyan formázza az adatokat. A megjelenített adatok tartalmazhatják egy objektum tulajdonságait vagy egy szkriptblokk értékét. A szkriptblokkok akkor használhatók, ha olyan értéket szeretne megjeleníteni, amely nem érhető el közvetlenül egy objektum tulajdonságaiból. Előfordulhat például, hogy egy objektum két tulajdonságának értékét szeretné hozzáadni, és az összeget külön adatelemként megjeleníteni. Amikor saját formázási fájlt ír, meg kell határoznia nézeteket a megjeleníteni kívánt objektumokhoz. Minden objektumhoz definiálhat egyetlen nézetet, több objektumhoz is definiálhat egyetlen nézetet, vagy több nézetet is definiálhat ugyanahhoz az objektumhoz. A definiálható nézetek száma nincs korlátozva.

Fontos

A formázási fájlok nem határozzák meg a folyamatba visszaküldött objektumok elemeit. Amikor egy objektum visszakerül a folyamatba, az objektum minden tagja elérhető lesz.

Nézetek formázása

A formázási nézetek táblázatos, listaformátumú, széles és egyéni formátumú objektumokat jeleníthetnek meg. A legtöbb esetben az egyes formázási definíciók egy nézetet leíró XML-címkékből tevődnek le. Minden nézet tartalmazza a nézet nevét, a nézetet használó objektumokat és a nézet elemeit, például a táblanézet oszlop- és sorinformációit.

A következő nézetek érhetők el.

Táblázatnézet Egy objektum vagy egy szkriptblokk tulajdonságát sorolja fel egy vagy több oszlopban. Minden oszlop az objektum vagy a szkriptblokk értékének egy tulajdonságát jelöli. Meghatározhat olyan táblázatnézetet, amely megjeleníti egy objektum összes tulajdonságát, egy objektum tulajdonságainak egy részhalmazát, vagy a tulajdonságok és a szkriptblokkok értékeinek kombinációját. A tábla minden sora egy visszaadott objektumot jelöl. További információ erről a nézetről: Táblázatnézet.

Listanézet: Egy objektum vagy egy szkriptblokk tulajdonsága egyetlen oszlopban. A lista minden sora egy opcionális címkét vagy tulajdonságnevet jelenít meg, amelyet a tulajdonság vagy szkriptblokk értéke követ. További információ erről a nézetről: Listanézet.

Széles nézet: Egy objektum vagy egy szkriptblokk egyetlen tulajdonsága egy vagy több oszlopban. Ehhez a nézethez nincs címke vagy fejléc. További információ erről a nézetről: Széles nézet.

Egyéni nézet Olyan objektumtulajdonságok vagy szkriptblokkértékek testreszabható nézetét jeleníti meg, amelyek nem igazodnak a táblázatnézetek, listanézetek vagy széles nézetek merev szerkezetéhez. Megadhat önálló egyéni nézetet, vagy megadhat egy másik nézet által használt egyéni nézetet, például táblázatnézetet vagy listanézetet. További információ erről a nézetről: Egyéni nézet.

XML-elemek megtekintése

Az alábbi példa a két oszlopot tartalmazó táblanézet definiálásához használt XML-címkéket mutatja be. A ViewDefinitions elem a formázási fájlban definiált összes nézet tárolóeleme. A Nézet elem határozza meg az adott táblázatot, listát, széles vagy egyéni nézetet. Minden nézetben a Név elem határozza meg a nézet nevét, a ViewSelectedBy elem határozza meg a nézetet használó objektumokat, és a különböző vezérlőelemek (például a TableControl elem) határozzák meg a nézet formátumát.

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:

Táblázatnézet

Listanézet

Széles nézet

egyéni nézet

Windows PowerShell-parancsmag írása