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

Artikel
06/26/2023

Fügt der Anwendung ein benutzerdefiniertes Webanforderungsmodul hinzu.

<configuration>
  <system.net>
    <webRequestModules>
      <add>

Syntax

<add
  prefix="URI prefix"
  type="type_fullname, assembly_fullname"
/>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
`prefix`	Das URI-Präfix für Anforderungen, die von diesem Webanforderungsmodul behandelt werden
`type`	Der vollqualifizierte Typname (angegeben durch die FullName-Eigenschaft) und der Assemblyname (angegeben durch die FullName-Eigenschaft), getrennt durch ein Komma, das dieses Webanforderungsmodul implementiert.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	Beschreibung
webRequestModules	Gibt Module an, die zum Anfordern von Informationen von Netzwerkhosts verwendet werden sollen

Bemerkungen

Das prefix-Attribut definiert den URI-Präfix, der das angegebene Webanforderungsmodul verwendet. Webanforderungsmodule werden in der Regel registriert, um ein bestimmtes Protokoll wie HTTP oder FTP zu verarbeiten, können jedoch auch registriert werden, um eine Anforderung an einen bestimmten Server oder Pfad auf einem Server zu verarbeiten.

Das Webanforderungsmodul wird erstellt, wenn ein Präfix für die URI-Übereinstimmung an die WebRequest.Create-Methode übergeben wird.

Der Wert für das prefix-Attribut sollten die vorangestellten Zeichen eines gültigen URI sein. Zum Beispiel: http oder http://www.contoso.com.

Der Wert für das type-Attribut sollte ein gültiger Typname und ein entsprechender Assemblyname sein, getrennt durch ein Komma.

Konfigurationsdateien

Dieses Element kann in der Anwendungskonfigurationsdatei oder in der Computerkonfigurationsdatei ("Machine.config") verwendet werden.

Beispiel

Im folgenden Beispiel wird ein benutzerdefiniertes Webanforderungsmodul für HTTP registriert. Ersetzen Sie die Werte für Version und PublicKeyToken durch die richtigen Werte für das jeweilige Modul.

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

Freigeben über