Vlastní formátovací soubory

Formát zobrazení pro objekty vrácené rutinami, funkcemi a skripty jsou definovány pomocí formátovacích souborů (soubory format.ps1xml). Některé z těchto souborů poskytuje Windows PowerShell k definování výchozího formátu zobrazení pro objekty vrácené Windows PowerShell rutinami. Můžete ale také vytvořit vlastní formátovací soubory, které přepíší 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 se data formátují. Zobrazená data mohou zahrnovat vlastnosti objektu nebo hodnotu bloku skriptu. Bloky skriptu se používají, pokud chcete zobrazit nějakou hodnotu, která není k dispozici přímo z vlastností objektu. Můžete například chtít přidat hodnotu dvou vlastností objektu a zobrazit součet jako samostatnou část dat. Při psaní vlastního formátovacího souboru 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í žádný limit.

Důležité

Formátovací soubory ne urč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.

Zobrazení formátu

Formátovací zobrazení mohou zobrazovat objekty ve formátu tabulky, formátu seznamu, širokém formátu a vlastním formátu. Ve většině částí je každá definice formátování popsána pomocí sady značek XML, které popisují zobrazení. Každé zobrazení obsahuje název zobrazení, objekty, které toto zobrazení používají, a prvky zobrazení, například informace o sloupci a řádku pro zobrazení tabulky.

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

Zobrazení tabulky Obsahuje seznam vlastností objektu nebo hodnoty bloku skriptu v jednom nebo více sloupcích. Každý sloupec představuje vlastnost objektu nebo hodnotu 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í najdete v tématu Zobrazení tabulky.

Zobrazení seznamu Obsahuje seznam vlastností 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í najdete v tématu Zobrazení seznamu.

Široké zobrazení: Zobrazuje jednu vlastnost objektu nebo hodnoty bloku skriptu v jednom nebo více sloupcích. Toto zobrazení nemá žádný popisek ani záhlaví. Další informace o tomto zobrazení najdete v tématu Široké zobrazení.

Vlastní zobrazení: Zobrazuje přizpůsobitelné zobrazení vlastností objektu nebo hodnot bloků skriptů, které nedodržují pevnou strukturu zobrazení tabulek, zobrazení seznamu nebo širokých zobrazení. Můžete definovat samostatné vlastní zobrazení nebo vlastní zobrazení, které používá jiné zobrazení, například zobrazení tabulky nebo seznamu. Další informace o tomto zobrazení najdete v tématu Vlastní zobrazení.

Zobrazení elementů 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á ve formátovacím souboru. Element View definuje konkrétní tabulku, seznam, široké nebo vlastní zobrazení. V každém zobrazení určuje element Name název zobrazení, element ViewSelectedBy definuje objekty, které používají zobrazení, a různé ovládací prvky (například element) definují formát TableControl 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é zobrazení

Vlastní zobrazení

Vytvoření rutiny Windows PowerShellu