<schemeSettings>-Element (Uri-Einstellungen)

Artikel
08/10/2011

Gibt an, wie ein Uri-Objekt für bestimmte Schemen analysiert wird.

<schemeSettings> 
</schemeSettings>

Attribute und Elemente

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

Attribute

None

Untergeordnete Elemente

Element	Beschreibungen
<add>	Fügt eine Schemaeinstellung für einen Schemanamen hinzu.
<clear>	Löscht alle vorhandenen Schemaeinstellungen.
<remove>	Entfernt eine Schemaeinstellung für einen Schemanamen.

Übergeordnete Elemente

Element	Beschreibungen
<uri>	Enthält Einstellungen, die angeben, wie .NET Framework durch URIs (Uniform Resource Identifier) ausgedrückte Webadressen behandelt.

Hinweise

Standardmäßig entfernt die System.Uri-Klasse Escapezeichen aus als Prozentwert codierte Pfadtrennzeichen vor dem Ausführen der Pfadkomprimierung. Dies wurde als Sicherheitsmechanismus gegen Angriffe implementiert. Beispiel:

https://www.contoso.com/.. %2F.. %2F/Windows/System32/cmd.exe?/c+dir+c:\

Wenn dieser URI an Module übergeben wird und als Prozentwert codierte Zeichen nicht ordnungsgemäß behandelt werden, kann dies dazu führen, dass vom Server der folgende Befehl ausgeführt wird:

c:\Windows\System32\cmd.exe /c dir c:\

Aus diesem Grund entfernt die System.Uri-Klasse zuerst Escapezeichen aus Pfadtrennzeichen und wendet dann die Pfadkomprimierung an. Das Übergeben der böswilligen URL oben an den System.Uri-Klassenkonstruktor führt zum folgenden URI:

https://www.microsoft.com/Windows/System32/cmd.exe?/c+dir+c:\\

Dieses Standardverhalten kann so abgeändert werden, dass aus prozentcodierten Pfadtrennzeichen, die die schemeSettings-Konfigurationsoption für ein bestimmtes Schema verwenden, die Escapezeichen nicht gelöscht werden.

Konfigurationsdateien

Dieses Element kann in der Konfigurationsdatei der Anwendung oder in der Konfigurationsdatei des Computers (Machine.config) verwendet werden.

Beispiel

Im folgenden Codebeispiel wird ebenfalls eine von der Uri-Klasse verwendete Konfiguration gezeigt, die das Nichthinzufügen von Escapezeichen zu als Prozentwert codierten Pfadabgrenzungszeichen für das HTTP-Schema unterstützt.

<configuration>
  <uri>
    <schemeSettings>
      <add name="http" genericUriParserOptions="DontUnescapePathDotsAndSlashes"/>
    </schemeSettings>
  </uri>
</configuration>