<Elemento providerOption>

  • Articolo

Specifica gli attributi della versione del compilatore per un provider di linguaggi.

<Configurazione>
  <system.codedom>
    <Compilatori>
      <Compilatore>
        <providerOption>

Sintassi

<providerOption  
  name="option-name"  
  value="option-value"  
/>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
name Attributo obbligatorio.

Specifica il nome dell'opzione; ad esempio "CompilerVersion".
value Attributo obbligatorio.

Specifica il valore per l'opzione; ad esempio "v3.5".

Elementi figlio

Nessuno.

Elementi padre

Elemento Descrizione
<Elemento configuration> Elemento radice in ogni file di configurazione utilizzato dal Common Language Runtime e dalle applicazioni .NET Framework.
<Elemento system.codedom> Specifica le impostazioni di configurazione del compilatore per i provider di linguaggi disponibili.
<Elemento compilers> Contenitore per gli elementi di configurazione del compilatore; contiene zero o più <compiler> elementi.
<Elemento compiler> Specifica gli attributi di configurazione del compilatore per un provider del linguaggio.

Osservazioni:

In .NET Framework versione 3.5, i provider di codice Code DOCUMENT Object Model (CodeDOM) possono supportare opzioni specifiche del provider usando l'elemento <providerOption> .

.NET Framework 3.5 include assembly .NET Framework 2.0 aggiornati e fornisce nuovi assembly versione 3.5 che contengono nuovi tipi. I provider di codice Microsoft C# e Visual Basic sono contenuti negli assembly .NET Framework 2.0, ma sono stati aggiornati per supportare i compilatori versione 3.5. Per impostazione predefinita, i provider di codice aggiornati generano codice per i compilatori versione 2.0. È possibile usare l'elemento <providerOption> per modificare la versione del compilatore di destinazione in 3.5. A tale scopo, specificare "CompilerVersion" per l'attributo name e "v3.5" per l'attributo value . È necessario precedere il numero di versione con una minuscola "v".

È possibile rendere globale la specifica della versione aggiungendo l'elemento <providerOption> al file Machine.config di .NET Framework 2.0 o Web.config radice. Se si aggiorna la versione predefinita del compilatore alla versione 3.5 nel file Machine.config, è possibile ripristinare la versione 2.0 in base all'applicazione usando l'elemento <providerOption> nel file di configurazione dell'applicazione.

Gli implementatori del provider di codice CodeDOM possono elaborare opzioni personalizzate fornendo un costruttore che accetta un providerOptions parametro di tipo IDictionary<TKey,TValue>.

Esempio

Nell'esempio seguente viene illustrato come specificare che deve essere usata la versione 3.5 del provider di codice C#.

<configuration>  
  <system.codedom>  
    <compilers>  
      <!-- zero or more compiler elements -->  
      <compiler  
        language="c#;cs;csharp"  
        extension=".cs"  
        type="Microsoft.CSharp.CSharpCodeProvider, System,
          Version=2.0.3600.0, Culture=neutral,
          PublicKeyToken=b77a5c561934e089"  
        compilerOptions="/optimize"  
        warningLevel="1" >  
          <providerOption  
            name="CompilerVersion"  
            value="v3.5" />  
      </compiler>  
    </compilers>  
  </system.codedom>  
</configuration>

Vedi anche