MVFC.DataX.Providers.Postgres
1.2.2
dotnet add package MVFC.DataX.Providers.Postgres --version 1.2.2
NuGet\Install-Package MVFC.DataX.Providers.Postgres -Version 1.2.2
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="MVFC.DataX.Providers.Postgres" Version="1.2.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="MVFC.DataX.Providers.Postgres" Version="1.2.2" />
<PackageReference Include="MVFC.DataX.Providers.Postgres" />
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 MVFC.DataX.Providers.Postgres --version 1.2.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: MVFC.DataX.Providers.Postgres, 1.2.2"
#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 MVFC.DataX.Providers.Postgres@1.2.2
#: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=MVFC.DataX.Providers.Postgres&version=1.2.2
#tool nuget:?package=MVFC.DataX.Providers.Postgres&version=1.2.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
MVFC.DataX.Providers.Postgres
PostgreSQL data provider for MVFC.DataX, implementing readers and writers via Npgsql.
This package is part of the MVFC.DataX suite. For the full documentation and more examples, please check the main repository README.
Installation
dotnet add package MVFC.DataX.Providers.Postgres
Available Classes
| Class | Description |
|---|---|
PostgresDataReader<T> |
Reads data from PostgreSQL utilizing NpgsqlDataReader via a mapper function. |
PostgresDataWriter<T> |
Writes data to PostgreSQL using parameterized queries. Supports WriteBatchAsync with transactions and automatic rollback on failure. |
API Signatures
PostgresDataReader<T>
public PostgresDataReader(
string connectionString,
string query,
Func<NpgsqlDataReader, T> mapper,
Action<NpgsqlCommand>? configureCommand = null)
PostgresDataWriter<T>
public PostgresDataWriter(
string connectionString,
string commandText,
Action<NpgsqlCommand, T> bindParameters)
Usage / Example
This example demonstrates how to read a User entity from a Postgres database and copy it into an ImportedUser table. Note how bindParameters securely mitigates SQL Injection by pushing parameters into the NpgsqlCommand.
using MVFC.DataX.Pipeline;
using MVFC.DataX.Providers.Postgres;
using Npgsql;
var connectionString = "Host=localhost;Username=test;Password=test;Database=testdb";
// 1. Setup the Postgres Reader
var reader = new PostgresDataReader<User>(
connectionString,
"SELECT Id, Name, Email FROM Users WHERE IsActive = true",
// Map the NpgsqlDataReader into your C# object
mapper: r => new User
{
Id = r.GetInt32(0),
Name = r.GetString(1),
Email = r.GetString(2)
}
);
// 2. Setup the Postgres Writer
var writer = new PostgresDataWriter<User>(
connectionString,
"INSERT INTO ImportedUsers (OriginalId, Name, Email) VALUES (@Id, @Name, @Email)",
// Bind your C# object's properties to the NpgsqlCommand parameters
bindParameters: (command, user) =>
{
command.Parameters.AddWithValue("Id", user.Id);
command.Parameters.AddWithValue("Name", user.Name);
command.Parameters.AddWithValue("Email", user.Email);
}
);
// 3. Orchestrate with PipelineBuilder
var pipeline = PipelineBuilder.ReadFrom(reader)
.WriteTo(writer)
.WithBatchSize(100) // Writes will be grouped into transactions of 100 inserts each
.Build();
await pipeline.RunAsync(cancellationToken);
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net9.0 is compatible. 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 is compatible. 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. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- MVFC.DataX.Core (>= 1.2.2)
- Npgsql (>= 10.0.3)
-
net9.0
- MVFC.DataX.Core (>= 1.2.2)
- Npgsql (>= 10.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.