Tarantool CE/EE Documentation portal logo
Помощь
Обновлена 15 сентября 2026 г. в 08:55

C#

Наиболее часто используемый драйвер для C# – progaudi.tarantool, ранее известный как tarantool-csharp. Он не входит в состав репозитория Tarantool и должен устанавливаться отдельно. Разработчики рекомендуют кроссплатформенную установку с помощью Nuget.

Для единообразия с остальными инструкциями в этой главе ниже приведён способ установки драйвера напрямую на Ubuntu 16.04.

  1. Установите платформу .net core от Microsoft по инструкции.
  1. Создайте новый консольный проект.

    $ cd ~$ mkdir progaudi.tarantool.test$ cd progaudi.tarantool.test$ dotnet new console
  2. Добавьте ссылку на progaudi.tarantool.

    $ dotnet add package progaudi.tarantool
  3. Измените код в Program.cs.

    $ cat <<EOT > Program.csusing System;using System.Threading.Tasks;using ProGaudi.Tarantool.Client;public class HelloWorld{  static public void Main ()  {    Test().GetAwaiter().GetResult();  }  static async Task Test()  {    var box = await Box.Connect("127.0.0.1:3301");    var schema = box.GetSchema();    var space = await schema.GetSpace("examples");    await space.Insert((99999, "BB"));  }}EOT
  4. Соберите и запустите приложение.

Перед запуском убедитесь, что сервер принимает подключения на адресе localhost:3301 и что спейс examples существует, как описано в разделе Настройка сервера для примеров с коннекторами.

$ dotnet restore$ dotnet run

Программа выполнит следующие действия:

  • Подключение с использованием определения спейса, заданного в приложении.
  • Открытие сокетного соединения с сервером Tarantool на адресе localhost:3301.
  • Отправку запроса INSERT и, при успешном выполнении, завершит работу без вывода сообщений.

Программа выведет сообщение об ошибке, а также дополнительную информацию (трассировку стека и т. д.), если:

  • Tarantool не запущен на адресе localhost:3301.
  • У пользователя guest нет прав на подключение.
  • Запрос INSERT завершается с ошибкой по какой-либо причине.

Пример программы демонстрирует только один запрос и не охватывает все аспекты, необходимые для полноценной работы. Подробнее см. в репозитории драйвера progaudi.tarantool.