Elemento <supportPortability ><supportPortability> Element

Specifica che un'applicazione può fare riferimento allo stesso assembly in due implementazioni diverse di .NET Framework, disabilitando il comportamento predefinito che tratta gli assembly come equivalenti per scopi di portabilità dell'applicazione.Specifies that an application can reference the same assembly in two different implementations of the .NET Framework, by disabling the default behavior that treats the assemblies as equivalent for application portability purposes.

<configuration> <configuration>
    <runtime >   <runtime>
    **    <assemblyBinding > **     <assemblyBinding></span>         **    <supportPortability** >      <supportPortability>

SintassiSyntax

<supportPortability PKT="public_key_token" enabled="true|false"/>  

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
PKTPKT Attributo obbligatorio.Required attribute.

Specifica il token di chiave pubblica dell'assembly interessato, sotto forma di stringa.Specifies the public key token of the affected assembly, as a string.
enabledenabled Attributo facoltativo.Optional attribute.

Specifica se è necessario abilitare il supporto per la portabilità tra le implementazioni dell'assembly .NET Framework specificato.Specifies whether support for portability between implementations of the specified .NET Framework assembly should be enabled.

Attributo enabledenabled Attribute

ValueValue DescrizioneDescription
truetrue Abilita il supporto per la portabilità tra le implementazioni dell'assembly .NET Framework specificato.Enable support for portability between implementations of the specified .NET Framework assembly. Questa è l'impostazione predefinita.This is the default.
Falsefalse Disabilitare il supporto per la portabilità tra le implementazioni dell'assembly .NET Framework specificato.Disable support for portability between implementations of the specified .NET Framework assembly. Ciò consente all'applicazione di avere riferimenti a più implementazioni dell'assembly specificato.This enables the application to have references to multiple implementations of the specified assembly.

Elementi figlioChild Elements

Nessuna.None.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Contiene informazioni sull'associazione degli assembly e sull'operazione di Garbage Collection.Contains information about assembly binding and garbage collection.
assemblyBinding Contiene le informazioni sul reindirizzamento della versione degli assembly e i relativi percorsi.Contains information about assembly version redirection and the locations of assemblies.

NoteRemarks

A partire da .NET Framework 4, il supporto viene fornito automaticamente per le applicazioni che possono usare una delle due implementazioni del .NET Framework, ad esempio l'implementazione di .NET Framework o la .NET Framework per l'implementazione di Silverlight.Beginning with the .NET Framework 4, support is automatically provided for applications that can use either of two implementations of the .NET Framework, for example either the .NET Framework implementation or the .NET Framework for Silverlight implementation. Le due implementazioni di un particolare assembly di .NET Framework sono considerate equivalenti dal binder di assembly.The two implementations of a particular .NET Framework assembly are seen as equivalent by the assembly binder. In alcuni scenari questa funzionalità di portabilità dell'applicazione causa problemi.In a few scenarios, this application portability feature causes problems. In questi scenari, è possibile usare l'elemento <supportPortability> per disabilitare la funzionalità.In those scenarios, the <supportPortability> element can be used to disable the feature.

Uno di questi scenari è costituito da un assembly che deve fare riferimento sia all'implementazione di .NET Framework sia al .NET Framework per l'implementazione Silverlight di un particolare assembly di riferimento.One such scenario is an assembly that has to reference both the .NET Framework implementation and the .NET Framework for Silverlight implementation of a particular reference assembly. Ad esempio, una finestra di progettazione XAML scritta in Windows Presentation Foundation (WPF) potrebbe dover fare riferimento sia all'implementazione desktop WPF, per l'interfaccia utente della finestra di progettazione, sia al subset di WPF incluso nell'implementazione di Silverlight.For example, a XAML designer written in Windows Presentation Foundation (WPF) might need to reference both the WPF Desktop implementation, for the designer's user interface, and the subset of WPF that is included in the Silverlight implementation. Per impostazione predefinita, i riferimenti separati provocano un errore del compilatore, poiché l'associazione di assembly considera uguali i due assembly.By default, the separate references cause a compiler error, because assembly binding sees the two assemblies as equivalent. Questo elemento Disabilita il comportamento predefinito e consente la compilazione in modo che abbia esito positivo.This element disables the default behavior, and allows compilation to succeed.

Importante

Per consentire al compilatore di passare le informazioni alla logica di associazione degli assembly del Common Language Runtime, è necessario usare l'opzione del compilatore /appconfig per specificare il percorso del file app. config che contiene questo elemento.In order for the compiler to pass the information to the common language runtime's assembly-binding logic, you must use the /appconfig compiler option to specify the location of the app.config file that contains this element.

EsempioExample

Nell'esempio seguente viene abilitata un'applicazione per avere riferimenti sia all'implementazione di .NET Framework sia al .NET Framework per l'implementazione Silverlight di qualsiasi assembly .NET Framework esistente in entrambe le implementazioni.The following example enables an application to have references to both the .NET Framework implementation and the .NET Framework for Silverlight implementation of any .NET Framework assembly that exists in both implementations. Per specificare il percorso del file app. config, è necessario usare l'opzione del compilatore /appconfig.The /appconfig compiler option must be used to specify the location of this app.config file.

<configuration>  
   <runtime>  
      <assemblyBinding>  
         <supportPortability PKT="7cec85d7bea7798e" enable="false"/>  
         <supportPortability PKT="31bf3856ad364e35" enable="false"/>  
      </assemblyBinding>  
   </runtime>  
</configuration>  

Vedere ancheSee also