Přehled formátovacího souboru
Formát zobrazení pro objekty vrácené příkazy (rutiny, funkce a skripty) jsou definovány pomocí formátování souborů (format.ps1xml). PowerShell poskytuje několik těchto souborů k definování formátu zobrazení pro tyto objekty vrácené příkazy, jako jsou například System.Diagnostics.Process objekt vrácený rutinou Get-Process. Můžete ale také vytvořit vlastní soubory formátování pro přepsání výchozích formátů zobrazení nebo můžete napsat vlastní formátovací soubor, který definuje zobrazení objektů vrácených vlastními příkazy.
Důležité
Formátovací soubory nezjišťují prvky objektu, které jsou vráceny do kanálu. Při vrácení objektu do kanálu jsou k dispozici všichni členové tohoto objektu, i když některé nejsou zobrazeny.
PowerShell používá data v těchto formátovacích souborech k určení toho, co se zobrazí a jak jsou zobrazená data naformátovaná. Zobrazená data mohou obsahovat vlastnosti objektu nebo hodnoty skriptu. Skripty se používají, pokud chcete zobrazit nějakou hodnotu, která není k dispozici přímo z vlastností objektu, například přidání hodnoty dvou vlastností objektu a následné zobrazení součtu jako části dat. Formátování zobrazených dat se provádí definováním 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ý.
Běžné funkce formátovaných souborů
Každý soubor formátování může definovat následující komponenty, které se dají sdílet napříč všemi zobrazeními definovanými souborem:
Výchozí nastavení konfigurace, například jestli se data zobrazená v řádcích tabulek zobrazí na dalším řádku, pokud jsou data delší než šířka sloupce. Další informace o těchto nastaveních naleznete v tématu Wrap Element pro TableRowEntry.
Sady objektů, které lze zobrazit v libovolném zobrazení souboru formátování. Další informace o těchto sadách (označovaných jako sady výběrů), naleznete v tématu Definování sad objektů.
Běžné ovládací prvky, které můžou používat všechna zobrazení souboru formátování. Ovládací prvky umožňují jemně řídit způsob zobrazení dat. Další informace o ovládacíchprvch ch
Formátování 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 popisující 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.
Zobrazení tabulky
Vypíše vlastnosti objektu nebo hodnoty bloku skriptu v jednom nebo více sloupcích. Každý sloupec představuje jednu vlastnost objektu nebo hodnoty skriptu. Můžete definovat zobrazení tabulky, které zobrazuje všechny vlastnosti objektu, podmnožinu vlastností objektu nebo kombinaci vlastností a hodnot skriptu. Každý řádek tabulky představuje vrácený objekt. Vytvoření zobrazení tabulky je velmi podobné, jako když objekt předáte rutině Format-Table. Další informace o tomto zobrazení naleznete v tématu zobrazení tabulky.
Zobrazení seznamu
Vypíše vlastnosti objektu nebo hodnoty skriptu v jednom sloupci. Každý řádek seznamu zobrazuje volitelný popisek nebo název vlastnosti následovaný hodnotou vlastnosti nebo skriptu.
Vytvoření zobrazení seznamu je velmi podobné propojení objektu s rutinou Format-List. Další informace o tomto zobrazení naleznete v tématu Zobrazení seznamu.
Široké zobrazení
Vypíše jednu vlastnost objektu nebo hodnoty skriptu v jednom nebo více sloupcích. Pro toto zobrazení neexistuje žádný popisek ani záhlaví. Vytvoření širokého zobrazení je velmi podobné propojení objektu s rutinou Format-Wide. Další informace o tomto zobrazení naleznete v tématu Wide View.
Vlastní zobrazení
Zobrazí přizpůsobitelné zobrazení vlastností objektu nebo hodnot skriptu, které nevyhovují pevné struktuře zobrazení tabulky, zobrazení seznamu 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.
Vytvoření vlastního zobrazení je velmi podobné propojení objektu s rutinou Format-Custom. Další informace o tomto zobrazení naleznete v tématu vlastní zobrazení.
Součásti zobrazení
Následující příklady XML ukazují základní komponenty XML zobrazení. Jednotlivé elementy XML se liší v závislosti na tom, které zobrazení chcete vytvořit, ale základní komponenty zobrazení jsou všechny stejné.
Pro začátek má každé zobrazení Name prvek, který určuje uživatelsky přívětivý název, který se používá pro odkaz na zobrazení.
ViewSelectedBy element, který definuje, které objekty .NET jsou zobrazeny v zobrazení, a ovládací prvek element, který definuje zobrazení.
<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>
V ovládacím prvku můžete definovat jeden nebo více položku elementy. Pokud používáte více definic, musíte určit, které objekty .NET používají každou definici. Pro každý ovládací prvek je obvykle potřeba jenom jedna položka s jedinou definicí.
<ListControl>
<ListEntries>
<ListEntry>
<EntrySelectedBy>...</EntrySelectedBy>
<ListItems>...</ListItems>
</ListEntry>
<ListEntry>
<EntrySelectedBy>...</EntrySelectedBy>
<ListItems>...</ListItems>
</ListEntry>
<ListEntry>
<EntrySelectedBy>...</EntrySelectedBy>
<ListItems>...</ListItems>
</ListEntry>
</ListEntries>
</ListControl>
V rámci každého prvku položky zobrazení zadáte položky prvky, které definují vlastnosti rozhraní .NET nebo skripty, které jsou zobrazeny tímto zobrazením.
<ListItems>
<ListItem>...</ListItem>
<ListItem>...</ListItem>
<ListItem>...</ListItem>
</ListItems>
Jak je znázorněno v předchozích příkladech, formátovací soubor může obsahovat více zobrazení, zobrazení může obsahovat více definic a každá definice může obsahovat více položek.
Příklad zobrazení tabulky
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 View element, Name element určuje název zobrazení, ViewSelectedBy element definuje objekty, které používají zobrazení, a různé ovládací prvky (například TableControl element zobrazený v následujícím příkladu) definují typ 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é
vytvoření zobrazení seznamu
vytvoření zobrazení tabulky
vytvoření širokého zobrazení
