.NET-Codebeispiele - Amazon-DynamoDB

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

.NET-Codebeispiele

Dieses Entwicklerhandbuch enthält .NET-Codeausschnitte und Programme, die Sie sofort ausführen können. Sie finden diese Codebeispiele in den folgenden Abschnitten:

Sie können sofort beginnen, indem Sie den AWS SDK for .NET mit dem Toolkit for Visual Studio verwenden.

So führen Sie die .NET-Codebeispiele (mit Visual Studio) aus
  1. Laden Sie Microsoft Visual Studio herunter und installieren Sie es.

  2. Downloaden Sie das Toolkit for Visual Studio herunter und installieren Sie es.

  3. Starten Sie Visual Studio. Wählen Sie File (Datei), New (Neu) und Project (Projekt) aus.

  4. Wählen Sie unter Neues Projekt die Option AWS Leeres Projekt und dann OK aus.

  5. Wählen Sie in AWS Zugangsdaten die Option Vorhandenes Profil verwenden und anschließend Ihre Anmeldeinformationen aus der Liste und OK aus.

    Wenn Sie Toolkit for Visual Studio zum ersten Mal verwenden, wählen Sie Neues Profil verwenden aus, um Ihre AWS Anmeldeinformationen einzurichten.

  6. Wählen Sie in dem Visual Studio-Projekt die Registerkarte für den Quellcode des Programms aus (Program.cs). Kopieren Sie das Codebeispiel von der Dokumentationsseite in den Visual Studio-Editor unter Ersetzung aller anderen Codes, die im Editor angezeigt werden.

  7. Wenn Ihnen eine Fehlermeldung ähnlich Typ oder Namespace Name...konnte nicht gefunden werden angezeigt wird, müssen Sie die AWS SDK-Zusammenstellung für DynamoDB wie folgt installieren:

    1. Öffnen Sie im Projektmappen-Explorer das Kontextmenü (durch Rechtsklick) für Ihr Projekt und wählen Sie dann Manage NuGet Packages aus.

    2. Wählen Sie im NuGet Package Manager Browse aus.

    3. Geben Sie im Suchfeld AWSSDK.DynamoDBv2 ein und warten Sie, bis die Suche abgeschlossen ist.

    4. Wählen Sie AWSSDK.DynamoDBv2 und anschließend Install (Installieren) aus.

    5. Wenn die Installation abgeschlossen ist, wählen Sie die Registerkarte Program.cs aus, um zum Programm zurückzukehren.

  8. Wählen Sie auf der Visual Studio-Symbolleiste die Schaltfläche Start (Starten) aus, um den Code auszuführen.

AWS SDK for .NET bietet Thread-sichere Clients für die Arbeit mit DynamoDB. Als bewährte Methode sollten Ihre Anwendungen einen Client erstellen und diesen zwischen den Threads wiederverwenden.

Weitere Informationen finden Sie unter AWS SDK for .NET.

Anmerkung

Die Codebeispiele in diesem Handbuch sind für die Verwendung mit der neuesten Version des AWS SDK for .NET vorgesehen.

.NET: Festlegung Ihrer AWS-Anmeldeinformationen

Das AWS SDK for .NET setzt voraus, dass Sie AWS-Anmeldeinformationen für Ihre Anwendung zur Laufzeit bereitstellen. In den Codebeispielen in diesem Leitfaden wird davon ausgegangen, dass Sie den SDK Store verwenden, um die AWS-Anmeldeinformationsdatei zu verwalten. Einzelheiten hierzu finden Sie unter Verwenden des SDK Store im AWS SDK for .NET-Entwicklerhandbuch.

Toolkit for Visual Studio unterstützt mehrere Gruppen von Anmeldeinformationen aus einer beliebigen Anzahl von Konten. Jede Gruppe wird als profile bezeichnet. Visual Studio fügt der App.config-Datei des Projekts Einträge hinzu, damit Ihre Anwendung die AWS-Anmeldeinformationen zur Laufzeit finden kann.

Das folgende Beispiel zeigt die App.config-Standarddatei, die bei der Erstellung eines neuen Projekts mit Toolkit for Visual Studio generiert wird.

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

Das Programm verwendet zur Laufzeit die default-Gruppe von AWS-Anmeldeinformationen, wie vom AWSProfileName-Eintrag angegeben. Die AWS-Anmeldeinformationen selbst werden im SDK Store in verschlüsselter Form aufbewahrt. Das Toolkit for Visual Studio bietet eine grafische Benutzeroberfläche, um Ihre Anmeldeinformationen vollständig über Visual Studio zu verwalten. Weitere Informationen finden Sie unter Anmeldeinformationen angeben im AWS Toolkit for Visual Studio-Benutzerleitfaden.

Anmerkung

Standardmäßig greifen die Codebeispiele auf DynamoDB in der Region USA West (Oregon) auf. Sie können die Region ändern, indem Sie den AWSRegion-Eintrag in der Datei App.config ändern. Sie können AWSRegion auf jede Region festlegen, in der DynamoDB verfügbar ist. Die vollständige Liste finden Sie unter AWS-Regionen und -Endpunkte in der Allgemeine Amazon Web Services-Referenz.

.NET: Festlegen der AWS-Region und des Endpunkts

Standardmäßig greifen die Codebeispiele auf DynamoDB in der Region USA West (Oregon) auf. Sie können die Region ändern, indem Sie den AWSRegion-Eintrag in der Datei App.config ändern. Sie können auch die Region ändern, indem Sie die AmazonDynamoDBClient-Eigenschaften ändern.

Im folgenden Codebeispiel wird ein neuer AmazonDynamoDBClient instanziiert. Der Client wird so geändert, dass der Code für DynamoDB in einer anderen Region ausgeführt wird.

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

Die vollständige Liste der Regionen finden Sie unter AWS-Regionen und -Endpunkte in der Allgemeine Amazon Web Services-Referenz.

Wenn Sie die Codebeispiele mit DynamoDB lokal auf Ihrem Computer ausführen möchten, müssen Sie den Endpunkt wie folgt festlegen.

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