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.
-StickyHeader
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?