For the complete documentation index, see llms.txt. This page is also available as Markdown.

New-UDTable

Übersicht

Erstellt eine Tabelle.

Syntax

New-UDTable [-Id <String>] [-Title <String>] [-Data <Object[]>] [-Columns <Hashtable[]>] [-OnRowSelection <Endpoint>] [-ShowSort] [-ShowFilter] [-ShowSearch] [-Dense] [-ShowExport] [-StickyHeader] [-PageSize <Int32>] [-PageSizeOptions <Int32[]>] [-PaginationLocation <String>] [-ShowSelection] [-ShowPagination] [-Padding <String>] [-Size <String>] [-TextOption <Hashtable>] [-ExportOption <String[]>] [-OnExport <Endpoint>] [-DisablePageSizeAll] [-DefaultSortDirection <String>] [-HideToggleAllRowsSelected] [-DisableMultiSelect] [-DisableSortRemove] [-Icon <Hashtable>] [-ClassName <String>] [-ShowRefresh] [-ToolbarContent <ScriptBlock>] [-OnRowExpand <ScriptBlock>] [-MaxHeight <Int32>] [-Language <String>] [-RemoveCard] [-OnRowStyle <ScriptBlock>] [-HeaderStyle <Hashtable>] [-InitialState <Hashtable>] [<CommonParameters>]

New-UDTable [-Id <String>] [-Title <String>] -LoadRows <Endpoint> [-Columns <Hashtable[]>] [-OnRowSelection <Endpoint>] [-ShowSort] [-ShowFilter] [-ShowSearch] [-Dense] [-ShowExport] [-StickyHeader] [-PageSize <Int32>] [-PageSizeOptions <Int32[]>] [-PaginationLocation <String>] [-ShowSelection] [-ShowPagination] [-Padding <String>] [-Size <String>] [-TextOption <Hashtable>] [-ExportOption <String[]>] [-OnExport <Endpoint>] [-DisablePageSizeAll] [-DefaultSortDirection <String>] [-HideToggleAllRowsSelected] [-DisableMultiSelect] [-DisableSortRemove] [-Icon <Hashtable>] [-ClassName <String>] [-ShowRefresh] [-ToolbarContent <ScriptBlock>] [-OnRowExpand <ScriptBlock>] [-MaxHeight <Int32>] [-AutoRefresh] [-AutoRefreshInterval <Int32>] [-Language <String>] [-RemoveCard] [-OnRowStyle <ScriptBlock>] [-HeaderStyle <Hashtable>] [-InitialState <Hashtable>] [<CommonParameters>]

Beschreibung

Erstellt eine Tabelle. Tabellen werden verwendet, um sowohl statische als auch dynamische Daten anzuzeigen. Sie können Spalten und Daten definieren, die in der Tabelle angezeigt werden sollen. Die Spalten können verwendet werden, um benutzerdefinierte Komponenten basierend auf den Zeilendaten darzustellen. Sie können außerdem Paging, Filterung, Sortierung und sogar serverseitige Verarbeitung aktivieren.

Parameter

-Id

Die ID der Komponente. Standardmäßig eine zufällige GUID.

Required?                    false
Position?                    named
Default value                [Guid]::NewGuid().ToString()
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Title

Der Titel, der oben auf der Karte der Tabelle angezeigt wird.

-Data <Object[]>

Die Daten, die in die Tabelle eingefügt werden sollen.

-LoadRows

Bei Verwendung dynamischer Tabellen wird dieser Skriptblock aufgerufen. Der Parameter $Body enthält eine Hashtabelle mit den folgenden Optionen:

filters: @() orderBy: string orderDirection: string page: int pageSize: int properties: @() search: string totalCount: int

Sie können diese Werte verwenden, um eine serverseitige Verarbeitung durchzuführen, wie z. B. SQL-Abfragen, um die Leistung großer Raster zu verbessern.

Nachdem Sie die Daten mit diesen Werten verarbeitet haben, geben Sie die Daten über Out-UDTableData aus.

-Columns <Hashtable[]>

Definiert die Spalten, die in der Tabelle angezeigt werden sollen. Verwenden Sie New-UDTableColumn, um diese Spalten zu definieren. Wenn dieser Parameter nicht angegeben wird, werden die Eigenschaften der übergebenen Daten zu den Spalten.

-OnRowSelection

Ein Skriptblock, der aufgerufen wird, wenn eine Zeile ausgewählt wird. $EventData enthält die ausgewählten Zeilen.

-ShowSort

Ob Sortiersteuerelemente in Spalten angezeigt werden sollen

-ShowFilter

Ob Filtersteuerelemente in Spalten angezeigt werden sollen

-ShowSearch

Ob die Suche in der gesamten Tabelle angezeigt werden soll

-Dense

Reduziert den in der Tabelle verwendeten Leerraum.

-ShowExport

Ob die Exportschaltfläche angezeigt werden soll.

Macht die Kopfzeile fixiert.

-PageSize

Die Standardseitengröße.

-PageSizeOptions <Int32[]>

Ein Array verfügbarer Seitengrößenoptionen.

-PaginationLocation

Wo die Paginierungssteuerelemente angezeigt werden sollen. Gültige Werte sind top, bottom oder both. Standardwert ist bottom.

-ShowSelection

Ob die Auswahl innerhalb der Tabelle erlaubt sein soll.

-ShowPagination

Ob Paginierungssteuerelemente angezeigt werden sollen.

-Padding

-Size

Die Größe der Tabelle. Standardwert ist medium. Gültige Werte sind medium und small.

-TextOption

Anpassungen des Standardtextes innerhalb der Tabelle. Verwenden Sie New-UDTextOption, um die Textoptionen zu erstellen.

-ExportOption <String[]>

Ein Array von Exportoptionen.

-OnExport

Ein Skriptblock, mit dem angepasst wird, wie der Export durchgeführt wird.

-DisablePageSizeAll

Entfernt die Option All aus den Seitengrößenoptionen.

-DefaultSortDirection

Die Standardsortierrichtung.

-HideToggleAllRowsSelected

Blendet die Schaltfläche zum Umschalten aller ausgewählten Zeilen aus.

-DisableMultiSelect

Deaktiviert die Mehrfachauswahl.

-DisableSortRemove

Entfernt die Sortieroption für unsortierte Spalten. Spalten werden immer aufsteigend oder absteigend sortiert.

-Icon

Legt ein Symbol neben dem Titel fest. Verwenden Sie New-UDIcon, um das Symbol zu erstellen.

-ClassName

Eine CSS-Klasse, die auf die Tabelle angewendet wird.

-ShowRefresh

Ob die Aktualisierungsschaltfläche angezeigt werden soll.

-ToolbarContent

Benutzerdefinierter Inhalt, der in der Symbolleiste angezeigt werden soll.

-OnRowExpand

Ein Skriptblock, der aufgerufen wird, wenn eine Zeile erweitert wird. Die Variable $EventData enthält die Zeilendaten.

-MaxHeight

-AutoRefresh

Lädt die Tabelle in einem Intervall neu, wenn -LoadRows verwendet wird.

-AutoRefreshInterval

Das Intervall zum Neuladen der Daten, wenn AutoRefresh angegeben ist.

-Language

Die Sprache. Wird hauptsächlich für Datums- und Zeitfilter verwendet.

-RemoveCard

-OnRowStyle

Ein Skriptblock, der aufgerufen wird, um Zeilen zu formatieren. Die Variable $EventData enthält die Zeilendaten.

-HeaderStyle

Eine Hashtabelle mit Stilen, die auf die Kopfzeile angewendet werden.

-InitialState

Allgemeine Parameter

Dieses Cmdlet unterstützt die allgemeinen Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable und OutVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Ausgaben

Beispiele

Beispiel 1: Einfache Tabelle

Erstellt eine statische Tabelle, bei der die Spalten der Tabelle die Eigenschaften der angegebenen Daten sind.

Beispiel 2: Spalten

Erstellt eine Tabelle, bei der benutzerdefinierte Spalten für diese Tabelle definiert sind.

Beispiel 3: Render

Erstellt eine Tabelle, bei der die Spalten mit benutzerdefiniertem Inhalt dargestellt werden.

Beispiel 4: Spaltenbreite

Benutzerdefinierte Spaltenbreite festlegen

Beispiel 5: Spaltenfilter

Spaltenfilter für eine Tabelle

Beispiel 6: Spaltensuche

Spalten können in die Suche einbezogen werden

Beispiel 7

Beispiel 8: Paging

Paging kann aktiviert werden, indem der Parameter -Paging auf $true gesetzt wird. Die Standardseitengröße ist 10.

Beispiel 9: Zeilenerweiterung

Die Zeilenerweiterung kann aktiviert werden, indem der Parameter -OnRowExpand auf einen Skriptblock gesetzt wird. Dem Skriptblock werden die Zeilendaten als Hashtabelle in der Variable $EventData übergeben.

Beispiel 10: Export

Exportieren Sie Tabellendaten mit dem Parameter -Export. Sie können konfigurieren, welche Spalten in den Export einbezogen werden, indem Sie den Parameter -IncludeInExport für die Spalte setzen. Verwenden Sie -Hidden, um eine Spalte in der Tabelle auszublenden, sie aber in den Export einzubeziehen.

Beispiel 11: Textoptionen

Mit Textoptionen kann der Text in der Tabelle angepasst werden.

Beispiel 12: Zeilenformatierung

Sie können Zeilen mit dem Parameter -OnRowStyle formatieren. Dem Skriptblock werden die Zeilendaten als Hashtabelle in der Variable $EventData übergeben. Der Skriptblock sollte eine Hashtabelle mit CSS-Stilen zurückgeben, die auf die Zeile angewendet werden.

Beispiel 13: Standardsortierung

Legen Sie die Standardsortierrichtung und -spalte fest.

Beispiel 14: Anfangszustand

Legen Sie den Anfangszustand der Tabelle fest. Damit können der Seitenindex, die Seitengröße, die Filter und die Sortierspalte festgelegt werden.

Beispiel 15: Zeilenfärbung

Verwenden Sie OnRowStyle, um Zeilen basierend auf den Zeilendaten zu formatieren.

Zuletzt aktualisiert

War das hilfreich?