安装
编辑安装
编辑本页介绍了如何安装 Elasticsearch 的 .NET 客户端。
适用于 .NET 的 v8 客户端与 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 分支 | 支持 |
|---|---|---|
主分支 |
主分支 |
|
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 构建版本用于生产应用程序，因为在发布之前它们不受正式支持。