

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# .NET et DAX
<a name="DAX.client.run-application-dotnet"></a>

Procédez comme suit pour exécuter l’exemple .NET sur votre instance Amazon EC2.

**Note**  
Ce didacticiel utilise le SDK .NET 9. Il montre comment exécuter un programme dans votre VPC Amazon par défaut pour accéder à votre cluster Amazon DynamoDB Accelerator (DAX). Il fonctionne avec le [AWS SDK v4 pour .NET](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html). Pour plus de détails sur les modifications apportées à la version 4 et des informations sur la migration, consultez la section [Migration vers la version 4 du AWS SDK](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html) pour .NET. Si vous préférez, vous pouvez utiliser le AWS Toolkit for Visual Studio pour écrire une application .NET et la déployer dans votre VPC.  
Pour plus d’informations, consultez [Création et déploiement d’applications Elastic Beanstalk dans .NET à l’aide d’ AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/create_deploy_NET.html) dans le *Guide du développeur AWS Elastic Beanstalk *.

**Pour exécuter l’exemple .NET pour DAX**

1. Accédez à la [page des téléchargements Microsoft](https://www.microsoft.com/net/download?initial-os=linux) et téléchargez le dernier SDK .NET 9 pour Linux. Le fichier téléchargé est `dotnet-sdk-N.N.N-linux-x64.tar.gz`.

1. Extrayez les fichiers du kit SDK.

   ```
   mkdir dotnet
   tar zxvf dotnet-sdk-N.N.N-linux-x64.tar.gz -C dotnet
   ```

   Remplacez `N.N.N` par le numéro de version réel du kit SDK .NET, par exemple : `9.0.305`.

1. Vérifiez l’installation.

   ```
   alias dotnet=$HOME/dotnet/dotnet
   dotnet --version
   ```

   Le numéro de version du kit SDK .NET doit alors s’imprimer.
**Note**  
Au lieu du numéro de version, vous pouvez recevoir l’erreur suivante :  
erreur : libunwind.so.8 : impossible d’ouvrir le fichier objet partagé: Fichier ou répertoire inexistant  
Pour résoudre l’erreur, installez le package `libunwind`.  

   ```
   sudo yum install -y libunwind
   ```
Une fois que vous avez terminé, vous devez pouvoir exécuter la commande `dotnet --version` sans erreur.

1. Crée un projet .NET.

   ```
   dotnet new console -o myApp 
   ```

   Cela nécessite quelques minutes pour effectuer une one-time-only configuration. Une fois l’opération terminée, exécutez l’exemple de projet.

   ```
   dotnet run --project myApp
   ```

   Vous devriez recevoir le message suivant : `Hello World!`

1. Le fichier `myApp/myApp.csproj` contient les métadonnées de votre projet. Pour utiliser le client DAX dans votre application, modifiez le fichier de telle sorte qu’il ressemble à ceci.

   ```
   <Project Sdk="Microsoft.NET.Sdk">
       <PropertyGroup>
           <OutputType>Exe</OutputType>
           <TargetFramework>net9.0</TargetFramework>
       </PropertyGroup>
       <ItemGroup>
           <PackageReference Include="AWSSDK.DAX.Client" Version="*" />
       </ItemGroup>
   </Project>
   ```

1. Téléchargez le code source de l’exemple de programme (fichier `.zip`).

   ```
   wget http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/samples/TryDax.zip
   ```

   Une fois le téléchargement terminé, extrayez les fichiers source.

   ```
   unzip TryDax.zip
   ```

1. Exécutez maintenant les exemples de programmes de *DotNet*, un par un. Pour chaque programme, copiez son contenu dans le fichier `myApp/Program.cs`, puis exécutez le projet `MyApp`.

   Exécutez les programmes .NET suivants. Le premier programme crée une table DynamoDB nommée `TryDaxTable`. Le deuxième programme écrit des données dans la table.

   ```
   cp TryDax/dotNet/01-CreateTable.cs myApp/Program.cs
   dotnet run --project myApp
   
   cp TryDax/dotNet/02-Write-Data.cs myApp/Program.cs
   dotnet run --project myApp
   ```

1. Ensuite, exécutez certains programmes pour effectuer les opérations `GetItem`, `Query` et `Scan` sur votre cluster DAX. Pour déterminer le point de terminaison de votre cluster DAX, choisissez l’une des options suivantes :
   +  **Utilisation de la console DynamoDB** – Choisissez votre cluster DAX. Le point de terminaison du cluster s’affiche dans la console, comme dans l’exemple suivant.

     ```
     dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
     ```
   + **À l'aide** de AWS CLI— Entrez la commande suivante.

     ```
     aws dax describe-clusters --query "Clusters[*].ClusterDiscoveryEndpoint"
     ```

     Le point de terminaison du cluster apparaît dans la sortie, comme dans l’exemple suivant.

     ```
     {
         "Address": "my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com",
         "Port": 8111,
         "URL": "dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com"
     }
     ```

   À présent, exécutez les programmes suivants, en spécifiant le point de terminaison de votre cluster comme paramètre de ligne de commande. (Remplacez l’exemple de point de terminaison par le point de terminaison réel de votre cluster DAX.)

   ```
   cp TryDax/dotNet/03-GetItem-Test.cs myApp/Program.cs
   dotnet run --project myApp dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
   
   cp TryDax/dotNet/04-Query-Test.cs myApp/Program.cs
   dotnet run --project myApp dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
                           
   cp TryDax/dotNet/05-Scan-Test.cs myApp/Program.cs
   dotnet run --project myApp dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
   ```

   Notez les informations de durée, soit le nombre de millisecondes requis pour les tests `GetItem`, `Query` et `Scan`.

1. Exécutez le programme .NET suivant pour supprimer `TryDaxTable`.

   ```
   cp TryDax/dotNet/06-DeleteTable.cs myApp/Program.cs
   dotnet run --project myApp
   ```

Pour plus d’informations sur ces programmes, consultez les sections suivantes :
+ [0-1 CreateTable pièce](DAX.client.run-application-dotnet.01-CreateTable.md)
+ [02-Write-Data.cs](DAX.client.run-application-dotnet.02-Write-Data.md)
+ [03- GetItem -Test.cs](DAX.client.run-application-dotnet.03-GetItem-Test.md)
+ [04-Query-Test.cs](DAX.client.run-application-dotnet.04-Query-Test.md)
+ [05-Scan-Test.cs](DAX.client.run-application-dotnet.05-Scan-Test.md)
+ [DeleteTable0,6 à 6 pièces](DAX.client.run-application-dotnet.06-DeleteTable.md)