安装
编辑安装
编辑此页面介绍如何安装 Elasticsearch 的 .NET 客户端。
v8 .NET 客户端的功能与 v7 NEST 客户端并不完全相同。在支持更多端点和功能之前，它可能不适用于所有应用程序。因此，我们建议您在尝试将现有应用程序迁移到 Elastic.Clients.Elasticsearch 库之前，仔细阅读我们的 发行说明。在新的客户端支持您的应用程序所需的所有端点和功能之前，您可以继续使用 7.17.x NEST 客户端以兼容模式与 v8 Elasticsearch 服务器通信。有关配置 7.17.x 客户端的指导，请参阅 使用 v7.17.x 客户端连接到 Elasticsearch v8.x 的文档。
安装 .NET 客户端
编辑对于 SDK 风格的项目，您可以通过在终端中运行以下 .NET CLI 命令来安装 Elasticsearch 客户端：
dotnet add package Elastic.Clients.Elasticsearch
此命令会将包引用添加到您的项目 (csproj) 文件中，用于客户端的最新稳定版本。
如果您愿意，也可以手动在项目文件中添加包引用：
<PackageReference Include="Elastic.Clients.Elasticsearch" Version="{latest-version}" />
注意：版本号应反映 NuGet.org 上发布的最新版本。要安装其他版本，请根据需要修改版本号。
对于 Visual Studio 用户，也可以使用以下命令在 Visual Studio 中的包管理器控制台中安装 .NET 客户端：
Install-Package Elastic.Clients.Elasticsearch
或者，在 NuGet 包管理器 UI 中搜索 Elastic.Clients.Elasticsearch。
要了解如何连接 Elasticsearch 客户端，请参阅 连接 部分。
兼容性
编辑Elasticsearch 客户端与当前维护的 .NET 运行时版本兼容。我们不保证或支持与已结束生命周期 (EOL) 的 .NET 运行时的兼容性。
语言客户端具有向前兼容性；这意味着客户端支持与更高或等于 Elasticsearch 次要版本的通信，而不会中断。但这并不意味着客户端会自动支持较新 Elasticsearch 版本的新功能；只有在新版客户端发布后才可能实现。例如，8.12 版客户端不会自动支持 Elasticsearch 8.13 版的新功能，为此需要 8.13 版客户端。Elasticsearch 语言客户端仅与默认发行版向后兼容，且无任何保证。
| Elasticsearch 版本 | Elasticsearch-NET 分支 | 支持的 |
|---|---|---|
main |
main |
|
8.x |
8.x |
8.x |
7.x |
7.x |
7.17 |
有关更多信息，请参阅 生命周期结束策略。
CI 订阅源
编辑我们发布客户端包的 CI 版本，包括最新的未发布功能。如果您想试用最新版本，可以将 CI 订阅源添加到您的 NuGet 包源列表中。
订阅源 URL：https://f.feedz.io/elastic/all/nuget/index.json
我们不建议将 CI 版本用于生产应用程序，因为在正式发布之前，它们不受正式支持。