从旧版本升级

此页面包含驱动程序从 4.4 版到 5.x 版的新功能和重大更改列表。有关完整的更改列表，请参阅驱动程序 → 变更日志。

5.x 系列的最新驱动程序版本（5.28）兼容 Neo4j 服务器 4.4 和 5.x，因此您可以在升级服务器之前升级驱动程序。同时，驱动程序版本 4.4 向前兼容 Neo4j 服务器 5.x，因此您也可以在升级驱动程序之前升级服务器；但是，考虑到回滚应用程序升级比回滚服务器升级更容易，建议从驱动程序开始。

将 Neo4j 服务器升级到新版本时，应用程序中的 Cypher 查询可能也需要更新。
请参阅Cypher → 弃用、新增和兼容性。

新功能

支持 .NET 8

驱动程序支持 .NET Standard 2.0。有关 .NET Framework 的支持版本，请参阅 .NET Standard 页面。

以更少了解驱动程序内部机制的方式运行事务

新方法 Driver.ExecutableQuery() 是 Session.ExecuteRead/Write() 的包装器，但它抽象了结果处理部分，直接向调用者返回记录列表。

欲了解更多信息，请参阅ExecutableQuery。

记录到对象映射

允许简单地将记录映射到对象，无需冗长的样板代码。

欲了解更多信息，请参阅记录到对象映射。

重新认证

允许处理过期认证（向后兼容）以及会话范围的认证。

欲了解更多信息，请参阅重新认证。

双向 TLS (mTLS) 作为第二认证因子 (2FA)

允许配置客户端 TLS 证书以对服务器进行认证。

支持 BookmarkManager

书签管理器使得实现会话的因果链更容易。

请参阅接口 IBookmarkManager。

通知过滤 API

过滤允许只接收服务器通知的一个子集，并提高服务器端性能。

欲了解更多信息，请参阅NotificationConfig。

GQL 状态和错误

属性 IResultSummary.GqlStatusObjects 包含一个 IGqlStatusObject 序列，其中包含有关查询执行的信息。此 API 计划取代当前的通知 API。

遥测

驱动程序向服务器发送匿名 API 使用统计数据。使用驱动程序配置方法 .WithTelemetryDisabled() 选择退出。

请参阅API 遥测。

重大更改和弃用

弃用的功能很可能在版本 6 中移除。

版本消息状态

版本	消息	状态
5.0	`IServerInfo` — 方法 `.Version()` 已移除。请改用 `.Agent()`、`.ProtocolVersion()`，或调用 `dbms.components` Cypher 过程。	已移除
5.0	`ISession`、`IRxSession`、`IAsyncSession` — 方法 `.ReadTransaction()` 和 `.WriteTransaction()` 已弃用，建议使用 `.ExecuteRead()` 和 `.ExecuteWrite()`。异步对应方法 `.ReadTransactionAsync()` 和 `.WriteTransactionAsync()` 也是如此，它们已被 `.ExecuteReadAsync()` 和 `.ExecuteWriteAsync()` 替换。新方法行为类似，但参数类型不同，并且新方法不支持 `.commit()`、`.rollback()`、`.close()` 和 `.closed()` 方法。	已弃用
5.0	`ISession`、`IAsyncSession` — 方法 `.LastBookmark()` 已弃用，建议使用 `.LastBookmarks()`。	已弃用
5.0	类型 `Bookmark` 已弃用，建议使用 `Bookmarks`。	已弃用
5.0	`SessionConfigBuilder` — 方法 `.WithBookmarks()` 将 `Bookmarks[]` 作为参数，而不是 `Bookmark[]`。	已弃用
5.0	`ZonedDateTime` — 不包含 `DateTimeKind` 的两个构造函数已弃用（此和此）。	已弃用
5.0	`IEntity`、`INode`、`IRelationship` — 方法 `.Id()` (`long`) 已弃用，建议使用 `.ElementId()` (`string`)。	已弃用
5.0	`IRelationship` — 方法 `.StartNodeId()` 和 `.EndNodeId()` 已弃用，建议使用 `.StartNodeElementId()` 和 `.EndNodeElementId()`。旧的标识符是 `long`，而新的 ElementId 是 `string`。	已弃用
5.7	`INotification` — 属性 `Severity` 已弃用，建议使用 `SeverityLevel` 或 `RawSeverityLevel`。	已弃用

5.0

IServerInfo — 方法 .Version() 已移除。请改用 .Agent()、.ProtocolVersion()，或调用 dbms.components Cypher 过程。

已移除

5.0

ISession、IRxSession、IAsyncSession — 方法 .ReadTransaction() 和 .WriteTransaction() 已弃用，建议使用 .ExecuteRead() 和 .ExecuteWrite()。异步对应方法 .ReadTransactionAsync() 和 .WriteTransactionAsync() 也是如此，它们已被 .ExecuteReadAsync() 和 .ExecuteWriteAsync() 替换。

新方法行为类似，但参数类型不同，并且新方法不支持 .commit()、.rollback()、.close() 和 .closed() 方法。

已弃用

5.0

ISession、IAsyncSession — 方法 .LastBookmark() 已弃用，建议使用 .LastBookmarks()。

已弃用

5.0

类型 Bookmark 已弃用，建议使用 Bookmarks。

已弃用

5.0

SessionConfigBuilder — 方法 .WithBookmarks() 将 Bookmarks[] 作为参数，而不是 Bookmark[]。

已弃用

5.0

ZonedDateTime — 不包含 DateTimeKind 的两个构造函数已弃用（此和此）。

已弃用

5.0

IEntity、INode、IRelationship — 方法 .Id() (long) 已弃用，建议使用 .ElementId() (string)。

已弃用

5.0

IRelationship — 方法 .StartNodeId() 和 .EndNodeId() 已弃用，建议使用 .StartNodeElementId() 和 .EndNodeElementId()。旧的标识符是 long，而新的 ElementId 是 string。

已弃用

5.7

INotification — 属性 Severity 已弃用，建议使用 SeverityLevel 或 RawSeverityLevel。

已弃用