NestXRepository.Core 1.0.8

Documentación de Métodos de Acceso a Datos

Esta documentación detalla los métodos disponibles para operaciones de acceso a datos en nuestra biblioteca .NET. La biblioteca ofrece dos enfoques principales para el acceso a datos:

1. Dapper (DP): Métodos optimizados para consultas SQL directas y alto rendimiento
2. Entity Framework (EF): Métodos que aprovechan el contexto y funcionalidades de Entity Framework Core

Tabla de Contenidos

• Métodos de Consulta
  • Métodos Dapper
  • Métodos Entity Framework
• Métodos de Manipulación
  • Métodos de Inserción
  • Métodos de Actualización
  • Métodos de Eliminación
• Procedimientos Almacenados
• Operaciones Especiales

Métodos de Consulta

Métodos de Consulta Dapper

Métodos de Consulta Entity Framework

Métodos de Manipulación

Métodos de Inserción

Métodos de Actualización

Métodos de Eliminación

Procedimientos Almacenados

Ejemplos de Uso

Consultas Básicas

// Ejemplo con Dapper: Obtener todos los registros de una tabla
var allRecords = await DPGetAll();

// Ejemplo con Entity Framework: Obtener registros que cumplen una condición
var activeUsers = await EFGetAllAsync(u => u.IsActive);

// Consulta con paginación usando Dapper
var paginatedResult = await DPGetPaginatedAsync(1, 10, "IsActive = @IsActive", new { IsActive = true });

Operaciones de Manipulación

// Insertar un registro usando Entity Framework
var newEntityId = await EFAdd(newEntity);

// Actualizar un registro con Dapper
await DPUpdate(updatedEntity, e => e.Id == updatedEntity.Id);

// Eliminación lógica con Entity Framework
await EFSoftDelete(entityToDelete, currentUser);

Procedimientos Almacenados

// Ejecutar un procedimiento almacenado con parámetros
var results = await DPCallStoredProc("GetCustomersByRegion", new { RegionId = 5 });

// Ejecutar un procedimiento almacenado que realice alguna operación
var rowsAffected = await DPExecuteStoredProc("UpdateInventoryLevels", new { ProductId = 10, Quantity = 50 });

Notas Adicionales

• Los métodos con prefijo DP utilizan Dapper, un micro-ORM de alto rendimiento.
• Los métodos con prefijo EF utilizan Entity Framework Core, un ORM completo.
• Los métodos con sufijo WithFK incluyen operaciones con claves foráneas.
• Los métodos SoftDelete realizan un borrado lógico (establecen un flag) en lugar de eliminar físicamente los registros.
• El parámetro genérico T representa el tipo de entidad con la que se trabaja.

Dependencias y Atribuciones

Este paquete requiere .NET 9 o superior para funcionar correctamente.

Este proyecto utiliza las siguientes bibliotecas de código abierto:

• Entity Framework Core - Copyright (c) .NET Foundation y contribuyentes, bajo licencia MIT
• Dapper - Copyright (c) Sam Saffron, Marc Gravell, Nick Craver, bajo licencia MIT

Requisitos del Sistema

• .NET 9.0 o superior
• Compatible con aplicaciones web, de escritorio y servicios
• Fue inicialmente destinado a base de datos SQL server