New-UDDataGrid

Sinossi

Visualizza i dati in una griglia in stile tabella.

Sintassi

New-UDDataGrid [[-Id] <String>] [[-Columns] <Hashtable[]>] [[-LoadRows] <Endpoint>] [[-Height] <String>] [[-AutoHeight] <Boolean>] [-AutoPageSize] [-CheckboxSelection] [-CheckboxSelectionVisibleOnly] [[-ColumnBuffer] <Int32>] [[-ColumnThreshold] <Int32>] [[-Density] <String>] [[-PageSize] <Int32>] [[-RowsPerPageOptions] <Int32[]>] [-ShowPagination] [[-OnSelectionChange] <Endpoint>] [[-Language] <String>] [[-LoadDetailContent] <Endpoint>] [[-DetailHeight] <String>] [[-OnEdit] <Endpoint>] [[-OnExport] <Endpoint>] [-ShowQuickFilter] [[-DefaultSortColumn] <String>] [[-DefaultSortDirection] <String>] [-DisableRowSelectionOnClick] [-HideExport] [[-RowHeight] <Int32>] [[-IdentityColumn] <String>] [-StripedRows] [-HeaderFilters] [-AutoSizeColumns] [[-ExportOptions] <String[]>] [<CommonParameters>]

Descrizione

Visualizza i dati in una griglia in stile tabella. Fornisce supporto per l'ordinamento, la paginazione e il filtraggio di set di dati di grandi dimensioni.

Parametri

-Id

L'ID di questa griglia dati.

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

-Columns <Hashtable[]>

Un array di colonne da visualizzare in questa tabella.

Required?                    false
Position?                    2
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-LoadRows

Il blocco di script che carica i dati per questa griglia.

Required?                    false
Position?                    3
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Height

L'altezza statica di questa griglia dati.

Required?                    false
Position?                    4
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-AutoHeight

Indica se calcolare l'altezza di questa griglia dati.

Required?                    false
Position?                    5
Default value                True
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-AutoPageSize

Determina automaticamente la dimensione della pagina.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-CheckboxSelection

Selezione tramite casella di controllo per le righe.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-CheckboxSelectionVisibleOnly

Descrizione del parametro

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ColumnBuffer

Descrizione del parametro

Required?                    false
Position?                    6
Default value                3
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ColumnThreshold

Required?                    false
Position?                    7
Default value                3
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Density

La densità visibile della tabella.

Required?                    false
Position?                    8
Default value                standard
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-PageSize

La dimensione predefinita della pagina.

Required?                    false
Position?                    9
Default value                5
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-RowsPerPageOptions <Int32[]>

Un array di dimensioni di pagina.

Required?                    false
Position?                    10
Default value                @(5, 10, 25)
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ShowPagination

Indica se mostrare la paginazione.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-OnSelectionChange

Required?                    false
Position?                    11
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Language

La lingua da utilizzare per il testo nella griglia dati.

Required?                    false
Position?                    12
Default value                en-US
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-LoadDetailContent

Un blocco di script che viene chiamato quando le righe vengono espanse. $EventData conterrà i dati della riga.

Required?                    false
Position?                    13
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-DetailHeight

L'altezza statica del riquadro dei dettagli.

Required?                    false
Position?                    14
Default value                auto
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-OnEdit

Un blocco di script che viene chiamato quando la riga viene modificata. $EventData includerà i dati modificati. Restituisca un oggetto per aggiornare la riga della griglia dati.

Required?                    false
Position?                    15
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-OnExport

Un blocco di script che viene chiamato quando i dati vengono esportati.

Required?                    false
Position?                    16
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ShowQuickFilter

Mostra una casella di filtro rapido (ricerca).

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-DefaultSortColumn

La colonna predefinita in base alla quale ordinare.

Required?                    false
Position?                    17
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-DefaultSortDirection

La direzione di ordinamento predefinita.

Required?                    false
Position?                    18
Default value                asc
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-DisableRowSelectionOnClick

Disabilita la selezione della riga al clic.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-HideExport

Nasconde il pulsante di esportazione.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-RowHeight

L'altezza delle righe.

Required?                    false
Position?                    19
Default value                -1
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-IdentityColumn

La colonna identità per la griglia dati.

Required?                    false
Position?                    20
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-StripedRows

Indica se utilizzare colori a righe alternate.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-HeaderFilters

Indica se mostrare i filtri nelle intestazioni delle colonne.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-AutoSizeColumns

Dimensiona automaticamente le colonne.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ExportOptions <String[]>

Required?                    false
Position?                    21
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

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: griglia dati di base

New-UDDataGrid -LoadRows {
    $Data = @(
        @{ Name = 'Adam'; Number = Get-Random}
        @{ Name = 'Tom'; Number = Get-Random}
        @{ Name = 'Sarah'; Number = Get-Random}
    )
    @{
        rows = $Data
        rowCount = $Data.Length
    }
} -Columns @(
    New-UDDataGridColumn -Field 'Name'
    New-UDDataGridColumn -Field 'Number'
) -Id 'dataGrid1'

Crea una griglia dati di base con colonne.

Esempio 2

New-UDDataGrid -LoadRows {
    $Data = 1..1000 | ForEach-Object {
        @{ Name = "User$($_)"; Number = Get-Random }
    }
    Out-UDDataGridData -Data $Data -Total $Data.Length -Context $EventData
} -Columns @(
    New-UDDataGridColumn -Field 'Name'
    New-UDDataGridColumn -Field 'Number'
) -Pagination -Id 'dataGrid2'

Out-UDDataGridData|Adds support for filtering, sorting, and paging.

Esempio 3: Render

New-UDDataGrid -LoadRows {
    $Data = 1..100 | % {
        @{ Name = 'Adam'; Number = Get-Random}
    }
    Out-UDDataGridData -Data $Data -Total $Data.Length -Context $EventData

} -Columns @(
    New-UDDataGridColumn -Field 'Name' -Render {
        New-UDAlert -Text $EventData.Name -Dense
    }
    New-UDDataGridColumn -Field 'Number'
) -Pagination -Id 'dataGrid3'

Aggiunge il supporto per il rendering personalizzato delle colonne.

Esempio 4: contenuto dettagliato

New-UDDataGrid -LoadRows {
    $Data = @(
        @{ Name = 'Adam'; Number = Get-Random }
        @{ Name = 'Tom'; Number = Get-Random }
        @{ Name = 'Sarah'; Number = Get-Random }
    )
    @{
        rows     = $Data
        rowCount = $Data.Length
    }
} -Columns @(
    New-UDDataGridColumn -Field 'Name'
    New-UDDataGridColumn -Field 'Number'
) -LoadDetailContent {
    New-UDAlert -Text $EventData.row.Name
} -Id 'dataGrid4'

Aggiunge il supporto per il contenuto dettagliato.

Esempio 5: modifica

$Cache:Data = @(
    @{ Name = 'Adam'; number = Get-Random }
    @{ Name = 'Tom'; number = Get-Random }
    @{ Name = 'Sarah'; number = Get-Random }
)
New-UDDataGrid -LoadRows {
    $Cache:Data| Out-UDDataGridData -Context $EventData -TotalRows $Cache:Data.Length
} -Columns @(
    New-UDDataGridColumn -Field name -Render {
        New-UDButton -Text $EventData.number
    }
    New-UDDataGridColumn -Field number -Editable
) -AutoHeight $true -OnEdit {
    $Cache:Data | Where-Object { $_.Name -eq $EventData.NewRow.Name } | ForEach-Object {
        $_.Number = $EventData.NewRow.Number
    }
} -Id 'datagrid5'

Aggiunge il supporto per la modifica delle righe.

Esempio 6

New-UDDataGrid -LoadRows {
    $Data = @(
        @{ Name = 'Adam'; number = Get-Random }
        @{ Name = 'Tom'; number = Get-Random }
        @{ Name = 'Sarah'; number = Get-Random }
    )
    @{
        rows     = $Data
        rowCount = $Data.Length
    }
} -Columns @(
    New-UDDataGridColumn -Field 'Name' -HeaderName 'A Name' -Flex 1 -HeaderAlign 'center' -Align 'center' -DisableColumnMenu
    New-UDDataGridColumn -Field 'Number' -HeaderName 'A Number' -Flex 1 -HeaderAlign 'right' -Align 'right' -DisableColumnMenu
) -Id 'dataGrid6'

Opzioni delle colonne|

Esempio 7: selezione

New-UDDataGrid -LoadRows {
    $Data = @(
        @{ Id = 1; Name = 'Adam'; number = Get-Random }
        @{ Id = 2; Name = 'Tom'; number = Get-Random }
        @{ Id = 3; Name = 'Sarah'; number = Get-Random }
    )
    @{
        rows     = $Data
        rowCount = $Data.Length
    }
} -Columns @(
    New-UDDataGridColumn -Field 'Name' -HeaderName 'A Name' -Flex 1 -HeaderAlign 'center' -Align 'center' -DisableColumnMenu
    New-UDDataGridColumn -Field 'Number' -HeaderName 'A Number' -Flex 1 -HeaderAlign 'right' -Align 'right' -DisableColumnMenu
) -Id 'dataGrid7' -CheckboxSelection -CheckboxSelectionVisibleOnly -DisableRowSelectionOnClick

Aggiunge il supporto per la selezione delle righe.