Export (0) Print
Expand All

WebRequest.ConnectionGroupName Property

When overridden in a descendant class, gets or sets the name of the connection group for the request.

[Visual Basic]
Public Overridable Property ConnectionGroupName As String
[C#]
public virtual string ConnectionGroupName {get; set;}
[C++]
public: __property virtual String* get_ConnectionGroupName();
public: __property virtual void set_ConnectionGroupName(String*);
[JScript]
public function get ConnectionGroupName() : String;
public function set ConnectionGroupName(String);

Property Value

The name of the connection group for the request.

Exceptions

Exception Type Condition
NotSupportedException Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Remarks

The ConnectionGroupName property associates specific requests within an application to one or more connection pools.

Note   The WebRequest class is an abstract (MustInherit in Visual Basic) class. The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Notes to Inheritors:  The ConnectionGroupName property typically associates a group of requests that share a set of credentials with a connection to an Internet resource to avoid potential security failures.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

WebRequest Class | WebRequest Members | System.Net Namespace | HttpWebRequest.ConnectionGroupName | Connection Grouping

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft