La AWS SDK per .NET V3 è entrata in modalità manutenzione.

[Ti consigliamo di migrare alla V4.AWS SDK per .NET](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html) Per ulteriori dettagli e informazioni su come eseguire la migrazione, consulta il nostro annuncio sulla modalità di [manutenzione](https://aws.amazon.com/blogs/developer/aws-sdk-for-net-v3-maintenance-mode-announcement/).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Riferimento ai file di configurazione per AWS SDK per .NET
<a name="net-dg-config-ref"></a>

**Nota**  
Le informazioni in questo argomento sono specifiche per i progetti basati su.NET Framework. I `Web.config` file `App.config` and non sono presenti per impostazione predefinita nei progetti basati su.NET Core.

## Apri per visualizzare il contenuto di.NET Framework
<a name="w2aab9c31c11b5b1"></a>

Puoi utilizzare un progetto `App.config` o un `Web.config` file .NET per specificare AWS impostazioni, come AWS credenziali, opzioni di registrazione, endpoint di AWS servizio e AWS regioni, nonché alcune impostazioni per AWS servizi come Amazon DynamoDB, Amazon e Amazon S3. EC2 Le informazioni seguenti descrivono come formattare correttamente un file `App.config` o `Web.config` per specificare questi tipi di impostazioni.

**Nota**  
Sebbene sia possibile continuare a utilizzare l'`<appSettings>`elemento in un `Web.config` file `App.config` or per specificare AWS le impostazioni, si consiglia di utilizzare `<aws>` gli elementi `<configSections>` and come descritto più avanti in questo argomento. Per ulteriori informazioni sull'`<appSettings>`elemento, consultate gli esempi di `<appSettings>` elementi in [Configurazione AWS SDK per .NET dell'applicazione](net-dg-config.md).

**Nota**  
Sebbene sia possibile continuare a utilizzare le seguenti proprietà di [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)classe in un file di codice per specificare AWS le impostazioni, le seguenti proprietà sono obsolete e potrebbero non essere supportate nelle versioni future:  
 `DynamoDBContextTableNamePrefix` 
 `EC2UseSignatureVersion4` 
 `LoggingOptions` 
 `LogMetrics` 
 `ResponseLoggingOption` 
 `S3UseSignatureVersion4` 
In generale, invece di utilizzare le proprietà di `AWSConfigs` classe in un file di codice per specificare AWS le impostazioni, si consiglia di utilizzare gli `<aws>` elementi `<configSections>` and in un `Web.config` file `App.config` or per specificare AWS le impostazioni, come descritto più avanti in questo argomento. Per ulteriori informazioni sulle proprietà precedenti, consultate gli esempi di `AWSConfigs` codice in [Configurazione dell'applicazione AWS SDK per .NET](net-dg-config.md).

**Topics**
+ [

### Dichiarazione di una sezione delle impostazioni AWS
](#net-dg-config-ref-declaring)
+ [

### Elementi consentiti
](#net-dg-config-ref-elements)
+ [

### Riferimento per gli elementi elemento
](#net-dg-config-ref-elements-ref)

### Dichiarazione di una sezione delle impostazioni AWS
<a name="net-dg-config-ref-declaring"></a>

 AWS Le impostazioni vengono specificate in un `Web.config` file `App.config` or dall'interno dell'`<aws>`elemento. Prima di iniziare a utilizzare l'elemento `<aws>`, devi creare un elemento `<section>`, ossia un elemento figlio dell'elemento `<configSections>`, e impostare l'attributo `name` su `aws` e l'attributo `type` su `Amazon.AWSSection, AWSSDK.Core`, come nell'esempio seguente:

```
<?xml version="1.0"?>
<configuration>
  ...
  <configSections>
    <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/>
  </configSections>
  <aws>
    <!-- Add your desired AWS settings declarations here. -->
  </aws>
  ...
</configuration>
```

Visual Studio Editor non fornisce il completamento automatico del codice (IntelliSense) per l'`<aws>`elemento o i relativi elementi secondari.

Se serve assistenza per creare correttamente una versione formattata dell'elemento `<aws>`, chiama il metodo `Amazon.AWSConfigs.GenerateConfigTemplate`. Viene restituita una versione canonica dell'elemento `<aws>` sotto forma di stringa formattata che puoi adattare alle tue esigenze. Le sezioni seguenti descrivono gli attributi dell'elemento `<aws>` e i relativi elementi figlio.

### Elementi consentiti
<a name="net-dg-config-ref-elements"></a>

Di seguito è riportato un elenco delle relazioni logiche tra gli elementi consentiti in una sezione AWS delle impostazioni. Puoi generare la versione più recente di questo elenco chiamando il metodo `Amazon.AWSConfigs.GenerateConfigTemplate`, che fornisce una versione canonica dell'elemento `<aws>` sotto forma di stringa che puoi adattare alle tue esigenze.

```
<aws
  endpointDefinition="string value"
  region="string value"
  profileName="string value"
  profilesLocation="string value">
  <logging
    logTo="None, Log4Net, SystemDiagnostics"
    logResponses="Never | OnError | Always"
    logMetrics="true | false"
    logMetricsFormat="Standard | JSON"
    logMetricsCustomFormatter="NameSpace.Class, Assembly" />
  <dynamoDB
    conversionSchema="V1 | V2">
    <dynamoDBContext
      tableNamePrefix="string value">
      <tableAliases>
        <alias
          fromTable="string value"
          toTable="string value" />
      </tableAliases>
      <map
        type="NameSpace.Class, Assembly"
        targetTable="string value">
        <property
          name="string value"
          attribute="string value"
          ignore="true | false"
          version="true | false"
          converter="NameSpace.Class, Assembly" />
      </map>
    </dynamoDBContext>
  </dynamoDB>
  <s3
    useSignatureVersion4="true | false" />
  <ec2
    useSignatureVersion4="true | false" />
  <proxy
    host="string value"
    port="1234"
    username="string value"
    password="string value" />
</aws>
```

### Riferimento per gli elementi elemento
<a name="net-dg-config-ref-elements-ref"></a>

Di seguito è riportato un elenco degli elementi consentiti in una sezione AWS delle impostazioni. Per ogni elemento sono elencati gli attributi e gli elementi padre-figlio consentiti.

**Topics**
+ [

#### alias
](#net-dg-config-ref-elements-alias)
+ [

#### `aws`
](#net-dg-config-ref-elements-aws)
+ [

#### dynamoDB
](#net-dg-config-ref-elements-dynamodb)
+ [

#### dinamo DBContext
](#net-dg-config-ref-elements-ddbcontext)
+ [

#### ec2
](#net-dg-config-ref-elements-ec2)
+ [

#### logging
](#net-dg-config-ref-elements-logging)
+ [

#### map
](#net-dg-config-ref-elements-map)
+ [

#### property
](#net-dg-config-ref-elements-property)
+ [

#### proxy
](#net-dg-config-ref-elements-proxy)
+ [

#### s3
](#net-dg-config-ref-elements-s3)

#### alias
<a name="net-dg-config-ref-elements-alias"></a>

L'elemento `<alias>` rappresenta un singolo elemento in una raccolta di una o più mappature da from-table a to-table che specifica una tabella diversa rispetto a quella configurata per un tipo. Questo elemento viene mappato a un'istanza della classe `Amazon.Util.TableAlias` dalla proprietà `Amazon.AWSConfigs.DynamoDBConfig.Context.TableAliases` in AWS SDK per .NET. La ri-mappatura viene eseguita prima di applicare un prefisso al nome della tabella.

Questo elemento può includere gli attributi seguenti:

** `fromTable` **  
La parte from-table della mappatura da from-table a to-table. Questo attributo viene mappato alla proprietà `Amazon.Util.TableAlias.FromTable` in AWS SDK per .NET.

** `toTable` **  
La parte to-table della mappatura da from-table a to-table. Questo attributo viene mappato alla proprietà `Amazon.Util.TableAlias.ToTable` in AWS SDK per .NET.

Il padre dell'elemento `<alias>` è l'elemento `<tableAliases>`.

L'elemento `<alias>` non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento `<alias>` in uso:

```
<alias
  fromTable="Studio"
  toTable="Studios" />
```

#### `aws`
<a name="net-dg-config-ref-elements-aws"></a>

L'`<aws>`elemento rappresenta l'elemento più in alto in una sezione AWS delle impostazioni. Questo elemento può includere gli attributi seguenti:

** `endpointDefinition` **  
Il percorso assoluto di un file di configurazione personalizzato che definisce le AWS regioni e gli endpoint da utilizzare. Questo attributo viene mappato alla proprietà `Amazon.AWSConfigs.EndpointDefinition` in AWS SDK per .NET.

** `profileName` **  
Il nome del profilo per AWS le credenziali archiviate che verranno utilizzate per effettuare chiamate di servizio. Questo attributo viene mappato alla proprietà `Amazon.AWSConfigs.AWSProfileName` in AWS SDK per .NET.

** `profilesLocation` **  
Il percorso assoluto della posizione del file delle credenziali condiviso con altri. AWS SDKs Per impostazione predefinita, il file delle credenziali viene archiviato nella directory `.aws` nella directory principale dell'utente corrente. Questo attributo viene mappato alla proprietà `Amazon.AWSConfigs.AWSProfilesLocation` in AWS SDK per .NET.

** `region` **  
L'ID di AWS regione predefinito per i client che non hanno specificato esplicitamente una regione. Questo attributo viene mappato alla proprietà `Amazon.AWSConfigs.AWSRegion` in AWS SDK per .NET.

L'elemento `<aws>` non ha elementi padre.

L'elemento `<aws>` può contenere i seguenti elementi figlio:
+  `<dynamoDB>` 
+  `<ec2>` 
+  `<logging>` 
+  `<proxy>` 
+  `<s3>` 

Di seguito è illustrato un esempio dell'elemento `<aws>` in uso:

```
<aws
  endpointDefinition="C:\Configs\endpoints.xml"
  region="us-west-2"
  profileName="development"
  profilesLocation="C:\Configs">
  <!-- ... -->
</aws>
```

#### dynamoDB
<a name="net-dg-config-ref-elements-dynamodb"></a>

L'elemento `<dynamoDB>` rappresenta una raccolta di impostazioni per Amazon DynamoDB. Questo elemento può includere l'attributo *conversionSchema*, che rappresenta la versione da utilizzare per la conversione di oggetti .NET e DynamoDB. I valori consentiti includono V1 e V2. Questo attributo viene mappato alla classe `Amazon.DynamoDBv2.DynamoDBEntryConversion` in AWS SDK per .NET. Per ulteriori informazioni, vedi [DynamoDB Series - Schemi di conversione](http://blogs.aws.amazon.com/net/post/Tx2TCOGWG7ARUH5/DynamoDB-Series-Conversion-Schemas).

Il padre dell'elemento `<dynamoDB>` è l'elemento `<aws>`.

L'elemento `<dynamoDB>` può contenere l'elemento figlio `<dynamoDBContext>`.

Di seguito è illustrato un esempio dell'elemento `<dynamoDB>` in uso:

```
<dynamoDB
  conversionSchema="V2">
  <!-- ... -->
</dynamoDB>
```

#### dinamo DBContext
<a name="net-dg-config-ref-elements-ddbcontext"></a>

L'elemento `<dynamoDBContext>` rappresenta una raccolta di impostazioni specifiche per il contesto di Amazon DynamoDB. Questo elemento può includere l'*tableNamePrefix*attributo, che rappresenta il prefisso del nome di tabella predefinito che il contesto DynamoDB utilizzerà se non è configurato manualmente. Questo attributo viene mappato alla proprietà `Amazon.Util.DynamoDBContextConfig.TableNamePrefix` dalla proprietà `Amazon.AWSConfigs.DynamoDBConfig.Context.TableNamePrefix` in AWS SDK per .NET. Per ulteriori informazioni, vedi [Miglioramenti all'SDK DynamoDB](http://blogs.aws.amazon.com/net/post/Tx2C4MHH2H0SA5W/Enhancements-to-the-DynamoDB-SDK).

Il padre dell'elemento `<dynamoDBContext>` è l'elemento `<dynamoDB>`.

L'elemento `<dynamoDBContext>` può contenere i seguenti elementi figlio:
+  `<alias>` (una o più istanze)
+  `<map>` (una o più istanze)

Di seguito è illustrato un esempio dell'elemento `<dynamoDBContext>` in uso:

```
<dynamoDBContext
  tableNamePrefix="Test-">
  <!-- ... -->
</dynamoDBContext>
```

#### ec2
<a name="net-dg-config-ref-elements-ec2"></a>

L'`<ec2>`elemento rappresenta una raccolta di EC2 impostazioni Amazon. Questo elemento può includere l'attributo *useSignatureVersion4*, che specifica se la firma della versione 4 della firma verrà utilizzata per tutte le richieste (true) o se la firma della versione 4 della firma non verrà utilizzata per tutte le richieste (false, l'impostazione predefinita). Questo attributo viene mappato alla proprietà `Amazon.Util.EC2Config.UseSignatureVersion4` dalla proprietà `Amazon.AWSConfigs.EC2Config.UseSignatureVersion4` in AWS SDK per .NET.

Il padre dell'elemento `<ec2>` è l'elemento.

L'elemento `<ec2>` non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento `<ec2>` in uso:

```
<ec2
  useSignatureVersion4="true" />
```

#### logging
<a name="net-dg-config-ref-elements-logging"></a>

L'elemento `<logging>` rappresenta una raccolta di impostazioni per la registrazione delle risposte e la registrazione dei parametri delle prestazioni. Questo elemento può includere gli attributi seguenti:

** `logMetrics` **  
Indica se i parametri delle prestazioni sono registrati per tutti i client e le configurazioni (true) o meno (false). Questo attributo viene mappato alla proprietà `Amazon.Util.LoggingConfig.LogMetrics` dalla proprietà `Amazon.AWSConfigs.LoggingConfig.LogMetrics` in AWS SDK per .NET.

** `logMetricsCustomFormatter` **  
Il tipo di dati e il nome dell'assembly di un formattatore personalizzato per i parametri di registrazione. Questo attributo viene mappato alla proprietà `Amazon.Util.LoggingConfig.LogMetricsCustomFormatter` dalla proprietà `Amazon.AWSConfigs.LoggingConfig.LogMetricsCustomFormatter` in AWS SDK per .NET.

** `logMetricsFormat` **  
Il formato in cui vengono visualizzati i parametri di registrazione (mappato alla proprietà `Amazon.Util.LoggingConfig.LogMetricsFormat` dalla proprietà `Amazon.AWSConfigs.LoggingConfig.LogMetricsFormat` in AWS SDK per .NET).  
I valori autorizzati includono:    
** `JSON` **  
Utilizza il formato JSON.  
** `Standard` **  
Utilizza formato predefinito.

** `logResponses` **  
Quando registrare le risposte del servizio (mappato alla proprietà `Amazon.Util.LoggingConfig.LogResponses` dalla proprietà `Amazon.AWSConfigs.LoggingConfig.LogResponses` in AWS SDK per .NET).  
I valori autorizzati includono:    
** `Always` **  
Registra sempre le risposte di servizio.  
** `Never` **  
Non registrare mai le risposte di servizio.  
** `OnError` **  
Registra le risposte del servizio solo quando ci sono errori.

** `logTo` **  
Dove effettuare il login (mappa la `LogTo` proprietà dalla `Amazon.AWSConfigs.LoggingConfig.LogTo` proprietà in AWS SDK per .NET).  
I valori consentiti includono uno o più:    
** `Log4Net` **  
Accedi a log4net.  
** `None` **  
Disabilita la registrazione.  
** `SystemDiagnostics` **  
Accedi a System.Diagnostics.

Il padre dell'elemento `<logging>` è l'elemento `<aws>`.

L'elemento `<logging>` non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento `<logging>` in uso:

```
<logging
  logTo="SystemDiagnostics"
  logResponses="OnError"
  logMetrics="true"
  logMetricsFormat="JSON"
  logMetricsCustomFormatter="MyLib.Util.MyMetricsFormatter, MyLib" />
```

#### map
<a name="net-dg-config-ref-elements-map"></a>

L'`<map>`elemento rappresenta un singolo elemento in una raccolta di type-to-table mappature dai tipi.NET alle tabelle DynamoDB (esegue il mapping a un'istanza della `TypeMapping` classe dalla proprietà in). `Amazon.AWSConfigs.DynamoDBConfig.Context.TypeMappings` AWS SDK per .NET Per ulteriori informazioni, vedi [Miglioramenti all'SDK DynamoDB](http://blogs.aws.amazon.com/net/post/Tx2C4MHH2H0SA5W/Enhancements-to-the-DynamoDB-SDK).

Questo elemento può includere gli attributi seguenti:

** `targetTable` **  
La tabella DynamoDB a cui si applica la mappatura. Questo attributo viene mappato alla proprietà `Amazon.Util.TypeMapping.TargetTable` in AWS SDK per .NET.

** `type` **  
Il tipo e il nome dell'assembly a cui si applica la mappatura. Questo attributo viene mappato alla proprietà `Amazon.Util.TypeMapping.Type` in AWS SDK per .NET.

Il padre dell'elemento `<map>` è l'elemento `<dynamoDBContext>`.

L'elemento `<map>` può includere una o più istanze dell'elemento figlio `<property>`.

Di seguito è illustrato un esempio dell'elemento `<map>` in uso:

```
<map
  type="SampleApp.Models.Movie, SampleDLL"
  targetTable="Movies">
  <!-- ... -->
</map>
```

#### property
<a name="net-dg-config-ref-elements-property"></a>

L'elemento `<property>` rappresenta una proprietà di DynamoDB. (Questo elemento è mappato a un'istanza di Amazon.Util. PropertyConfig [classe dal `AddProperty` metodo in AWS SDK per .NET) Per ulteriori informazioni, consulta [Miglioramenti all'SDK di DynamoDB e agli attributi di DynamoDB](http://blogs.aws.amazon.com/net/post/Tx2C4MHH2H0SA5W/Enhancements-to-the-DynamoDB-SDK).](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DeclarativeTagsList.html)

Questo elemento può includere gli attributi seguenti:

** `attribute` **  
Il nome di un attributo per la proprietà, ad esempio il nome di una chiave di intervallo. Questo attributo viene mappato alla proprietà `Amazon.Util.PropertyConfig.Attribute` in AWS SDK per .NET.

** `converter` **  
Il tipo di convertitore da utilizzare per questa proprietà. Questo attributo viene mappato alla proprietà `Amazon.Util.PropertyConfig.Converter` in AWS SDK per .NET.

** `ignore` **  
Indica se proprietà associata debba essere ignorata (true) o meno (false). Questo attributo viene mappato alla proprietà `Amazon.Util.PropertyConfig.Ignore` in AWS SDK per .NET.

** `name` **  
Il nome della proprietà. Questo attributo viene mappato alla proprietà `Amazon.Util.PropertyConfig.Name` in AWS SDK per .NET.

** `version` **  
Indica se la proprietà debba archiviare il numero di versione dell'elemento (true) o meno (false). Questo attributo viene mappato alla proprietà `Amazon.Util.PropertyConfig.Version` in AWS SDK per .NET.

Il padre dell'elemento `<property>` è l'elemento `<map>`.

L'elemento `<property>` non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento `<property>` in uso:

```
<property
  name="Rating"
  converter="SampleApp.Models.RatingConverter, SampleDLL" />
```

#### proxy
<a name="net-dg-config-ref-elements-proxy"></a>

L'elemento `<proxy>` rappresenta le impostazioni per la configurazione di un proxy da utilizzare con AWS SDK per .NET . Questo elemento può includere gli attributi seguenti:

**host**  
L'indirizzo IP o il nome host del server proxy. Questo attributo viene mappato alla proprietà `Amazon.Util.ProxyConfig.Host` dalla proprietà `Amazon.AWSConfigs.ProxyConfig.Host` in AWS SDK per .NET.

**password**  
La password per eseguire l'autenticazione con il server proxy. Questo attributo viene mappato alla proprietà `Amazon.Util.ProxyConfig.Password` dalla proprietà `Amazon.AWSConfigs.ProxyConfig.Password` in AWS SDK per .NET.

**port**  
Il numero di porta del proxy. Questo attributo viene mappato alla proprietà `Amazon.Util.ProxyConfig.Port` dalla proprietà `Amazon.AWSConfigs.ProxyConfig.Port` in AWS SDK per .NET.

**username**  
Il nome utente per eseguire l'autenticazione con il server proxy. Questo attributo viene mappato alla proprietà `Amazon.Util.ProxyConfig.Username` dalla proprietà `Amazon.AWSConfigs.ProxyConfig.Username` in AWS SDK per .NET.

Il padre dell'elemento `<proxy>` è l'elemento `<aws>`.

L'elemento `<proxy>` non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento `<proxy>` in uso:

```
<proxy
  host="192.0.2.0"
  port="1234"
  username="My-Username-Here"
  password="My-Password-Here" />
```

#### s3
<a name="net-dg-config-ref-elements-s3"></a>

L'elemento `<s3>` rappresenta una raccolta di impostazioni di Amazon S3. Questo elemento può includere l'attributo *useSignatureVersion4*, che specifica se la firma della versione 4 della firma verrà utilizzata per tutte le richieste (true) o se la firma della versione 4 della firma non verrà utilizzata per tutte le richieste (false, l'impostazione predefinita). Questo attributo viene mappato alla proprietà `Amazon.AWSConfigs.S3Config.UseSignatureVersion4` in AWS SDK per .NET.

Il padre dell'elemento `<s3>` è l'elemento `<aws>`.

L'elemento `<s3>` non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento `<s3>` in uso:

```
<s3 useSignatureVersion4="true" />
```