New-UDTable
Sinopsis
Crea una tabla.
Sintaxis
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>]Descripción
Crea una tabla. Las tablas se usan para mostrar datos tanto estáticos como dinámicos. Puede definir las columnas y los datos que se mostrarán en la tabla. Las columnas se pueden usar para representar componentes personalizados basados en los datos de la fila. También puede habilitar la paginación, el filtrado, la ordenación e incluso el procesamiento en el lado del servidor.
Parámetros
-Id
El ID del componente. De forma predeterminada, es un GUID aleatorio.
Required? false
Position? named
Default value [Guid]::NewGuid().ToString()
Accept pipeline input? false
Aliases
Accept wildcard characters? false-Title
El título que se muestra en la parte superior de la tarjeta de la tabla.
-Data <Object[]>
Los datos que se colocarán en la tabla.
-LoadRows
Cuando se usan tablas dinámicas, se llama a este bloque de script. El parámetro $Body contendrá una tabla hash con las siguientes opciones:
filters: @() orderBy: string orderDirection: string page: int pageSize: int properties: @() search: string totalCount: int
Puede usar estos valores para realizar procesamiento en el lado del servidor, como consultas SQL, para mejorar el rendimiento de las cuadrículas grandes.
Después de procesar los datos con estos valores, muestre los datos mediante Out-UDTableData.
-Columns <Hashtable[]>
Define las columnas que se mostrarán en la tabla. Use New-UDTableColumn para definir estas columnas. Si no se especifica este parámetro, las propiedades de los datos que pase se convertirán en las columnas.
-OnRowSelection
Un bloque de script al que se llama cuando se selecciona una fila. $EventData contendrá las filas seleccionadas.
-ShowSort
Si se muestran los controles de ordenación en las columnas
-ShowFilter
Si se muestran los controles de filtro en las columnas
-ShowSearch
Si se muestra la búsqueda de la tabla completa
-Dense
Reduce el espacio en blanco usado dentro de la tabla.
-ShowExport
Si se muestra el botón de exportación.
-StickyHeader
Hace que el encabezado sea fijo.
-PageSize
El tamaño de página predeterminado.
-PageSizeOptions <Int32[]>
Una matriz de opciones de tamaño de página disponibles.
-PaginationLocation
Dónde mostrar los controles de paginación. Los valores válidos son top, bottom o both. El valor predeterminado es bottom.
-ShowSelection
Si se permite la selección dentro de la tabla.
-ShowPagination
Si se muestran los controles de paginación.
-Padding
-Size
El tamaño de la tabla. El valor predeterminado es medium. Los valores válidos son medium y small.
-TextOption
Personalizaciones del texto estándar dentro de la tabla. Use New-UDTextOption para crear las opciones de texto.
-ExportOption <String[]>
Una matriz de opciones de exportación.
-OnExport
Un bloque de script usado para personalizar cómo se realiza la exportación.
-DisablePageSizeAll
Elimina la opción All de las opciones de tamaño de página.
-DefaultSortDirection
La dirección de ordenación predeterminada.
-HideToggleAllRowsSelected
Oculta el botón para alternar la selección de todas las filas.
-DisableMultiSelect
Deshabilita la selección múltiple.
-DisableSortRemove
Elimina la opción de ordenación para las columnas sin ordenar. Las columnas siempre estarán en orden ascendente o descendente.
-Icon
Establece un icono junto al título. Use New-UDIcon para crear el icono.
-ClassName
Una clase CSS que se aplica a la tabla.
-ShowRefresh
Si se muestra el botón de actualización.
-ToolbarContent
Contenido personalizado que se muestra en la barra de herramientas.
-OnRowExpand
Un bloque de script al que se llama cuando se expande una fila. La variable $EventData contendrá los datos de la fila.
-MaxHeight
-AutoRefresh
Vuelve a cargar la tabla en un intervalo cuando se usa -LoadRows.
-AutoRefreshInterval
El intervalo para volver a cargar los datos cuando se especifica AutoRefresh.
-Language
El idioma. Se usa principalmente para los filtros de fecha y hora.
-RemoveCard
-OnRowStyle
Un bloque de script al que se llama para aplicar estilo a las filas. La variable $EventData contendrá los datos de la fila.
-HeaderStyle
Una tabla hash de estilos que se aplican al encabezado.
-InitialState
Parámetros comunes
Este cmdlet admite los parámetros comunes: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable y OutVariable. Para más información, consulte about_CommonParameters.
Salidas
Ejemplos
Ejemplo 1: tabla básica
Crea una tabla estática en la que las columnas de la tabla son las propiedades de los datos especificados.
Ejemplo 2: columnas
Crea una tabla en la que se definen columnas personalizadas para esa tabla.
Ejemplo 3: representación
Crea una tabla en la que las columnas se representan con contenido personalizado.
Ejemplo 4: ancho de columna
Establecer un ancho de columna personalizado
Ejemplo 5: filtro de columna
Filtros de columnas para una tabla
Ejemplo 6: búsqueda de columna
Las columnas se pueden incluir en la búsqueda
Ejemplo 7
Ejemplo 8: paginación
La paginación se puede habilitar estableciendo el parámetro -Paging en $true. El tamaño de página predeterminado es 10.
Ejemplo 9: expansión de filas
La expansión de filas se puede habilitar estableciendo el parámetro -OnRowExpand en un bloque de script. Al bloque de script se le pasarán los datos de la fila como una tabla hash en la variable $EventData.
Ejemplo 10: exportación
Exporte los datos de la tabla con el parámetro -Export. Puede configurar qué columnas se incluyen en la exportación estableciendo el parámetro -IncludeInExport en la columna. Use -Hidden para ocultar una columna de la tabla pero incluirla en la exportación.
Ejemplo 11: opciones de texto
Las opciones de texto se pueden usar para personalizar el texto de la tabla.
Ejemplo 12: estilo de filas
Puede aplicar estilo a las filas mediante el parámetro -OnRowStyle. Al bloque de script se le pasarán los datos de la fila como una tabla hash en la variable $EventData. El bloque de script debe devolver una tabla hash de estilos CSS que se aplicarán a la fila.
Ejemplo 13: ordenación predeterminada
Establecer la dirección de ordenación y la columna predeterminadas.
Ejemplo 14: estado inicial
Establecer el estado inicial de la tabla. Esto se puede usar para establecer el índice de página, el tamaño de página, los filtros y la columna de ordenación.
Ejemplo 15: coloración de filas
Use OnRowStyle para aplicar estilo a las filas según los datos de la fila.
Última actualización
¿Te fue útil?