This documentation is archived and is not being maintained.

WebPermissionAttribute.ConnectPattern Property

Gets or sets a regular expression pattern that describes the URI connection controlled by the current WebPermissionAttribute.

Namespace:  System.Net
Assembly:  System (in System.dll)

'Declaration
Public Property ConnectPattern As String
'Usage
Dim instance As WebPermissionAttribute 
Dim value As String 

value = instance.ConnectPattern

instance.ConnectPattern = value

Property Value

Type: System.String
A string containing a regular expression pattern that describes the URI connection controlled by this WebPermissionAttribute.

ExceptionCondition
ArgumentException

ConnectPattern is not Nothing when you attempt to set the value. If you wish to specify more than one connect URI, use an additional attribute declaration statement.

When applying WebPermissionAttribute to your class, this property specifies what regular expression connect string is accepted for use within your class. This property is write-once.

The following example demonstrates how to use WebPermissionAttribute to specify an allowable ConnectPattern.


  ' Set the WebPermissionAttribute  ConnectPattern property.
<WebPermission(SecurityAction.Deny, ConnectPattern := "http://www\.contoso\.com/Private/.*")> _
    Public Shared Sub CheckConnectPermission(uriToCheck As String)
     Dim re As New Regex("http://www\.contoso\.com/Public/.*")
     Dim con As New WebPermission(NetworkAccess.Connect, re)
     con.Assert()
     Dim permissionToCheck As New WebPermission()
     permissionToCheck.AddPermission(NetworkAccess.Connect, uriToCheck)
     permissionToCheck.Demand()
  End Sub 'CheckConnectPermission


  Public Shared Sub demoDenySite()
     'Pass the security check.
     CheckConnectPermission("http://www.contoso.com/Public/page.htm")
     Console.WriteLine("Public page has passed Connect permission check")

     Try 
        'Throw a SecurityException.
        CheckConnectPermission("http://www.contoso.com/Private/page.htm")
        Console.WriteLine("This line will not be printed")
     Catch e As SecurityException
        Console.WriteLine(("Expected exception" + e.Message))
     End Try 
  End Sub 'demoDenySite
// Set the WebPermissionAttribute  ConnectPattern property.
[WebPermission(SecurityAction::Deny, ConnectPattern=S"http://www\\.contoso\\.com/Private/.*")]
void CheckConnectPermission(String* uriToCheck) {
   WebPermission* permissionToCheck = new WebPermission();
   permissionToCheck->AddPermission(NetworkAccess::Connect, uriToCheck);
   permissionToCheck->Demand();
}

void demoDenySite() {
   //Pass the security check.
   CheckConnectPermission(S"http://www.contoso.com/Public/page.htm");
   Console::WriteLine(S"Public page has passed Connect permission check");

   try {
      //Throw a SecurityException.
      CheckConnectPermission(S"http://www.contoso.com/Private/page.htm");
      Console::WriteLine(S"This line will not be printed");
   } catch (SecurityException* e) {
      Console::WriteLine(S"Expected exception {0}", e->Message);
   }
}

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Show: