. NETCodebeispiele

Dieser Leitfaden enthält. NETCodefragmente und ready-to-run Programme. Sie finden diese Codebeispiele in den folgenden Abschnitten:

• Arbeiten mit Elementen und Attributen

• Arbeiten mit Tabellen und Daten in DynamoDB

• Abfragen von Tabellen in DynamoDB

• Tabellen in DynamoDB scannen

• Verbessern des Datenzugriffs mit sekundären Indizes

• .NET: Dokumentmodell

• . NET: Modell der Objektpersistenz

• Ändern Sie die Datenerfassung für DynamoDB Streams

Sie können schnell loslegen, indem Sie das AWS SDK for .NET mit dem Toolkit for Visual Studio verwenden.

Um das auszuführen. NETCodebeispiele (mit Visual Studio)

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 Sie Fehlermeldungen der Form Der Typ- oder Namespace-Name... konnte nicht gefunden werden sehen, müssen Sie die AWS SDK Assembly für DynamoDB wie folgt installieren:

   1. Öffnen Sie im Solution Explorer das Kontextmenü (Rechtsklick) für Ihr Projekt und wählen Sie dann Pakete verwalten aus. NuGet

   2. Wählen Sie im NuGet Package Manager die Option Durchsuchen aus.

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

   4. Wählen AWSSDKSie D ynamoDBv 2 und dann Installieren.

   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.

Der 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 für.AWS SDK NET.

Anmerkung

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

. NET: Deine AWS Zugangsdaten einrichten

Das AWS SDK for .NET erfordert, dass Sie zur Laufzeit AWS Anmeldeinformationen für Ihre Anwendung angeben. Bei den Codebeispielen in diesem Handbuch wird davon ausgegangen, dass Sie den SDK Store zur Verwaltung Ihrer AWS Anmeldeinformationsdatei verwenden, wie unter Verwenden des SDK Stores im AWS SDK for .NET Entwicklerhandbuch beschrieben.

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 Projektdatei Einträge hinzu, sodass 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>

Zur Laufzeit verwendet das default Programm die im AWSProfileName Eintrag angegebenen AWS Anmeldeinformationen. Die AWS Anmeldeinformationen selbst werden in verschlüsselter Form im SDK Store 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: AWS Region und Endpunkt festlegen

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);