Condividi tramite

Elemento <formatter> (istanza)

  • Articolo

Questo argomento è specifico di una tecnologia legacy mantenuta per una questione di compatibilità con le applicazioni esistenti di versioni precedenti e non è consigliato per il nuovo sviluppo. Le applicazioni distribuite devono ora essere sviluppate utilizzando  Windows Communication Foundation (WCF).

Contiene il provider di sink di canale per un sink del formattatore da inserire nella catena di sink di canale. Questo elemento può essere presente in un file di configurazione del computer e in un file di configurazione dell'applicazione.

<configuration>

<system.runtime.remoting>

<channels>

<channel>

<serverProviders>

Elemento <formatter> (istanza)

Un formattatore specificato esegue l'override della catena di sink di canale predefinito per il canale in questione, sostituendosi a esso per tale modello di canale.

<configuration>

<system.runtime.remoting>

<channels>

<channel>

<clientProviders>

Elemento <formatter> (istanza)

Un formattatore specificato esegue l'override della catena di sink di canale predefinito per il canale in questione, sostituendosi a esso per tale modello di canale.

<configuration>

<system.runtime.remoting>

<application>

<channels>

<channel>

<serverProviders>

Elemento <formatter> (istanza)

Un formattatore specificato esegue l'override della catena di sink di canale predefinito per l'istanza del canale.

<configuration>

<system.runtime.remoting>

<application>

<channels>

<channel>

<clientProviders>

Elemento <formatter> (istanza)

Un formattatore specificato esegue l'override della catena di sink di canale predefinito per l'istanza del canale.

Schema Hierarchy

<configuration>
  Elemento <system.runtime.remoting>
    Elemento <application>
      Elemento <channels> (istanza)
        Elemento <channel> (istanza)
          Elemento <clientProviders> (istanza)
            Elemento <formatter> (istanza)

Sintassi

<formatter 
   ref="FormatterReference"
   type="FormatterSinkProviderType, FormatterAssembly"
   customFormatterProperty="customProperty"
   includeVersions="true"
   strictBinding="false"
...typeFilterLevel="Low | Full"
/>

Attributi ed elementi

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

Attributi

Attributo Descrizione

ref

Attributo obbligatorio.

Specifica l'ID del modello del provider di sink del formattatore per il formattatore che il client dell'utente intende registrare per l'utilizzo. Se viene specificato un attribuito ref, non è necessario specificare un attributo type.

type

Attributo obbligatorio.

Specifica il nome completo di tipo del provider di sink del formattatore e il nome dell'assembly contenente l'implementazione del provider. Se l'assembly si trova nella Global Assembly Cache, tale nome include le informazioni relative alla versione, alle impostazioni cultura e alla chiave pubblica. Questo attributo è necessario solo se non viene utilizzato un attributo ref.

customFormatterProperty

Attributo facoltativo.

Indica una proprietà personalizzata e supportata del formattatore. È possibile specificare un numero qualsiasi di proprietà del formattatore in grado di essere supportate dai formattatori personalizzati. Una proprietà personalizzata del formattatore verrà specificata con una coppia attributo/valore. Ad esempio: <formatter id="CustomFormatterSinkProvider" type="Namespace.CustomFormatterSinkProvider, CustomFormatters" customFormatterProperty="FormatterPropertyValue"/>

includeVersions

Attributo facoltativo.

Indica che un formattatore di invio include informazioni complete sulla versione dell'assembly e sul tipo durante la serializzazione delle informazioni relative al tipo. Per informazioni dettagliate, vedere la sezione Osservazioni riportata di seguito. Il valore predefinito per entrambi i formattatori forniti dal sistema è true.

strictBinding

Attributo facoltativo.

Indica che un formattatore ricevente tenterà in primo luogo di identificare il tipo utilizzando le eventuali informazioni complete sulla versione; altrimenti, utilizzerà solo il nome del tipo e il nome dell'assembly, senza le informazioni sulla versione. Per informazioni dettagliate, vedere la sezione Osservazioni riportata di seguito. Il valore predefinito per entrambi i formattatori forniti dal sistema è false.

typeFilterLevel

Attributo facoltativo.

Valore stringa che specifica il livello di deserializzazione automatica tentato dal formattatore nella catena dei sink del canale server. Valori supportati sono Low (valore predefinito) e Full. Per informazioni dettagliate sui livelli di deserializzazione, vedere Deserializzazione automatica in .NET Remoting.

Questa proprietà è supportata solo in .NET Framework versione 1.1 con le seguenti piattaforme: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional e famiglia Windows Server 2003.

Elementi figlio

Nessuno.

Elementi padre

Elemento Descrizione

application

Contiene informazioni relative a oggetti remoti utilizzati ed esposti dall'applicazione.

channel

Contiene il modello di canale che può essere specificato e configurato dall'applicazione per comunicare con oggetti remoti o per attendere richieste per tali oggetti. In tutte le posizioni in cui un canale può essere registrato per l'uso, è possibile impostare l'attributo id dell'elemento del canale dell'istanza in questione sull'attributo ref del modello.

channels

Contiene i modelli di canale utilizzati dall'applicazione per comunicare con oggetti remoti. È possibile fare riferimento ai canali dichiarati sotto questo elemento da qualsiasi posizione in cui è registrato un canale.

clientProviders

Contiene i provider per i sink di canale che devono diventare parte della catena di chiamate di sink di canale sul lato client predefinita per il modello di canale quando si fa riferimento a tale modello in altri punti del file di configurazione. Se vengono specificati provider, viene eseguito l'override dei sink di canale predefiniti per il canale. Se si desidera inserire tali sink di canale predefiniti nella catena di chiamate di sink di canale per il modello, è necessario specificare anche tali sink.

configuration

È l'elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.runtime.remoting

Contiene informazioni relative a oggetti e canali remoti.

Osservazioni

È possibile fare riferimento a un modello di provider utilizzando il relativo valore id come valore ref dell'istanza. Sebbene sia possibile dichiarare un numero qualsiasi di modelli, in una catena di chiamate di sink di canale può essere presente un solo sink del formattatore.

L'elemento di istanza <formatter> può essere inserito in quattro posizioni. Quando viene specificato sotto un elemento modello <channel>, sia nell'elemento **<serverProvider >**che in quello <clientProvider>, questo elemento specifica un formattatore che eseguirà l'override di tutti i formattatori predefiniti del canale sostituendosi a essi per il canale in questione quando viene fatto riferimento a quest'ultimo in un'istanza **<channel >**dell'applicazione. Quando l'elemento di istanza viene specificato sotto un elemento <application>, viene eseguito l'override di qualsiasi sink del formattatore dichiarato nel modello o nell'istanza di canale corrente.

Nella tabella seguente viene descritta l'interazione tra gli attributi includeVersions e strictBinding, qualora vengano utilizzati contemporaneamente.

includeVersions (formattatore di invio) strictBinding (formattatore ricevente) Modalità di caricamento del tipo

true

true

Viene caricato il tipo esatto oppure viene generata un'eccezione TypeLoadException.

false

true

Il tipo viene caricato utilizzando solo il nome del tipo e il nome dell'assembly; altrimenti viene generata un'eccezione TypeLoadException.

true

false

Se esistente, viene caricato il tipo esatto; altrimenti, il tipo viene caricato utilizzando solo il nome del tipo e il nome dell'assembly. Se il caricamento ha esito negativo, viene generata un'eccezione TypeLoadException.

false

false

Il tipo viene caricato utilizzando solo il nome del tipo e il nome dell'assembly; altrimenti viene generata un'eccezione TypeLoadException.

Esempio

Nel file di configurazione seguente viene dichiarata un'istanza <channel> che utilizza l'elemento di istanza <formatter> per specificare il provider BinaryClientFormatterSinkProvider predefinito per l'utilizzo della serializzazione binaria con il canale HttpChannel.

<configuration>
   <system.runtime.remoting>
      <application>
         <channels>
            <channel ref="http">
               <clientProviders>
                  <formatter ref="binary"/>
               </clientProviders>
            </channel>
         </channels>
         <client>
            <wellknown 
               url="http://computername:80/RemoteType.rem" 
               type="RemoteType, RemoteAssembly"
            />
         </client>
      </application>
   </system.runtime.remoting>
</configuration>

Vedere anche

Riferimento

Schema delle impostazioni remote
BinaryClientFormatterSink
SoapClientFormatterSink
BinaryServerFormatterSink
SoapServerFormatterSink

Data di compilazione: 2010-02-13