[add] Port support to MsSql connection settings

Author: i4004

src/Simplify.FluentNHibernate.Tests/ConfigurationExtensionsTests.cs

@@ -1,5 +1,6 @@
 using FluentNHibernate.Cfg;
 using Microsoft.Extensions.Configuration;
+using NHibernate.Cfg;
 using NHibernate.Dialect;
 using NUnit.Framework;
 
@@ -60,6 +61,34 @@ public void InitializeFromConfigMsSql_CorrectConfig_NoExceptions()
 		Fluently.Configure().InitializeFromConfigMsSql(_configuration);
 	}
 
+	[Test]
+	public void InitializeFromConfigMsSql_PortConfigured_ConnectionStringContainsPort()
+	{
+		// Arrange & Act
+		Configuration config = null;
+		Fluently.Configure()
+			.InitializeFromConfigMsSql(_configuration)
+			.ExposeConfiguration(c => config = c)
+			.BuildConfiguration();
+
+		// Assert
+		Assert.That(config.GetProperty(Environment.ConnectionString), Does.Contain("localhost,1231"));
+	}
+
+	[Test]
+	public void InitializeFromConfigMsSqlMicrosoftDriver_PortConfigured_ConnectionStringContainsPort()
+	{
+		// Arrange & Act
+		Configuration config = null;
+		Fluently.Configure()
+			.InitializeFromConfigMsSqlMicrosoftDriver(_configuration)
+			.ExposeConfiguration(c => config = c)
+			.BuildConfiguration();
+
+		// Assert
+		Assert.That(config.GetProperty(Environment.ConnectionString), Does.Contain("localhost,1231"));
+	}
+
 	[Test]
 	public void InitializeFromConfigSqLiteInMemory_CorrectConfig_NoExceptions()
 	{

src/Simplify.FluentNHibernate.Tests/SessionFactoryBuilderBaseTests.cs

@@ -26,6 +26,6 @@ public void ConnectionString_MsSql_CorrectConnectionString()
 		var result = builder.ConnectionString;
 
 		// Assert
-		Assert.That(result, Is.EqualTo("Data Source=localhost;Initial Catalog=foodatabase;Integrated Security=False;User ID=foouser;Password=foopassword"));
+		Assert.That(result, Is.EqualTo("Data Source=localhost,1231;Initial Catalog=foodatabase;Integrated Security=False;User ID=foouser;Password=foopassword"));
 	}
 }

src/Simplify.FluentNHibernate/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [3.5.0] - 2026-08-19
+
+### Added
+
+- `Port` connection setting support for `InitializeFromConfigMsSql` — since FluentNHibernate's connection string builder has no port property, a raw connection string with the `Data Source=host,port` format is used whenever the port is explicitly configured
+
 ## [3.4.0] - 2026-07-09
 
 ### Added

src/Simplify.FluentNHibernate/ConfigurationExtensions.cs

@@ -437,11 +437,16 @@ private static void InitializeFromConfigMsSql(FluentConfiguration fluentConfigur
 			_ => throw new InvalidOperationException()
 		};
 
-		clientConfiguration.ConnectionString(c => c
-			.Server(settings.ServerName)
-			.Database(settings.DataBaseName)
-			.Username(settings.UserName)
-			.Password(settings.UserPassword ?? throw new ArgumentException($"{nameof(settings.UserPassword)} is null")));
+		// FluentNHibernate's connection string builder has no Port support,
+		// so a raw connection string is required whenever the port is explicitly configured.
+		if (settings.Port.HasValue)
+			clientConfiguration.ConnectionString(BuildMsSqlRawConnectionString(settings));
+		else
+			clientConfiguration.ConnectionString(c => c
+				.Server(settings.ServerName)
+				.Database(settings.DataBaseName)
+				.Username(settings.UserName)
+				.Password(settings.UserPassword ?? throw new ArgumentException($"{nameof(settings.UserPassword)} is null")));
 
 		additionalClientConfiguration?.Invoke(clientConfiguration);
 
@@ -450,6 +455,22 @@ private static void InitializeFromConfigMsSql(FluentConfiguration fluentConfigur
 		PerformCommonInitialization(fluentConfiguration, settings.ShowSql, settings.ShowSqlOutputType);
 	}
 
+	private static string BuildMsSqlRawConnectionString(DbConnectionSettings settings)
+	{
+		var password = settings.UserPassword ?? throw new ArgumentException($"{nameof(settings.UserPassword)} is null");
+
+		var connectionString = settings.Port.HasValue
+			? $"Data Source={settings.ServerName},{settings.Port.Value}"
+			: $"Data Source={settings.ServerName}";
+
+		connectionString += $";Initial Catalog={settings.DataBaseName}";
+		connectionString += ";Integrated Security=False";
+		connectionString += $";User ID={settings.UserName}";
+		connectionString += $";Password={password}";
+
+		return connectionString;
+	}
+
 	#endregion MS SQL
 
 	#region MS SQL Microsoft Driver

src/Simplify.FluentNHibernate/Simplify.FluentNHibernate.csproj

@@ -8,7 +8,7 @@
 		<SymbolPackageFormat>snupkg</SymbolPackageFormat>
 		<GenerateDocumentationFile>true</GenerateDocumentationFile>
 
-		<Version>3.4</Version>
+		<Version>3.5</Version>
 
 		<Description>Simplifies FluentNHibernate connection configuration and allows you to write data-base queries with lambda expressions</Description>
 		<Product>Simplify</Product>