Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

WebPermissionAttribute.ConnectPattern Property

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

[Visual Basic]
Public Property ConnectPattern As String
[C#]
public string ConnectPattern {get; set;}
[C++]
public: __property String* get_ConnectPattern();
public: __property void set_ConnectPattern(String*);
[JScript]
public function get ConnectPattern() : String;
public function set ConnectPattern(String);

Property Value

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

Exceptions

Exception Type Condition
ArgumentException ConnectPattern is not a null reference (Nothing in Visual Basic) when you attempt to set the value. If you wish to specify more than one connect URI, use an additional attribute declaration statement.

Remarks

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.

Example

[Visual Basic, C#, C++] The following example demonstrates how to use WebPermissionAttribute to specify an allowable ConnectPattern.

[Visual Basic] 

   ' 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
    
   

[C#] 

// Set the WebPermissionAttribute  ConnectPattern property.
[WebPermission(SecurityAction.Deny, ConnectPattern=@"http://www\.contoso\.com/Private/.*")]

public static void CheckConnectPermission(string uriToCheck) 
{
  WebPermission permissionToCheck = new WebPermission();
  permissionToCheck.AddPermission(NetworkAccess.Connect, uriToCheck);
  permissionToCheck.Demand();
}

public static void 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 (SecurityException e) 
  {
      Console.WriteLine("Expected exception" + e.Message);
  }

 }


[C++] 
// 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);
   }
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

WebPermissionAttribute Class | WebPermissionAttribute Members | System.Net Namespace | Regular Expression Language Elements

Show:
© 2015 Microsoft