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.
. NETexemples de code
Rubriques
Ce guide contient. NETdes extraits de code 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 for .NET Toolkit for Visual Studio.
Pour exécuter le. NETexemples de code (à l'aide de Visual Studio)
-
Téléchargez et installez Microsoft Visual Studio
. -
Téléchargez et installez le Toolkit pour Visual Studio
. -
Démarrez Visual Studio 2015. Choisissez File (Fichier), New (Nouveau), puis Project (Projet).
-
Dans Nouveau projet, choisissez Projet vide AWS , puis OK.
-
Dans Informations d'identification AWS , choisissez Utiliser un profil existant, sélectionnez votre profil d'informations d'identification dans la liste, puis choisissez OK.
Si c'est la première fois que vous utilisez Toolkit for Visual Studio, choisissez Utiliser un nouveau profil pour configurer vos AWS informations d'identification.
-
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. -
Si des messages d'erreur du
type ou du nom de l'espace de noms... sont introuvables s'affichent
, vous devez installer l' AWS SDKassembly pour DynamoDB comme suit :-
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, sélectionnez Parcourir.
-
Dans la zone de recherche, saisissez
AWSSDK.DynamoDBv2
et attendez la fin de la recherche. -
Choisissez AWSSDKynamoDBvD.2, puis choisissez Installer.
-
Lorsque l'installation est terminée, sélectionnez l'onglet Program.cs pour revenir à votre programme.
-
-
Pour exécuter le code, choisissez Start (Début) dans la barre d'outils Visual Studio.
AWS SDK for .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, voir AWS SDKpour. 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: Configuration de vos AWS informations d'identification
Vous devez fournir des AWS informations d'identification à votre application lors de l'exécution. AWS SDK for .NET Les exemples de code présentés dans ce guide supposent que vous utilisez le SDK Store pour gérer votre fichier AWS d'informations d'identification, comme décrit dans la section Utilisation du SDK magasin dans le guide du AWS SDK for .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 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: Configuration 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);