Vlastní formátovací soubory

Formát zobrazení pro objekty vrácené rutinami, funkcemi a skripty jsou definovány pomocí souborů formátování (format.ps1xml souborů). Několik z těchto souborů poskytuje Prostředí Windows PowerShell k definování výchozího formátu zobrazení pro tyto objekty vrácené rutinami Prostředí Windows PowerShell. Můžete ale také vytvořit vlastní formátovací soubory, které přepíšou výchozí formáty zobrazení nebo definují zobrazení objektů vrácených vlastními příkazy.

Windows PowerShell používá data v těchto formátovacích souborech k určení toho, co se zobrazí a jak jsou data formátovaná. Zobrazená data mohou zahrnovat vlastnosti objektu nebo hodnotu bloku skriptu. Bloky skriptu se používají, pokud chcete zobrazit určitou hodnotu, která není k dispozici přímo z vlastností objektu. Můžete například přidat hodnotu dvou vlastností objektu a zobrazit součet jako samostatnou část dat. Při psaní vlastního souboru formátování budete muset definovat zobrazení pro objekty, které chcete zobrazit. Můžete definovat jedno zobrazení pro každý objekt, můžete definovat jedno zobrazení pro více objektů nebo můžete definovat více zobrazení pro stejný objekt. Počet zobrazení, která můžete definovat, není nijak omezený.

Důležité

Formátovací soubory nezjišťují prvky objektu, které jsou vráceny do kanálu. Když se objekt vrátí do kanálu, jsou k dispozici všichni členové tohoto objektu.

Formát zobrazení

Zobrazení formátování můžou zobrazovat objekty ve formátu tabulky, formátu seznamu, širokém formátu a vlastním formátu. Ve většině případů je každá definice formátování popsaná sadou značek XML, které popisují zobrazení. Každé zobrazení obsahuje název zobrazení, objekty, které používají zobrazení, a prvky zobrazení, například informace o sloupci a řádku pro zobrazení tabulky.

K dispozici jsou následující zobrazení.

Zobrazení tabulky Obsahuje vlastnosti objektu nebo hodnoty bloku skriptu v jednom nebo více sloupcích. Každý sloupec představuje vlastnost objektu nebo hodnoty bloku skriptu. Můžete definovat zobrazení tabulky, které zobrazuje všechny vlastnosti objektu, podmnožinu vlastností objektu nebo kombinaci vlastností a hodnot bloku skriptu. Každý řádek tabulky představuje vrácený objekt. Další informace o tomto zobrazení naleznete v tématu zobrazení tabulky.

Zobrazení seznamu Obsahuje vlastnosti objektu nebo hodnoty bloku skriptu v jednom sloupci. Každý řádek seznamu zobrazuje volitelný popisek nebo název vlastnosti následovaný hodnotou vlastnosti nebo bloku skriptu. Další informace o tomto zobrazení naleznete v tématu Zobrazení seznamu.

Široké zobrazení Obsahuje jednu vlastnost objektu nebo hodnoty bloku skriptu v jednom nebo více sloupcích. Pro toto zobrazení neexistuje žádný popisek ani záhlaví. Další informace o tomto zobrazení naleznete v tématu Wide View.

Vlastní zobrazení Zobrazuje přizpůsobitelné zobrazení vlastností objektu nebo hodnot bloku skriptu, které nevyhovují pevné struktuře zobrazení tabulky, zobrazení seznamů nebo širokých zobrazení. Můžete definovat samostatné vlastní zobrazení nebo můžete definovat vlastní zobrazení, které používá jiné zobrazení, například zobrazení tabulky nebo zobrazení seznamu. Další informace o tomto zobrazení naleznete v tématu vlastní zobrazení.

Zobrazit elementy XML

Následující příklad ukazuje značky XML použité k definování zobrazení tabulky, které obsahuje dva sloupce. Element ViewDefinitions je element kontejneru pro všechna zobrazení definovaná v souboru formátování. Element View definuje konkrétní tabulku, seznam, šířku nebo vlastní zobrazení. V každém zobrazení element Name určuje název zobrazení, element ViewSelectedBy definuje objekty, které používají zobrazení, a různé ovládací prvky (například element TableControl) definují formát zobrazení.

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>

Viz také

zobrazení tabulky

zobrazení seznamu

širokého zobrazení

vlastní zobrazení

psaní rutiny Prostředí Windows PowerShell