CoreUtilerias 2025.5.25

DotNet.ExtensionsToolkit

Extensiones utilitarias para facilitar el manejo de datos, seguridad y construcción de parámetros en .NET. Incluye herramientas para IDataReader, DataTable, DataRow, cifrado AES, y generación de QueryString.

📦 Contenido

🧩 DataReaderExtensions

Extensiones para IDataReader que permiten acceder a columnas por nombre y convertirlas de forma segura.

• GetInt32
• GetString
• GetDecimal
• GetDate
• GetGuid
• GetBoolean
• GetDouble
• GetBytes
• GetItem<T>() — Convierte una fila del reader en un objeto del tipo T.

📊 DataTableExtensions

Permiten convertir objetos o listas de objetos a DataTable y viceversa, además de otras utilidades para manipulación de tablas en memoria.

Conversión

• ToDataTable<T>(IEnumerable<T>) — Convierte una lista de objetos a un DataTable.
• ToDataTable<T>(T item) — Convierte un solo objeto a un DataTable de una fila.
• ToDataList<T>(DataTable) — Convierte un DataTable a una lista de objetos del tipo T.

Manipulación

• AddColumnIfNotExist(string columnName, Type type) — Agrega una columna si no existe.
• ToDictionary() — Convierte cada fila del DataTable en un diccionario Dictionary<string, object>.

Validación de tipos

• IsPrimitive(Type) — Retorna si un tipo es primitivo o simple.
• GuardIsPrimitive<T>() — Lanza excepción si el tipo es primitivo o string.

🏷 Nombres de tabla temporales en SQL Server

• GetTableNameLocal()
  Devuelve un nombre de tabla temporal local (solo visible en la sesión actual).
  Ejemplo: #Usuarios

  DataTable table = new DataTable("Usuarios");
  string localName = table.GetTableNameLocal(); // "#Usuarios"
  

🧾 DataRowExtensions

Extensiones para acceder con seguridad a los datos de una fila DataRow.

• GetInt32
• GetString
• GetDecimal
• GetDate
• GetGuid
• GetObject
• GetBoolean
• GetDouble
• GetBytes
• GetItem<T>() — Mapea automáticamente una fila en un objeto T.

🔐 SecurityAes

Clase de cifrado simétrico basada en AES.

• Encrypt(string) — Cifra un texto plano en Base64, embebiendo el IV generado.
• Decrypt(string) — Descifra un texto previamente cifrado.
• Usa una clave fija (CypherPattern) de 16, 24 o 32 caracteres.

⚠️ Para mayor seguridad, considera extraer la clave de un almacén seguro como Azure Key Vault.

🌐 QueryStringExtensions

Utilidad para convertir un objeto en un conjunto de parámetros tipo query string.

• BindFrom<T>(T parameters)
  Convierte las propiedades no nulas de un objeto T en un diccionario Dictionary<string, string>.
  Si la propiedad es DateTime, se serializa como "yyyy-MM-dd".

Ejemplo:

var filtros = new { Nombre = "Juan", Edad = 30, Fecha = DateTime.Today };
var queryParams = QueryStringExtensions.BindFrom(filtros);

// Resultado:
// {
//   ["Nombre"] = "Juan",
//   ["Edad"] = "30",
//   ["Fecha"] = "2025-05-14"
// }