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.

# Exemples de code .NET
<a name="CodeSamples.DotNet"></a>

**Topics**
+ [.NET : Configuration de vos AWS informations d'identification](#CodeSamples.DotNet.Credentials)
+ [.NET : définition de la AWS région et du point de terminaison](#CodeSamples.DotNet.RegionAndEndpoint)

Ce guide contient des extraits de code .NET et ready-to-run des programmes. Vous pouvez trouver ces exemples de code dans les sections suivantes :
+ [Utilisation d’éléments et d’attributs dans DynamoDB](WorkingWithItems.md)
+ [Utilisation de tables et de données dans DynamoDB](WorkingWithTables.md)
+ [Interrogation de tables dans DynamoDB](Query.md)
+ [Analyse de tables dans DynamoDB](Scan.md)
+ [Amélioration de l’accès aux données avec les index secondaires dans DynamoDB](SecondaryIndexes.md)
+ [Utilisation du modèle de document .NET dans DynamoDB](DotNetSDKMidLevel.md)
+ [Utilisation du modèle de persistance des objets .NET et de DynamoDB](DotNetSDKHighLevel.md)
+ [Modifier la récupération de données pour DynamoDB Streams](Streams.md)

Vous pouvez démarrer rapidement en utilisant le AWS SDK pour .NET 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](https://www.visualstudio.com).

1. (Facultatif) Téléchargez et installez le [Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/).

1. Configurez vos AWS informations d'identification. Configurez un profil d'informations d'identification dans votre fichier AWS d'informations d'identification partagé (`~/.aws/credentials`). Pour de plus amples informations, veuillez consulter la section [Configurer les informations d'identification AWS](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html) du *Guide du développeur pour le kit AWS SDK pour .NET *.

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

1. Recherchez **Console App**, sélectionnez le modèle C\$1 qui cible .NET, puis choisissez **Next**. Configurez le nom et l'emplacement de votre projet, puis choisissez **Créer**.

1. Ajoutez le package AWS SDK pour NuGet DynamoDB à votre projet :

   1. Dans l'Explorateur de solutions, ouvrez le menu contextuel (clic droit) de votre projet, puis choisissez **Gérer les NuGet packages**.

   1. Dans le Gestionnaire de NuGet packages, choisissez **Parcourir**.

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

   1. **Choisissez **AWSSDK.Dynamo DBv2**, puis choisissez Installer.**

1. Dans votre projet Visual Studio, ouvrez`Program.cs`. Remplacez le contenu par l'exemple de code de la page de documentation que vous souhaitez exécuter.

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

 SDK pour .NET fournit des clients sécurisés pour travailler 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](https://aws.amazon.com/sdk-for-net).

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

## .NET : Configuration de vos AWS informations d'identification
<a name="CodeSamples.DotNet.Credentials"></a>

Vous devez fournir des AWS informations d'identification à votre application lors de l'exécution. SDK pour .NET Les exemples de code présentés dans ce guide supposent que vous utilisez le magasin du SDK pour gérer votre fichier AWS d'informations d'identification, comme décrit dans la section [Utilisation du magasin du SDK](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html#sdk-store) dans le manuel du *AWS SDK pour .NET développeur*.

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 `App.config` fichier du projet afin que votre application puisse trouver les AWS informations d'identification 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>
```

Au moment de l'exécution, le programme utilise l'`default`ensemble d' AWS informations d'identification, tel que spécifié par l'`AWSProfileName`entrée. Les AWS informations d'identification elles-mêmes sont conservées dans le SDK Store sous forme crypté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](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/tkv_setup.html#creds) 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](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) dans le *Référence générale d'Amazon Web Services*.

## .NET : définition de la AWS région et du point de terminaison
<a name="CodeSamples.DotNet.RegionAndEndpoint"></a>

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](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) 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);
```