Update version and enhance SqlCommandExtensions methods

- Bump `VersionPrefix` from `9.0.2` to `9.0.3`.
- Add `ExecuteReader<T>` and `ExecuteReaderAsync<T>` methods to `SqlCommandExtensions` for improved data reading with transformation functions.
- Implement null checks for parameters in the new methods.
- Enhance documentation for new methods and clarify parameter types.
- Include conditional compilation for compatibility across .NET versions.

Author: electricessence

Source/Directory.Build.props

@@ -3,7 +3,7 @@
 	<PropertyGroup>
 		<RootNamespace>Open.Database.Extensions</RootNamespace>
 
-		<VersionPrefix>9.0.2</VersionPrefix>
+		<VersionPrefix>9.0.3</VersionPrefix>
 		<VersionSuffix Condition="'$(Configuration)' == 'Debug'">debug</VersionSuffix>
 
 		<TargetFrameworks>netstandard2.0; netstandard2.1; net8.0; net9.0;</TargetFrameworks>

Source/MSSqlClient/Extensions/Command.ExecuteReader.cs

@@ -44,6 +44,22 @@ public static void ExecuteReader(this SqlCommand command, Action<SqlDataReader>
 		handler(reader);
 	}
 
+	/// <param name="command">The <see cref="SqlCommand"/> to generate a reader from.</param>
+	/// <param name="transform">The transform function for each <see cref="SqlDataReader"/>.</param>
+	/// <param name="behavior">The behavior to use with the data reader.</param>
+	/// <inheritdoc cref="CommandExtensions.ExecuteReader{T}(IDbCommand, Func{IDataReader, T}, CommandBehavior)"/>
+	public static T ExecuteReader<T>(this SqlCommand command, Func<SqlDataReader, T> transform, CommandBehavior behavior = CommandBehavior.Default)
+	{
+		if (command is null) throw new ArgumentNullException(nameof(command));
+		if (transform is null) throw new ArgumentNullException(nameof(transform));
+		Contract.EndContractBlock();
+
+		ConnectionState state = command.EnsureOpen();
+		if (state == ConnectionState.Closed) behavior |= CommandBehavior.CloseConnection;
+		using SqlDataReader reader = command.ExecuteReader(behavior);
+		return transform(reader);
+	}
+
 	/// <param name="command">The <see cref="SqlCommand"/> to generate a reader from.</param>
 	/// <param name="handler">The handler function for the <see cref="SqlDataReader"/>.</param>
 	/// <param name="behavior">The behavior to use with the data reader.</param>
@@ -92,7 +108,7 @@ public static async ValueTask ExecuteReaderAsync(this SqlCommand command,
 	}
 
 	/// <param name="command">The <see cref="DbCommand"/> to generate a reader from.</param>
-	/// <param name="transform">The transform function for each <see cref="IDataRecord"/>.</param>
+	/// <param name="transform">The transform function the <see cref="DbDataReader"/>.</param>
 	/// <param name="behavior">The behavior to use with the data reader.</param>
 	/// <param name="cancellationToken">The cancellation token.</param>
 	/// <inheritdoc cref="CommandExtensions.ExecuteReaderAsync{T}(DbCommand, Func{DbDataReader, ValueTask{T}}, CommandBehavior, CancellationToken)"/>/>
@@ -117,4 +133,27 @@ public static async ValueTask<T> ExecuteReaderAsync<T>(this SqlCommand command,
 		using SqlDataReader reader = await command.ExecuteReaderAsync(behavior, cancellationToken).ConfigureAwait(false);
 		return transform(reader);
 	}
+
+	/// <inheritdoc cref="ExecuteReaderAsync{T}(SqlCommand, Func{SqlDataReader, T}, CommandBehavior, CancellationToken)"/>
+	public static async ValueTask<T> ExecuteReaderAsync<T>(this SqlCommand command,
+		Func<SqlDataReader, ValueTask<T>> transform,
+		CommandBehavior behavior = CommandBehavior.Default,
+		CancellationToken cancellationToken = default)
+	{
+		if (command is null) throw new ArgumentNullException(nameof(command));
+		if (transform is null) throw new ArgumentNullException(nameof(transform));
+		Contract.EndContractBlock();
+
+		ConnectionState state = await command
+			.EnsureOpenAsync(cancellationToken)
+			.ConfigureAwait(false);
+
+		if (state == ConnectionState.Closed) behavior |= CommandBehavior.CloseConnection;
+#if NET472
+#else
+		await
+#endif
+		using SqlDataReader reader = await command.ExecuteReaderAsync(behavior, cancellationToken).ConfigureAwait(false);
+		return await transform(reader);
+	}
 }

Source/SqlClient/Extensions/Command.ExecuteReader.cs

@@ -44,6 +44,22 @@ public static void ExecuteReader(this SqlCommand command, Action<SqlDataReader>
 		handler(reader);
 	}
 
+	/// <param name="command">The <see cref="SqlCommand"/> to generate a reader from.</param>
+	/// <param name="transform">The transform function for each <see cref="SqlDataReader"/>.</param>
+	/// <param name="behavior">The behavior to use with the data reader.</param>
+	/// <inheritdoc cref="CommandExtensions.ExecuteReader{T}(IDbCommand, Func{IDataReader, T}, CommandBehavior)"/>
+	public static T ExecuteReader<T>(this SqlCommand command, Func<SqlDataReader, T> transform, CommandBehavior behavior = CommandBehavior.Default)
+	{
+		if (command is null) throw new ArgumentNullException(nameof(command));
+		if (transform is null) throw new ArgumentNullException(nameof(transform));
+		Contract.EndContractBlock();
+
+		ConnectionState state = command.EnsureOpen();
+		if (state == ConnectionState.Closed) behavior |= CommandBehavior.CloseConnection;
+		using SqlDataReader reader = command.ExecuteReader(behavior);
+		return transform(reader);
+	}
+
 	/// <param name="command">The <see cref="SqlCommand"/> to generate a reader from.</param>
 	/// <param name="handler">The handler function for the <see cref="SqlDataReader"/>.</param>
 	/// <param name="behavior">The behavior to use with the data reader.</param>
@@ -92,7 +108,7 @@ public static async ValueTask ExecuteReaderAsync(this SqlCommand command,
 	}
 
 	/// <param name="command">The <see cref="DbCommand"/> to generate a reader from.</param>
-	/// <param name="transform">The transform function for each <see cref="IDataRecord"/>.</param>
+	/// <param name="transform">The transform function the <see cref="DbDataReader"/>.</param>
 	/// <param name="behavior">The behavior to use with the data reader.</param>
 	/// <param name="cancellationToken">The cancellation token.</param>
 	/// <inheritdoc cref="CommandExtensions.ExecuteReaderAsync{T}(DbCommand, Func{DbDataReader, ValueTask{T}}, CommandBehavior, CancellationToken)"/>/>
@@ -117,4 +133,27 @@ public static async ValueTask<T> ExecuteReaderAsync<T>(this SqlCommand command,
 		using SqlDataReader reader = await command.ExecuteReaderAsync(behavior, cancellationToken).ConfigureAwait(false);
 		return transform(reader);
 	}
+
+	/// <inheritdoc cref="ExecuteReaderAsync{T}(SqlCommand, Func{SqlDataReader, T}, CommandBehavior, CancellationToken)"/>
+	public static async ValueTask<T> ExecuteReaderAsync<T>(this SqlCommand command,
+		Func<SqlDataReader, ValueTask<T>> transform,
+		CommandBehavior behavior = CommandBehavior.Default,
+		CancellationToken cancellationToken = default)
+	{
+		if (command is null) throw new ArgumentNullException(nameof(command));
+		if (transform is null) throw new ArgumentNullException(nameof(transform));
+		Contract.EndContractBlock();
+
+		ConnectionState state = await command
+			.EnsureOpenAsync(cancellationToken)
+			.ConfigureAwait(false);
+
+		if (state == ConnectionState.Closed) behavior |= CommandBehavior.CloseConnection;
+#if NETSTANDARD2_0
+#else
+		await
+#endif
+		using SqlDataReader reader = await command.ExecuteReaderAsync(behavior, cancellationToken).ConfigureAwait(false);
+		return await transform(reader);
+	}
 }