Esempi di codice .NET - Amazon DynamoDB
.NET: Configurazione delle credenziali AWS.NET: Configurazione dell'endpoint e della regione AWS

Esempi di codice .NET

Questa guida contiene frammenti di codice .NET e programmi pronti per l'esecuzione. Puoi trovare questi esempi di codice nelle seguenti sezioni:

È possibile iniziare velocemente usando AWS SDK per .NET con Toolkit for Visual Studio.

Esecuzione degli esempi di codice .NET (usando Visual Studio)

  1. Scaricare e installare Microsoft Visual Studio.

  2. Scaricare e installare Toolkit for Visual Studio.

  3. Avvia Visual Studio. Scegli File, Nuovo, Progetto.

  4. In Nuovo progetto scegli Progetto vuoto AWS, quindi scegli OK.

  5. In Credenziali di accesso AWS scegliere Usa profilo esistente, seleziona il profilo delle credenziali dall'elenco, infine scegli OK.

    Se è la prima volta che si utilizza Toolkit for Visual Studio, scegli Usa un nuovo profilo per configurare le credenziali AWS.

  6. Nel tuo progetto di Visual Studio, scegli la tabella per il codice sorgente del tuo programma (Program.cs). Copia l'esempio di codice dalla pagina della documentazione nell'editor di Visual Studio, sostituendo qualsiasi altro codice che vedi nell'editor.

  7. Se vengono visualizzati messaggi di errore del moduloImpossibile trovare il tipo o il nome dello spazio dei nomi..., è necessario installare l'assieme di SDK AWSper DynamoDB come segue:

    1. In Esplora soluzioni aprire il menu contestuale (pulsante destro del mouse) per il progetto e scegliere Manage NuGet Packages (Gestisci pacchetti NuGet).

    2. In Gestione pacchetti NuGet scegliere Browse (Sfoglia).

    3. Nella casella di ricerca, immettere AWSSDK.DynamoDBv2 e attendere il completamento della ricerca.

    4. Scegli AWSSDK.DynamoDBv2, quindi Installa.

    5. Quando l'installazione è stata completata, scegliere la tabella Program.cs per tornare al programma.

  8. Per eseguire il codice, scegliere Start nella barra degli strumenti di Visual Studio.

SDK per .NET fornisce client sicuri per lavorare con DynamoDB. Come best practice, le tue applicazioni dovrebbero creare un client e riutilizzarlo tra i thread.

Per ulteriori informazioni, consulta AWS SDK for .NET.

Nota

Gli esempi di codice in questa guida sono pensati per l'utilizzo con la versione più recente di AWS SDK per .NET.

.NET: Configurazione delle credenziali AWS

La SDK per .NET richiede di fornire le credenziali AWS all'applicazione durante il runtime. Gli esempi di codice in questa guida presuppongono che stia usando SDK Store per gestire il tuo file delle credenziali AWS, come descritto in Utilizzo di SDK Store nella Guida per gli sviluppatori di AWS SDK per .NET.

Toolkit for Visual Studio supporta più set di credenziali da qualsiasi numero di account. Ogni set viene definito profilo. Visual Studio aggiunge voci al file App.config del progetto in modo che l'applicazione possa trovare le credenziali AWS al runtime.

L'esempio seguente mostra il file App.config predefinito che viene generato quando si crea un nuovo progetto usando 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>

In fase di runtime, il programma utilizza il set default delle credenziali AWS, come specificato dalla voce AWSProfileName. Le credenziali AWS sono conservate in SDK Store in forma crittografata. Toolkit for Visual Studio fornisce un'interfaccia grafica dell'utente per gestire le credenziali, tutto all'interno di Visual Studio. Per ulteriori informazioni, consulta Specifica delle credenziali nella Guida per l'utente di AWS Toolkit for Visual Studio.

Nota

Per impostazione predefinita, gli esempi di codice accedono a DynamoDB nella regione Stati Uniti occidentali (Oregon). Puoi cambiare la regione modificando la voce AWSRegion nel file App.config. È possibile impostare AWSRegion su qualsiasi regione in cui è disponibile DynamoDB. Per l'elenco completo, consulta Regioni ed endpoint AWS in Riferimenti generali di Amazon Web Services.

.NET: Configurazione dell'endpoint e della regione AWS

Per impostazione predefinita, gli esempi di codice accedono a DynamoDB nella regione Stati Uniti occidentali (Oregon). Puoi cambiare la regione modificando la voce AWSRegion nel file App.config. Oppure, puoi modificare la regione modificando le proprietà AmazonDynamoDBClient.

Il seguente esempio di codice crea un'istanza di un nuovo AmazonDynamoDBClient. Il client viene modificato in modo che il codice venga eseguito in DynamoDB in una regione differente.

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

Per l'elenco completo delle regioni, consulta Regioni ed endpoint AWS in Riferimenti generali di Amazon Web Services.

Se si desidera eseguire gli esempi di codice usando DynamoDB in locale sul computer, impostare l'endpoint come riportato di seguito:

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