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

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.

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?