Skip to content

Commit

Permalink
Merge pull request #5592 from EnterpriseDB/content/docs/net_connector…
Browse files Browse the repository at this point in the history
…/net_connector_8_release

.Net Connector - 8.0 Release branch
  • Loading branch information
nidhibhammar authored May 15, 2024
2 parents 2446f13 + 2dae1ac commit 345712a
Show file tree
Hide file tree
Showing 27 changed files with 2,277 additions and 0 deletions.
16 changes: 16 additions & 0 deletions product_docs/docs/net_connector/8.0/01_release_notes.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
title: "Release notes"
---

Released: 15 May 2024

The EDB .NET Connector provides connectivity between a .NET client application and an EDB Postgres Advanced Server database server.

New features, enhancements, bug fixes, and other changes in the EDB .NET Connector `8.0` include:

| Type | Description |
|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Upstream merge | Merged with community .NET driver version 8.0.2. See [release notes](https://www.npgsql.org/doc/release-notes/8.0.html) for more information about merge updates. |
| Security fix | Fixed an security issue [CVE-2024-32655](https://github.com/advisories/GHSA-x9vc-6hfv-hg8c). This security fix, fixes the Npgsql that was vulnerable to SQL injection via protocol message size overflow. |
| Bug fix | Fixed an issue for SPL CALLS. SPL CALLs with output parameters are now returning DataReader with a row of parameters on the batch commands. |
| Bug fix | EnableErrorBarriers is now functional on the batch commands. See [EnableErrorBarries docs](https://www.npgsql.org/doc/api/Npgsql.NpgsqlBatchCommand.html#Npgsql_NpgsqlBatchCommand_AppendErrorBarrier) for more information. |
20 changes: 20 additions & 0 deletions product_docs/docs/net_connector/8.0/02_requirements_overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "Product compatibility"
---

<div id="requirements_overview" class="registered_link"></div>

These are the supported versions and platforms for the EDB .NET Connector.

The EDB .NET Connector is certified with EDB Postgres Advanced Server version 11 and later.

The EDB .NET Connector graphical installers are supported on the following Windows platforms:

64-bit Windows:

- Windows Server 2019 and 2022
- Windows 10 and 11

32-bit Windows:

- Windows 10
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
title: "EDB .NET Connector overview"

---

<div id="the_advanced_server_net_connector_overview" class="registered_link"></div>

EDB .NET Connector is a .NET data provider that allows a client application to connect to a database stored on an EDB Postgres Advanced Server host. The .NET Connector accesses the data directly, allowing the client application optimal performance, a broad spectrum of functionality, and access to EDB Postgres Advanced Server features.

The .NET Connector supports the following frameworks:

- .NET 8.0
- .NET 7.0
- .NET 6.0
- .NET Framework 4.7.2, 4.8, and 4.8.1
- .NET Standard 2.0 and 2.1


## The .NET class hierarchy

The .NET class hierarchy contains classes that you can use to create objects that control a connection to the EDB Postgres Advanced Server database and manipulate the data stored on the server. The following are a few of the most commonly used object classes.

`EDBDataSource`

`EDBDataSource` is the entry point for all the connections made to the database. It's responsible for issuing connections to the server and efficiently managing them. Starting with EDB .NET Connector 7.0.4.1, you no longer need direct instantiation of `EDBConnection`. Instantiate `EDBDataSource` and use the method provided to create commands or execute queries.

`EDBConnection`

The `EDBConnection` class represents a connection to EDB Postgres Advanced Server. An `EDBConnection` object contains a `ConnectionString` that tells the .NET client how to connect to an EDB Postgres Advanced Server database. Obtain `EDBConnection` from an `EDBDataSource` instance, and use it directly only in specific scenarios, such as transactions.

`EDBCommand`

An `EDBCommand` object contains an SQL command that the client executes against EDB Postgres Advanced Server. Before you can execute an `EDBCommand` object, you must link it to an `EDBConnection` object.

`EDBDataReader`

An `EDBDataReader` object provides a way to read an EDB Postgres Advanced Server result set. You can use an `EDBDataReader` object to step through one row at a time, forward only.

`EDBDataAdapter`

An `EDBDataAdapter` object links a result set to the EDB Postgres Advanced Server database. You can modify values and use the `EDBDataAdapter` class to update the data stored in an EDB Postgres Advanced Server database.
Loading

0 comments on commit 345712a

Please sign in to comment.