<customErrors>-Element

Artikel
02/13/2011

Dieses Thema bezieht sich auf eine veraltete Technologie, die zum Zwecke der Abwärtskompatibilität mit vorhandenen Anwendungen beibehalten wird und nicht für die neue Entwicklung empfohlen wird. Verteilte Anwendungen sollten jetzt mit Windows Communication Foundation (WCF) entwickelt werden.

Gibt an, ob die Serverchannel in dieser Anwendungsdomäne gefilterte oder vollständige Informationen über Ausnahmen an lokale oder Remoteaufrufer zurückgeben. Dieses Element kann in einer Anwendungskonfigurationsdatei oder einer Computerkonfigurationsdatei auftreten. Dieses Element wird im .NET Framework, Version 1.1 oder höher unter Microsoft Windows 98 oder höher unterstützt.

Schema Hierarchy

<configuration>
<system.runtime.remoting>-Element
<customErrors>-Element

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
mode	Erforderliches Attribut. Gibt an, ob die Serverchannel in dieser Anwendungsdomäne gefilterte oder vollständige Informationen über Ausnahmen an lokale oder Remoteaufrufer zurückgeben. Der Standardwert ist RemoteOnly, der vollständige Ausnahmeinformationen (einschließlich Stapelüberwachung) nur an Aufrufer auf dem Computer zurückgibt, auf dem sich der Server befindet.

mode

Erforderliches Attribut.

Gibt an, ob die Serverchannel in dieser Anwendungsdomäne gefilterte oder vollständige Informationen über Ausnahmen an lokale oder Remoteaufrufer zurückgeben. Der Standardwert ist RemoteOnly, der vollständige Ausnahmeinformationen (einschließlich Stapelüberwachung) nur an Aufrufer auf dem Computer zurückgibt, auf dem sich der Server befindet.

Untergeordnete Elemente

Keines.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
system.runtime.remoting	Enthält Informationen über Remoteobjekte und Channels.

Hinweise

Vollständige Ausnahmeinformationen beinhalten die genaue Serverausnahme und die Serverstapelüberwachung. Gefilterte Informationen schließen eine Standardremotingausnahme, aber nicht die Serverstapelüberwachung ein.

In der folgenden Tabelle werden die drei Serverchannel-Eigenschaftenwerte erläutert, die angeben, welche Aufrufer welche Art von Ausnahmeinformationen erhalten.

Wert	Beschreibung
Off	Alle Aufrufer erhalten vollständige Ausnahmeinformationen.
On	Alle Aufrufer erhalten gefilterte Ausnahmeinformationen.
RemoteOnly	Lokale Aufrufer erhalten vollständige Ausnahmeinformationen, Remoteaufrufer erhalten gefilterte Ausnahmeinformationen.

Beispiel

Das folgende Beispiel einer Konfigurationsdatei weist das .NET Framework-Remotesystem an, einen Serverchannel für eine Clientanwendungsdomäne zu registrieren, sodass die Clientdomäne einen Delegaten übergeben kann, der als Rückruf verwendet werden soll. Durch Angabe von <customErrors mode="Off"/> erhält der Server vollständige Ausnahmeinformationen einschließlich der Stapelüberwachung, wenn beim Rückruf eine Ausnahme auf dem Client auftritt.

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

Siehe auch

Verweis

Schema für Remoteeinstellungen
System.Runtime.Remoting.RemotingConfiguration.CustomErrorsEnabled(System.Boolean)

Erstellungsdatum: 2010-02-13