

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Contoh kode .NET
<a name="CodeSamples.DotNet"></a>

**Topics**
+ [.NET: Mengatur AWS kredensil Anda](#CodeSamples.DotNet.Credentials)
+ [.NET: Mengatur AWS Wilayah dan titik akhir](#CodeSamples.DotNet.RegionAndEndpoint)

Panduan ini berisi potongan kode .NET dan ready-to-run program. Anda dapat menemukan contoh kode ini di bagian berikut:
+ [Bekerja dengan item dan atribut di DynamoDB](WorkingWithItems.md)
+ [Bekerja dengan tabel dan data di DynamoDB](WorkingWithTables.md)
+ [Menanyakan tabel di DynamoDB](Query.md)
+ [Memindai tabel di DynamoDB](Scan.md)
+ [Meningkatkan akses data dengan indeks sekunder di DynamoDB](SecondaryIndexes.md)
+ [Bekerja dengan model dokumen.NET di DynamoDB](DotNetSDKMidLevel.md)
+ [Bekerja dengan model persistensi objek.NET dan DynamoDB](DotNetSDKHighLevel.md)
+ [Tangkapan data perubahan DynamoDB Streams](Streams.md)

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

**Untuk menjalankan contoh kode .NET (menggunakan Visual Studio)**

1. Unduh dan instal [Microsoft Visual Studio](https://www.visualstudio.com).

1. (Opsional) Unduh dan instal [Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/).

1. Siapkan AWS kredensil Anda. Konfigurasikan profil kredensial di file AWS kredensial bersama Anda (). `~/.aws/credentials` Untuk informasi selengkapnya, lihat [Mengonfigurasi kredensial AWS](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html) di *Panduan Developer AWS SDK untuk .NET *.

1. Mulai Visual Studio. Pilih **File**, **Baru**, **Proyek**.

1. Cari **Aplikasi Konsol**, pilih templat C\$1 yang menargetkan .NET, lalu pilih **Berikutnya**. Konfigurasikan nama dan lokasi proyek Anda, lalu pilih **Buat**.

1. Tambahkan paket AWS SDK for NuGet DynamoDB ke project Anda:

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

   1. Di NuGet Package Manager, pilih **Browse**.

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

   1. **Pilih **AWSSDK.Dynamo DBv2**, dan kemudian pilih Install.**

1. Dalam proyek Visual Studio Anda, buka`Program.cs`. Ganti konten dengan contoh kode dari halaman dokumentasi yang ingin Anda jalankan.

1. Untuk menjalankan kode, pilih **Mulai** di toolbar Visual Studio.

 SDK untuk .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 selengkapnya, lihat [AWS SDK untuk .NET](https://aws.amazon.com/sdk-for-net).

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

## .NET: Mengatur AWS kredensil Anda
<a name="CodeSamples.DotNet.Credentials"></a>

Ini SDK untuk .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 kredensional Anda, seperti yang dijelaskan dalam [Menggunakan penyimpanan SDK di Panduan Pengembang](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html#sdk-store).AWS SDK untuk .NET *

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](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/tkv_setup.html#creds) 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](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) di *Referensi Umum Amazon Web Services*.

## .NET: Mengatur AWS Wilayah dan titik akhir
<a name="CodeSamples.DotNet.RegionAndEndpoint"></a>

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](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) 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);
```