New-UDTable
Sintesi
Crea una tabella.
Sintassi
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>]Descrizione
Crea una tabella. Le tabelle vengono utilizzate per mostrare dati sia statici sia dinamici. È possibile definire le colonne e i dati da mostrare all'interno della tabella. Le colonne possono essere utilizzate per il rendering di componenti personalizzati in base ai dati della riga. È inoltre possibile abilitare la paginazione, il filtraggio, l'ordinamento e persino l'elaborazione lato server.
Parametri
-Id
L'ID del componente. Per impostazione predefinita è un GUID casuale.
Required? false
Position? named
Default value [Guid]::NewGuid().ToString()
Accept pipeline input? false
Aliases
Accept wildcard characters? false-Title
Il titolo da mostrare nella parte superiore della scheda della tabella.
-Data <Object[]>
I dati da inserire nella tabella.
-LoadRows
Quando si utilizzano tabelle dinamiche, viene chiamato questo blocco di script. Il parametro $Body conterrà una hashtable con le seguenti opzioni:
filters: @() orderBy: string orderDirection: string page: int pageSize: int properties: @() search: string totalCount: int
È possibile utilizzare questi valori per eseguire l'elaborazione lato server, come le query SQL, per migliorare le prestazioni delle griglie di grandi dimensioni.
Dopo aver elaborato i dati con questi valori, restituisca i dati tramite Out-UDTableData.
-Columns <Hashtable[]>
Definisce le colonne da mostrare all'interno della tabella. Utilizzi New-UDTableColumn per definire queste colonne. Se questo parametro non viene specificato, le proprietà dei dati passati diventeranno le colonne.
-OnRowSelection
Un blocco di script da chiamare quando viene selezionata una riga. $EventData conterrà le righe selezionate.
-ShowSort
Se mostrare i controlli di ordinamento sulle colonne
-ShowFilter
Se mostrare i controlli di filtro sulle colonne
-ShowSearch
Se mostrare la ricerca sull'intera tabella
-Dense
Riduce lo spazio bianco utilizzato all'interno della tabella.
-ShowExport
Se mostrare il pulsante di esportazione.
-StickyHeader
Rende l'intestazione fissa.
-PageSize
La dimensione predefinita della pagina.
-PageSizeOptions <Int32[]>
Un array di opzioni disponibili per la dimensione della pagina.
-PaginationLocation
Dove mostrare i controlli di paginazione. I valori validi sono top, bottom o both. Il valore predefinito è bottom.
-ShowSelection
Se consentire la selezione all'interno della tabella.
-ShowPagination
Se mostrare i controlli di paginazione.
-Padding
-Size
La dimensione della tabella. Il valore predefinito è medium. I valori validi sono medium e small.
-TextOption
Personalizzazioni del testo standard all'interno della tabella. Utilizzi New-UDTextOption per creare le opzioni di testo.
-ExportOption <String[]>
Un array di opzioni di esportazione.
-OnExport
Un blocco di script utilizzato per personalizzare la modalità di esecuzione dell'esportazione.
-DisablePageSizeAll
Rimuove l'opzione All dalle opzioni di dimensione della pagina.
-DefaultSortDirection
La direzione di ordinamento predefinita.
-HideToggleAllRowsSelected
Nasconde il pulsante di attivazione/disattivazione della selezione di tutte le righe.
-DisableMultiSelect
Disabilita la selezione multipla.
-DisableSortRemove
Rimuove l'opzione di ordinamento per le colonne non ordinate. Le colonne saranno sempre in ordine crescente o decrescente.
-Icon
Imposta un'icona accanto al titolo. Utilizzi New-UDIcon per creare l'icona.
-ClassName
Una classe CSS da applicare alla tabella.
-ShowRefresh
Se mostrare il pulsante di aggiornamento.
-ToolbarContent
Contenuto personalizzato da mostrare nella barra degli strumenti.
-OnRowExpand
Un blocco di script da chiamare quando una riga viene espansa. La variabile $EventData conterrà i dati della riga.
-MaxHeight
-AutoRefresh
Ricarica la tabella a intervalli quando viene utilizzato -LoadRows.
-AutoRefreshInterval
L'intervallo di ricaricamento dei dati quando è specificato AutoRefresh.
-Language
La lingua. Utilizzata principalmente per i filtri Data e Ora.
-RemoveCard
-OnRowStyle
Un blocco di script da chiamare per applicare uno stile alle righe. La variabile $EventData conterrà i dati della riga.
-HeaderStyle
Una hashtable di stili da applicare all'intestazione.
-InitialState
Parametri comuni
Questo cmdlet supporta i parametri comuni: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable e OutVariable. Per maggiori informazioni, veda about_CommonParameters.
Output
Esempi
Esempio 1: tabella di base
Crea una tabella statica in cui le colonne della tabella sono le proprietà dei dati specificati.
Esempio 2: colonne
Crea una tabella in cui sono definite colonne personalizzate per tale tabella.
Esempio 3: rendering
Crea una tabella in cui le colonne vengono renderizzate con contenuto personalizzato.
Esempio 4: larghezza delle colonne
Imposta una larghezza personalizzata delle colonne
Esempio 5: filtro delle colonne
Filtri delle colonne per una tabella
Esempio 6: ricerca nelle colonne
Le colonne possono essere incluse nella ricerca
Esempio 7
Esempio 8: paginazione
La paginazione può essere abilitata impostando il parametro -Paging su $true. La dimensione predefinita della pagina è 10.
Esempio 9: espansione delle righe
L'espansione delle righe può essere abilitata impostando il parametro -OnRowExpand su un blocco di script. Al blocco di script verranno passati i dati della riga come hashtable nella variabile $EventData.
Esempio 10: esportazione
Esporti i dati della tabella con il parametro -Export. È possibile configurare quali colonne sono incluse nell'esportazione impostando il parametro -IncludeInExport sulla colonna. Utilizzi -Hidden per nascondere una colonna dalla tabella includendola però nell'esportazione.
Esempio 11: opzioni di testo
Le opzioni di testo possono essere utilizzate per personalizzare il testo nella tabella.
Esempio 12: stile delle righe
È possibile applicare uno stile alle righe utilizzando il parametro -OnRowStyle. Al blocco di script verranno passati i dati della riga come hashtable nella variabile $EventData. Il blocco di script deve restituire una hashtable di stili CSS da applicare alla riga.
Esempio 13: ordinamento predefinito
Imposti la direzione e la colonna di ordinamento predefinite.
Esempio 14: stato iniziale
Imposti lo stato iniziale della tabella. Può essere utilizzato per impostare l'indice di pagina, la dimensione della pagina, i filtri e la colonna di ordinamento.
Esempio 15: colorazione delle righe
Utilizzi OnRowStyle per applicare uno stile alle righe in base ai dati della riga.
Ultimo aggiornamento
È stato utile?