ServicePointManagerSettings Class [IIS 7 and higher]

Represents the default settings used to create connections to a remote computer.

Syntax

class ServicePointManagerSettings : EmbeddedObject

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by the ServicePointManagerSettings class.

Name

Description

CheckCertificateName

A read/write boolean value. true to specify host name checking in an X.509 certificate; otherwise, false. The default is true.

CheckCertificateRevocationList

A read/write boolean value. true if the presented certificate is checked against the certificate authority revocation list for validation; otherwise, false. The default is false.

DnsRefreshTimeout

A read/write sint32 value that specifies the amount of time, in milliseconds, after which address information is refreshed. The default is 120000 (2 minutes). A value of -1 indicates an infinite time-out period.

EnableDnsRoundRobin

A read/write boolean value. true if round-robin DNS behavior is enabled; otherwise, false. The default is false.

NoteNote:
Round-robin DNS is a method of configuring a DNS server so that DNS requests for a particular host name are sequentially distributed across a pool of IP addresses instead of a single address.

Expect100Continue

A read/write boolean value. true if an Expect: 100-Continue header is added to client POST requests; otherwise, false. The default is true.

NoteNote:
When this property is true, client requests that use the POST method will wait to receive a 100-Continue response from the server to indicate that the client should send the data to be posted. This mechanism enables clients to avoid sending large amounts of data over the network when the server, based on the request headers, would reject the request.

UseNagleAlgorithm

A boolean value. true if the Nagle algorithm is enabled; otherwise, false. The default is true.

NoteNote:
The Nagle algorithm reduces network traffic by buffering small packets of data and transmitting them as a single packet. This process is also referred to as nagling; it is widely used because it reduces the number of packets transmitted and lowers the overhead per packet.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the ServicePointManager property of the SettingsSection class.

Inheritance Hierarchy

EmbeddedObject

   ServicePointManagerSettings

Requirements

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

See Also

Reference

EmbeddedObject Class [IIS 7 and higher]

SettingsSection Class [IIS 7 and higher]

Other Resources

WebRequest Class