DS.Foundation.NHibernate 8.4.4

dotnet add package DS.Foundation.NHibernate --version 8.4.4
                    
NuGet\Install-Package DS.Foundation.NHibernate -Version 8.4.4
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="DS.Foundation.NHibernate" Version="8.4.4" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DS.Foundation.NHibernate" Version="8.4.4" />
                    
Directory.Packages.props
<PackageReference Include="DS.Foundation.NHibernate" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add DS.Foundation.NHibernate --version 8.4.4
                    
#r "nuget: DS.Foundation.NHibernate, 8.4.4"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package DS.Foundation.NHibernate@8.4.4
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=DS.Foundation.NHibernate&version=8.4.4
                    
Install as a Cake Addin
#tool nuget:?package=DS.Foundation.NHibernate&version=8.4.4
                    
Install as a Cake Tool

DS.Foundation.NHibernate

Registra una ISessionFactory y una ISession de NHibernate en el contenedor de DI a partir de un DatabaseAccessPointOptions, y ofrece una clase base para lógica de negocio que trabaja con una sesión.

  • Target framework: netstandard2.0.
  • Dependencias: DS.Foundation, DS.Foundation.Data, NHibernate 5.6.

Instalación

<PackageReference Include="DS.Foundation.NHibernate" Version="8.4.0" />

Registro

using DS.Foundation.Configuration;
using DS.Foundation.Configuration.Options;
using DS.Foundation.NHibernate;

builder.Services.AddNHibernate(new DatabaseAccessPointOptions
{
    Engine = DbEngine.PostgreSQL,
    ConnectionString = connectionString,
});

AddNHibernate registra:

Servicio Ciclo de vida
ISessionFactory singleton (se construye al llamar a AddNHibernate)
ISession scoped (OpenSession() por scope)
SessionWrapper scoped

SessionFactoryWrapper y NHibernateBusinessLogicManager no se registran: créelos o regístrelos usted.

Configuración

Propiedad de DatabaseAccessPointOptions Uso
Engine SqlServer (dialecto MsSql2008Dialect) o PostgreSQL (PostgreSQLDialect). Otros motores no configuran dialecto ni conexión.
ConnectionString Cadena de conexión de ADO.NET.

Con PostgreSQL, el SQL generado se escribe en la consola (LogSqlInConsole).

Uso

public class PedidosManager : NHibernateBusinessLogicManager
{
    public PedidosManager(ISession session, ILogger<PedidosManager> logger) : base(session, logger) { }

    public void Guardar(Pedido pedido)
    {
        using (var tx = BeginTransaction())
        {
            GetSession().SaveOrUpdate(pedido);
            tx.Commit();
        }
    }
}

Errores frecuentes

Síntoma Causa Solución
MappingException: No persister for: … AddNHibernate solo agrega los mapeos del ensamblado DS.Foundation.NHibernate, no los de su aplicación Construir su propia Configuration con sus mapeos y registrar la ISessionFactory manualmente
Error al construir la ISessionFactory con MySQL u otro motor Solo SQL Server y PostgreSQL configuran dialecto y conexión Usar uno de esos motores o configurar NHibernate manualmente

Qué no hacer

  • No inyectar ISession en servicios singleton: la sesión es scoped.
  • No dejar LogSqlInConsole activo en producción con PostgreSQL si el SQL contiene datos sensibles; hoy no se puede desactivar desde opciones.

Cambios

Ver CHANGELOG.md.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
8.4.4 37 11/15/2026
8.4.0 111 10/19/2026
8.3.2 104 10/8/2026
8.3.1 133 9/8/2026
8.3.0 174 6/28/2026
8.1.0 361 7/16/2024
8.0.5 315 4/27/2024
8.0.4 307 2/10/2024
8.0.2 307 2/8/2024
6.0.14 387 1/10/2023
6.0.13 356 1/10/2023