. NETcontoh kode

Panduan ini berisi. NETcuplikan kode dan ready-to-run program. Anda dapat menemukan contoh kode ini di bagian berikut:

• Bekerja dengan item dan atribut

• Bekerja dengan tabel dan data di DynamoDB

• Menanyakan tabel di DynamoDB

• Memindai tabel di DynamoDB

• Meningkatkan akses data dengan indeks sekunder

• .NET: Model dokumen

• . NET: Model ketekunan objek

• Tangkapan data perubahan DynamoDB Streams

Anda dapat memulai dengan cepat dengan menggunakan Toolkit for Visual Studio. AWS SDK for .NET

Untuk menjalankan. NETcontoh kode (menggunakan Visual Studio)

1. Unduh dan instal Microsoft Visual Studio.

2. Unduh dan instal Toolkit for Visual Studio.

3. Mulai Visual Studio. Pilih File, Baru, Proyek.

4. Dalam Proyek Baru, pilih Proyek Kosong AWS , lalu pilih OK.

5. Dalam Kredensial Akses AWS , pilih Gunakan profil yang ada, pilih kredensial profil Anda dari daftar, lalu pilih OK.

   Jika ini adalah pertama kalinya Anda menggunakan Toolkit for Visual Studio, pilih Menggunakan profil baru untuk menyiapkan kredensial AWS Anda.

6. Dalam proyek Visual Studio, pilih tab untuk kode sumber program Anda (Program.cs). Salin contoh kode dari halaman dokumentasi ke editor Visual Studio, menggantikan kode lain yang Anda lihat di editor.

7. Jika Anda melihat pesan kesalahan formulir Jenis atau nama namespace... tidak dapat ditemukan, Anda perlu menginstal AWS SDK perakitan untuk DynamoDB sebagai berikut:

   1. Di Solution Explorer, buka menu konteks (klik kanan) untuk proyek Anda, lalu pilih Kelola NuGet Paket.

   2. Di NuGet Package Manager, pilih Browse.

   3. Di kotak pencarian, masukkan AWSSDK.DynamoDBv2, lalu tunggu hingga pencarian selesai.

   4. Pilih AWSSDK.D ynamoDBv 2, lalu pilih Install.

   5. Saat penginstalan selesai, pilih opsi tab Program.cs untuk kembali ke program Anda.

8. Untuk menjalankan kode, pilih Mulai di toolbar Visual Studio.

AWS SDK for .NET Ini menyediakan klien thread-safe untuk bekerja dengan DynamoDB. Sebagai praktik terbaik, aplikasi Anda harus membuat satu klien dan menggunakan kembali klien di antara thread.

Untuk informasi lebih lanjut, lihat AWS SDKuntuk. NET.

catatan

Contoh kode dalam panduan ini dimaksudkan untuk digunakan dengan versi terbaru dari AWS SDK for .NET.

. NET: Mengatur AWS kredensil Anda

Ini AWS SDK for .NET mengharuskan Anda memberikan AWS kredensil ke aplikasi Anda saat runtime. Contoh kode dalam panduan ini mengasumsikan bahwa Anda menggunakan SDK Store untuk mengelola file AWS kredensial Anda, seperti yang dijelaskan dalam Menggunakan SDK toko di Panduan AWS SDK for .NET Pengembang.

Toolkit for Visual Studio mendukung beberapa set kredensial dari sejumlah akun. Setiap set disebut sebagai profil. Visual Studio menambahkan entri ke App.config file proyek sehingga aplikasi Anda dapat menemukan AWS kredensialnya saat runtime.

Contoh berikut menunjukkan file App.config default yang dihasilkan ketika Anda membuat proyek baru menggunakan 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>

Saat runtime, program menggunakan default set AWS kredensil, seperti yang ditentukan oleh entri. AWSProfileName AWS Kredensialnya sendiri disimpan di SDK Store dalam bentuk terenkripsi. Toolkit for Visual Studio menyediakan antarmuka pengguna grafis untuk mengelola kredensial Anda, semua dari dalam Visual Studio. Untuk informasi selengkapnya, lihat Menentukan kredensial dalam Panduan Pengguna AWS Toolkit for Visual Studio .

catatan

Secara default, contoh kode mengakses DynamoDB di Wilayah AS Barat (Oregon). Anda dapat mengubah Wilayah dengan memodifikasi entri AWSRegion dalam file App.config. Anda dapat mengatur AWSRegion ke Wilayah mana pun tempat DynamoDB tersedia. Untuk daftar lengkap, lihat wilayah dan titik akhir AWS di Referensi Umum Amazon Web Services.

. NET: Mengatur AWS Wilayah dan titik akhir

Secara default, contoh kode mengakses DynamoDB di Wilayah AS Barat (Oregon). Anda dapat mengubah Wilayah dengan memodifikasi entri AWSRegion dalam file App.config. Atau, Anda dapat mengubah Wilayah dengan memodifikasi properti AmazonDynamoDBClient.

Contoh kode berikut menginstansiasi AmazonDynamoDBClient baru. Klien dimodifikasi sehingga kode berjalan terhadap DynamoDB di Wilayah yang berbeda.

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

Untuk daftar lengkap Wilayah, lihat wilayah dan titik akhir AWS di Referensi Umum Amazon Web Services.

Jika Anda ingin menjalankan contoh kode menggunakan DynamoDB secara lokal pada komputer Anda, atur titik akhir sebagai berikut.

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