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
Rubriques
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 :
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)
-
Téléchargez et installez Microsoft Visual Studio
. -
(Facultatif) Téléchargez et installez le Toolkit for Visual Studio
. -
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 du Guide du développeur pour le kit AWS SDK pour .NET . -
Démarrez Visual Studio 2015. Choisissez File (Fichier), New (Nouveau), puis Project (Projet).
-
Recherchez Console App, sélectionnez le modèle C# qui cible .NET, puis choisissez Next. Configurez le nom et l'emplacement de votre projet, puis choisissez Créer.
-
Ajoutez le package AWS SDK pour NuGet DynamoDB à votre projet :
-
Dans l'Explorateur de solutions, ouvrez le menu contextuel (clic droit) de votre projet, puis choisissez Gérer les NuGet packages.
-
Dans le Gestionnaire de NuGet packages, choisissez Parcourir.
-
Dans la zone de recherche, saisissez
AWSSDK.DynamoDBv2et attendez la fin de la recherche. -
Choisissez AWSSDK.Dynamo DBv2, puis choisissez Installer.
-
-
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. -
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
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
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 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'defaultensemble d' AWS informations d'identification, tel que spécifié par l'AWSProfileNameentré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 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 AWS région 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);