Selectores

Casi todo lo que el usuario "elige" en Dinaup pasa por uno de estos componentes. La pregunta de fondo siempre es la misma: ¿de dónde salen las opciones? De ahí cuelga todo lo demás. No fuerces un componente equivocado: cada uno está pensado para un origen de datos distinto y mezclarlos te trae problemas de rendimiento o de UX.

Antes de mirar props, decide cuál te toca con la regla de los 3 segundos.

Regla de los 3 segundos

Los tres últimos de esta página (DnzDropDown, DnzSearchInput, DnzItemPickerDialog) son piezas de apoyo: el dropdown de datos en su versión cruda, la caja de búsqueda con debounce que monta el selector remoto por dentro, y un picker en diálogo para cuando no quieres un desplegable embebido sino una ventana de selección.

DnzEnumDropDown

Desplegable directo sobre un enum de C#. No le pasas opciones: las saca del propio tipo, y usa el [Display(Name=...)] de cada valor como texto visible si lo tiene.

<DnzEnumDropDown TEnum="EstadoPedidoE" @bind-Value=@estadoPedido Placeholder="Selecciona estado" />

@code {
    EstadoPedidoE estadoPedido = EstadoPedidoE.Pendiente;
}

DnzDataGridDropDown

Selector para una lista que ya tienes en memoria. Le pasas la colección por Data, le dices qué propiedad pintar con TextProperty, y él monta un desplegable con buscador, columna y acciones (limpiar, abrir ficha, añadir). El tipo T tiene que implementar IDinaupRow.

<DnzDataGridDropDown T="APIImpuestosC.APIImpuestos_RowC" Label="Impuestos" IsRequired=true TextProperty=@nameof(APIImpuestosC.APIImpuestos_RowC.TextoPrincipal) Data=@impuestos.Values @bind-Value=@impuestoSeleccionado @bind-Value:after=@(async () => await Recalcular()) Style="width:100%" />

Con color por estado (badge automático) y columnas a medida:

<DnzDataGridDropDown T="EstadoPedidoRow" Label="Estado" TextProperty=@nameof(EstadoPedidoRow.Nombre) ColorProperty=@nameof(EstadoPedidoRow.Color) Data=@estados @bind-Value=@estado />

DnzRowSelector

No le pasas Data: le das un ReportId (el informe de la sección) y un Client, y él busca contra el servidor con paginación. Para catálogos grandes —clientes, productos, proveedores— donde cargar todo en memoria no tiene sentido.

<DnzRowSelector Client=@SessionPlay Label="Cliente" ReportId=@EntidadesD._SectionID @bind-SelectedRow=@cliente AdvancedFilter=@filtro OnAdd=@CrearCliente />

Hay dos formas de decirle "ya hay algo seleccionado" al cargar, y eligen entre una consulta o ninguna:

<DnzRowSelector Client=@SessionPlay Label="Cliente" ReportId=@EntidadesD._SectionID @bind-SelectedRow=@cliente />

<DnzRowSelector Client=@SessionPlay Label="Cliente" ReportId=@EntidadesD._SectionID DefaultID=@clienteId @bind-SelectedRow=@cliente />

DnzDropDown

La versión cruda del desplegable de datos sobre IDinaupRow, sin la capa de overlay de acciones ni resolución de color/icono de DnzDataGridDropDown. En la práctica usa DnzDataGridDropDown; este queda para casos donde quieras el grid pelado. Igual que aquel, TextProperty es obligatorio.

<DnzDropDown T="APIAlmacenes_RowC" Label="Almacén" TextProperty=@nameof(APIAlmacenes_RowC.TextoPrincipal) Data=@almacenes.Values @bind-Selected=@almacenSeleccionado />

DnzSearchInput

Caja de búsqueda con icono de lupa y debounce de 500 ms. No es un selector: es la pieza que dispara el filtro sin lanzar una consulta por cada tecla. La usa por dentro DnzRowSelector para buscar contra el informe, y te sirve para tu propio buscador sobre una lista o un informe.

<DnzSearchInput Placeholder="Buscar producto..." BounceValueChanged=@OnBuscar Class="w-100" />

@code {
    async Task OnBuscar(string texto) {
        await CargarResultados(texto);
    }
}

DnzItemPickerDialog

Cuando no quieres un desplegable embebido sino abrir una ventana de selección a pantalla completa sobre un informe. Lo lanzas con OpenAsync y te devuelve la fila elegida (o null si el usuario cierra).

@inject DialogService DialogService

@code {
    async Task ElegirCliente() {
        var fila = await DnzItemPickerDialog.OpenAsync(DialogService, SessionPlay, EntidadesD._SectionID);
        if (fila.IsNotNull()) clienteSeleccionado = fila;
    }
}

El método estático OpenAsync(DialogService, DinaupClientC, string reportId) abre el diálogo (800×600, redimensionable y arrastrable) y devuelve un DinaupDynamicRowDTO con la fila seleccionada, o null si se cancela.

Relacionado: Introducción a DinaZen · Índice de componentes · Informes (Flex) · Cliente Dinaup · Guías de estilo C#/Blazor