Edit

<add> Element for webRequestModules (Network Settings)

  • Article

Adds a custom Web request module to the application.

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

Syntax

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

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
prefix The URI prefix for requests handled by this Web request module.
type The fully qualified type name (indicated by the FullName property) and the assembly name (indicated by the FullName property), separated by a comma, that implements this Web request module.

Child Elements

None.

Parent Elements

Element Description
webRequestModules Specifies modules to use to request information from network hosts.

Remarks

The prefix attribute defines the URI prefix that uses the specified Web request module. Web request modules are typically registered to handle a specific protocol, such as HTTP or FTP, but can be registered to handle a request to a specific server or path on a server.

The Web request module is created when a URI matching prefix is passed to the WebRequest.Create method.

The value for the prefix attribute should be the leading characters of a valid URI. For example, http or http://www.contoso.com.

The value for the type attribute should be a valid type name and corresponding assembly name, separated by a comma.

Configuration Files

This element can be used in the application configuration file or the machine configuration file (Machine.config).

Example

The following example registers a custom Web request module for HTTP. You should replace the values for Version and PublicKeyToken with the correct values for the specified module.

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

See also