Exemples de code .NET

Le guide contient des extraits de code .NET et des programmes prêts à être exécutés. Vous pouvez trouver ces exemples de code dans les sections suivantes :

• Utilisation des éléments et des attributs

• Utilisation des tables et des données dans DynamoDB

• Opérations de requête dans DynamoDB

• Utilisation des analyses dans DynamoDB

• Amélioration de l'accès aux données avec les index secondaires

• .NET : modèle de document

• .NET : modèle de persistance des objets

• Modifier la récupération de données pour DynamoDB Streams

Vous pouvez démarrer rapidement en utilisant l'AWS SDK for .NET avec le Toolkit for Visual Studio.

Pour exécuter les exemples de code .NET (à l'aide de Visual Studio)

1. Téléchargez et installez Microsoft Visual Studio.

2. Téléchargez et installez le Toolkit pour Visual Studio.

3. Démarrez Visual Studio 2015. Choisissez File (Fichier), New (Nouveau), puis Project (Projet).

4. Dans Nouveau projet, choisissez Projet vide AWS, puis OK.

5. Dans Informations d'identification AWS, choisissez Utiliser un profil existant, sélectionnez votre profil d'informations d'identification dans la liste, puis choisissez OK.

   S'il s'agit de votre première utilisation du Toolkit for Visual Studio, choisissez Use a new profile (Utiliser un nouveau profil) pour configurer vos informations d'identification AWS.

6. Dans votre projet Visual Studio, sélectionnez l'onglet du code source de votre programme (Program.cs). Copiez l'exemple de code de la page de documentation dans l'éditeur Visual Studio, en remplaçant tout autre code que vous voyez dans l'éditeur.

7. Si vous voyez des messages d'erreur tels que The type or namespace name...could not be found (Le nom de type ou d'espace de nom...est introuvable), vous devez installer l'assembly du kit SDK AWS pour DynamoDB comme suit :

   1. Dans l'Explorateur de solutions, ouvrez le menu contextuel (clic droit) de votre projet, puis choisissez Manage NuGet Packages.

   2. Dans le gestionnaire de package NuGet, choisissez Browse.

   3. Dans la zone de recherche, saisissez AWSSDK.DynamoDBv2 et attendez la fin de la recherche.

   4. Choisissez AWSSDK. DynamoDBv2, puis Install (Installer).

   5. Lorsque l'installation est terminée, sélectionnez l'onglet Program.cs pour revenir à votre programme.

8. Pour exécuter le code, choisissez Start (Début) dans la barre d'outils Visual Studio.

L'AWS SDK for .NET fournit des clients thread-safe à utiliser avec DynamoDB. En tant que bonne pratique, vos applications doivent créer un seul client et le réutiliser entre les threads.

Pour plus d'informations, consultez Kit SDK AWS pour .NET.

Note

Les exemples de code dans ce guide sont destinés à être utilisés avec la dernière version de AWS SDK for .NET.

.NET : définition de vos informations d'identification AWS

L'AWS SDK for .NET nécessite que vous fournissiez les informations d'identification AWS à votre application lors de l'exécution. Les exemples de code dans ce guide partent du principe que vous utilisez le kit SDK Store pour gérer votre fichier d'informations d'identification AWS, comme décrit dans Utilisation du magasin SDK dans le Guide du développeur AWS SDK for .NET.

Le Toolkit for Visual Studio prend en charge plusieurs jeux d'informations d'identification d'un nombre quelconque de comptes. Chaque ensemble est référencé comme profil. Visual Studio ajoute des entrées au fichier App.config du projet de façon que votre application puisse trouver les informations d'identification AWS lors de l'exécution.

L'exemple suivant affiche le fichier App.config par défaut qui est généré lorsque vous créez un projet à l'aide du Toolkit for Visual Studio.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
    <add key="AWSProfileName" value="default"/>
    <add key="AWSRegion" value="us-west-2" />
 </appSettings>
</configuration>

Lors de l'exécution, le programme utilise le jeu d'informations d'identification default d’AWS, comme spécifié par l'entrée AWSProfileName. Les informations d'identification AWS proprement dites sont conservées dans le kit SDK Store sous forme chiffrée. Le Toolkit for Visual Studio fournit une interface utilisateur graphique pour gérer vos informations d'identification, le tout dans Visual Studio. Pour plus d'informations, consultez Spécification d'informations d'identification dans le Guide de l'utilisateur AWS Toolkit for Visual Studio.

Note

Par défaut, les exemples de code accèdent à DynamoDB dans la région USA Ouest (Oregon). Vous pouvez modifier la région en modifiant l'entrée AWSRegion dans le fichier App.config. Vous pouvez définir AWSRegion sur n'importe quelle région dans laquelle DynamoDB est disponible. Pour obtenir la liste complète, consultez Régions et points de terminaison AWS dans le Référence générale d'Amazon Web Services.

.NET : définition de la région AWS et du point de terminaison

Par défaut, les exemples de code accèdent à DynamoDB dans la région USA Ouest (Oregon). Vous pouvez modifier la région en modifiant l'entrée AWSRegion dans le fichier App.config. Ou alors, vous pouvez modifier la région en modifiant les propriétés AmazonDynamoDBClient.

L'exemple de code suivant instancie un nouvel AmazonDynamoDBClient. Le client est modifié de telle sorte que le code s'exécute sur DynamoDB dans une autre région.

AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// This client will access the US East 1 region.
clientConfig.RegionEndpoint = RegionEndpoint.USEast1;
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig); 

Pour obtenir la liste complète des régions prises en charge, consultez Régions et points de terminaison AWS dans le Référence générale d'Amazon Web Services.

Si vous souhaitez exécuter les exemples de code à l'aide de DynamoDB localement sur votre ordinateur, définissez le point de terminaison comme suit.

AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// Set the endpoint URL
clientConfig.ServiceURL = "http://localhost:8000";
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig);