Ejemplos de código .NET

Esta guía contiene fragmentos de código .NET y programas listos para ejecutarlos. Encontrará estos ejemplos de código en las secciones siguientes:

• Uso de elementos y atributos

• Uso de tablas y datos en DynamoDB

• Operaciones de consulta en DynamoDB

• Uso de operaciones de análisis en DynamoDB

• Uso de índices secundarios para mejorar el acceso a los datos

• .NET: modelo de documento

• .NET: modelo de persistencia de objetos

• Captura de datos de cambios para DynamoDB Streams

Puede comenzar rápidamente a trabajar utilizando AWS SDK for .NET con Toolkit for Visual Studio.

Para ejecutar los ejemplos de código .NET (mediante Visual Studio)

1. Descargue e instale Microsoft Visual Studio.

2. Descargar e instalar Toolkit for Visual Studio.

3. Inicie Visual Studio. Elija File (Archivo), New (Nuevo), Project (Proyecto).

4. En Nuevo proyecto, elija Proyecto vacío de AWS y, después, elija Aceptar.

5. En Credenciales de acceso de AWS, elija Usar perfil existente, elija el perfil de sus credenciales de la lista y, a continuación, elija Aceptar.

   Si es la primera vez que utiliza Toolkit for Visual Studio, elija Use a new profile (Usar un nuevo perfil) para configurar las credenciales de AWS.

6. En el proyecto de Visual Studio, elija la pestaña correspondiente al código fuente del programa (Program.cs). Copie el ejemplo de código de la página de documentación en el editor de Visual Studio sustituyendo cualquier otro código que aparezca en el editor.

7. Si aparece algún mensaje de error como The type or namespace name...could not be found (El tipo o el nombre de espacio de nombres...no se ha podido encontrar), debe instalar el ensamblado del SDK de AWS para DynamoDB como se indica a continuación:

   1. En el Explorador de soluciones, abra el menú contextual (haga clic con el botón derecho) del proyecto y elija Administrar paquetes NuGet.

   2. En Administrador de paquetes NuGet, elija Examinar.

   3. En el cuadro de búsqueda, introduzca AWSSDK.DynamoDBv2 y espere a que se lleve a cabo la búsqueda.

   4. Elija AWSSDK.DynamoDBv2 y después elija Install (Instalar).

   5. Cuando se haya completado la instalación, elija la pestaña Program.cs para volver al programa.

8. Para ejecutar el código, elija Iniciar en la barra de herramientas de Visual Studio.

AWS SDK for .NET proporciona clientes seguros para subprocesos con el fin de trabajar con DynamoDB. Como práctica recomendada, sus aplicaciones deben crear un cliente y reutilizar el cliente entre subprocesos.

Para obtener más información, consulte el SDK para .NET de AWS.

nota

Los ejemplos de código de esta guía se han diseñado para utilizarlos con la última versión del AWS SDK for .NET.

.NET: configuración de las credenciales de AWS

AWS SDK for .NET requiere que proporcione las credenciales de AWS a su aplicación en tiempo de ejecución. En los ejemplos de código de esta guía se supone que se usa el SDK Store para administrar el archivo de credenciales de AWS, tal como se describe en Uso del SDK Store en la Guía para desarrolladores de AWS SDK for .NET.

Toolkit for Visual Studio admite varios conjuntos de credenciales de cualquier cantidad de cuentas. Cada conjunto se conoce como perfil. Visual Studio agrega entradas al archivo App.config del proyecto, para que la aplicación encuentre las credenciales de AWS en tiempo de ejecución.

En el siguiente ejemplo se muestra el archivo App.config predeterminado que se genera al crear un nuevo proyecto con 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>

En tiempo de ejecución, el programa usa el conjunto default de credenciales de AWS, según lo especificado en la entrada AWSProfileName. Las credenciales de AWS en sí se conservan en SDK Store, cifradas. Toolkit for Visual Studio proporciona una interfaz gráfica de usuario para administrar las credenciales, todo ello desde Visual Studio. Para obtener más información, consulte Especificación de credenciales en la Guía del usuario de AWS Toolkit for Visual Studio.

nota

De forma predeterminada, los ejemplos de código acceden a DynamoDB en la región EE. UU. Oeste (Oregón). Puede cambiar la región modificando la entrada AWSRegion en el archivo App.config. Puede establecer AWSRegion en cualquier región donde DynamoDB esté disponible. Para obtener una lista completa, consulte Regiones de AWS y puntos de conexión en la Referencia general de Amazon Web Services.

.NET: configuración de la región y del punto de conexión de AWS

De forma predeterminada, los ejemplos de código acceden a DynamoDB en la región EE. UU. Oeste (Oregón). Puede cambiar la región modificando la entrada AWSRegion en el archivo App.config. O bien puede cambiar la región modificando las propiedades de AmazonDynamoDBClient.

En el siguiente ejemplo de código se crea una nueva instancia de AmazonDynamoDBClient. El cliente se modifica de tal forma que el código se ejecute en DynamoDB en otra región.

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

Para obtener una lista completa de las regiones, consulte Regiones de AWS y puntos de conexión en la Referencia general de Amazon Web Services.

Si desea ejecutar los ejemplos de código en DynamoDB localmente en su ordenador, configure el punto de enlace como se indica a continuación.

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