View a markdown version of this page

Ejemplos de código .NET - Amazon DynamoDB
.NET: configuración de las credenciales de AWS.NET: configuración de la región y del punto de conexión de AWS

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:

Puede comenzar rápidamente a trabajar utilizando AWS SDK para .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. (Opcional) Descargue e instale Toolkit for Visual Studio.

  3. Configure sus credenciales de AWS. Configure un perfil de credenciales en su archivo de credenciales de AWS compartido (~/.aws/credentials). Para obtener más información, consulte Configuración de credenciales de AWS en la Guía para desarrolladores de AWS SDK para .NET.

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

  5. Busque la Aplicación de consola, seleccione la plantilla de C# destinada a .NET y, a continuación, elija Siguiente. Configure el nombre y la ubicación del proyecto y, a continuación, seleccione Crear.

  6. Agregue el paquete AWS SDK para DynamoDB NuGet al proyecto:

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

  7. En el proyecto de Visual Studio, abra Program.cs. Sustituya el contenido por el código de ejemplo de la página de documentación que desee ejecutar.

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

SDK para .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 AWS SDK para .NET.

nota

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

.NET: configuración de las credenciales de AWS

SDK para .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 para .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);