C#
The most commonly used C# driver is
progaudi.tarantool,
previously named tarantool-csharp
. It is not supplied as part of the
Tarantool repository; it must be installed separately. The makers recommend
cross-platform installation using Nuget.
Чтобы придерживаться метода оформления других инструкций в данной главе, дадим описание способа установки драйвера напрямую на 16.04.
- Install .net core from Microsoft. Follow .net core installation instructions.
Примечание
- Mono не сработает, как не сработает и .Net от xbuild. Только .NET Core поддерживается на Linux и Mac.
- Read the Microsoft End User License Agreement first, because it is not an ordinary open-source agreement and there will be a message during installation saying «This software may collect information about you and your use of the software, and send that to Microsoft.» Still you can set environment variables to opt out from telemetry.
Создайте новый консольный проект.
$ cd ~ $ mkdir progaudi.tarantool.test $ cd progaudi.tarantool.test $ dotnet new console
Добавьте ссылку на
progaudi.tarantool
.$ dotnet add package progaudi.tarantool
Измените код в
Program.cs
.$ cat <<EOT > Program.cs using 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
Соберите и запустите приложение.
Перед запуском проверьте, что у экземпляра задан порт для прослушивания на``localhost:3301``, и в базе создан спейс
examples
, как описано выше.$ dotnet restore $ dotnet run
Программа:
- установит соединение, используя определение спейса для этой цели,
- open a socket connection with the Tarantool server at
localhost:3301
, - отправит INSERT-запрос, а затем – если всё хорошо – закончит работу без каких-либо сообщений.
Если Tarantool не запущен на
localhost
на прослушивание по порту 3301, или у пользователя „guest“ нет прав на соединение, или запрос вставки по какой-либо причине не сработает, то программа выдаст сообщение об ошибке и другую информацию (трассировку стека и т.д.).
The example program only shows one request and does not show all that’s necessary for good practice. For that, please see the progaudi.tarantool driver repository.