Elemento <customErrors>

Articolo
02/16/2011

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

Indica se i canali del server nel dominio di applicazione corrente restituiscono informazioni filtrate o complete sulle eccezioni ai chiamanti locali o remoti. Questo elemento può essere presente in un file di configurazione del computer e in un file di configurazione dell'applicazione ed è supportato in .NET Framework versione 1.1 o versione successiva in Microsoft Windows 98 o versione successiva.

Schema Hierarchy

<configuration>
Elemento <system.runtime.remoting>
Elemento <customErrors>

Sintassi

<customErrors  
   mode="Off|On|RemoteOnly" 
/>

Attributi ed elementi

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

Attributi

Attributo	Descrizione
mode	Attributo obbligatorio. Indica se i canali del server nel dominio di applicazione corrente restituiscono informazioni filtrate o complete sulle eccezioni ai chiamanti locali o remoti. Il valore predefinito è RemoteOnly, che restituisce informazioni complete sulle eccezioni, inclusa la traccia dello stack, solo ai chiamanti sullo stesso computer del server.

mode

Attributo obbligatorio.

Indica se i canali del server nel dominio di applicazione corrente restituiscono informazioni filtrate o complete sulle eccezioni ai chiamanti locali o remoti. Il valore predefinito è RemoteOnly, che restituisce informazioni complete sulle eccezioni, inclusa la traccia dello stack, solo ai chiamanti sullo stesso computer del server.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
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

Le informazioni complete sulle eccezioni includono l'esatta eccezione del server e la traccia dello stack del server. Le informazioni filtrate includono un'eccezione remota standard senza la traccia dello stack del server.

Nella tabella riportata di seguito vengono descritti tre valori di proprietà dei canali del server che specificano quali chiamanti riceveranno informazioni sulle eccezioni e il tipo di informazioni inviato.

Valore	Descrizione
Off	Tutti i chiamanti ricevono informazioni complete sulle eccezioni.
On	Tutti i chiamanti ricevono informazioni filtrate sulle eccezioni.
RemoteOnly	I chiamanti locali ricevono informazioni complete sulle eccezioni, mentre i chiamanti remoti ricevono informazioni filtrate.

Esempio

Nell'esempio di file di configurazione riportato di seguito il sistema di gestione remota .NET Framework riceve una richiesta di registrazione di un canale del server a nome di un dominio di applicazione client per consentire al dominio del client di passare un delegato da utilizzare come callback. Se si specifica <customErrors mode="Off"/> il server riceve informazioni complete sulle eccezioni, inclusa la traccia dello stack, se si verifica un'eccezione nel client durante il callback.

<configuration>

<system.runtime.remoting>

<application>

<client url="http://computername:8080">

<activated type="ClientActivatedType, RemoteType"/>

</client>

<channels>

<channel ref="http" port="0">

<serverProviders>

<formatter ref="soap" typeFilterLevel="Full"/>

<formatter ref="binary" typeFilterLevel="Full"/>

</serverProviders>

</channel>

</channels>

</application>

<customErrors mode="Off"/>

</system.runtime.remoting>

</configuration>

Vedere anche

Riferimento

Schema delle impostazioni remote
System.Runtime.Remoting.RemotingConfiguration.CustomErrorsEnabled(System.Boolean)

Data di compilazione: 2010-02-13

Condividi tramite