<add>-Element für webRequestModules (Netzwerkeinstellungen)

Artikel
08/20/2008

Aktualisiert: November 2007

Fügt der Anwendung eine benutzerdefinierte Webanforderung hinzu.

<configuration>-Element
  <system.Net>-Element (Netzwerkeinstellungen)
    <webRequestModules>-Element (Netzwerkeinstellungen)
      <add>-Element für webRequestModules (Netzwerkeinstellungen)

<add 
  prefix = "URI prefix" 
  type = "module name, Version, Culture, PublicKeyToken" 
/>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
prefix	Das URI-Präfix für von diesem Webanforderungsmodul behandelte Anforderungen.
type	Der Name der Assembly und der Klasse des Moduls, das dieses Webanforderungsmodul implementiert.

Untergeordnete Elemente

Keins.

Übergeordnete Elemente

Element	Beschreibung
webRequestModules	Gibt die zum Anfordern von Informationen von Netzwerkhosts verwendeten Module an.

Hinweise

Das prefix-Attribut definiert das URI-Präfix, das das angegebene Webanforderungsmodul verwendet. Webanforderungsmodule werden in der Regel zum Behandeln eines bestimmten Protokolls, wie HTTP oder FTP, registriert, können jedoch auch zum Behandeln einer Anforderung an einen bestimmten Server oder Pfad auf dem Server registriert werden.

Das Webanforderungsmodul wird erstellt, wenn ein mit dem URI übereinstimmendes Präfix an die WebRequest.Create-Methode übergeben wird.

Der Wert für das prefix-Attribut sollte den ersten Zeichen eines gültigen URL entsprechen, z. B. "http" oder "https://www.contoso.com".

Der Wert für das type-Attribut sollte ein gültiger DLL-Name und der entsprechende Klassenname sein, die durch ein Komma getrennt sind.

Konfigurationsdateien

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

Beispiel

Das folgende Codebeispiel registriert ein benutzerdefiniertes Webanforderungsmodul für HTTP. Sie sollten die Werte für Version und PublicKeyToken durch die korrekten Werte für das angegebene Modul ersetzen.

<configuration>
  <system.net>
    <webRequestModules>
      <add prefix="http"
           type="System.Net.HttpRequestCreator, System, Version=2.0.3600.0,
           Culture=neutral, PublicKeyToken=b77a5c561934e089"
      />
    </webRequestModules>
  </system.net>
</configuration>

Siehe auch

Referenz

Netzwerkeinstellungsschema

WebRequest

Freigeben über