This documentation is archived and is not being maintained.

WebPermissionAttribute.Connect Property

Gets or sets the URI connection string controlled by the current WebPermissionAttribute.

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

Property Value

A string containing the URI connection controlled by the current WebPermissionAttribute.

Exceptions

Exception Type Condition
ArgumentException Connect 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 URI connection 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 Connect string.

[Visual Basic] 

   ' Set the WebPermissionAttribute  Connect property.
     <WebPermission(SecurityAction.Deny, Connect := "http://www.contoso.com/Private.htm")>  _
      Public Shared Sub CheckConnectPermission(uriToCheck As String)
      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.htm")
      Console.WriteLine("Public page has passed Connect permission check")
      Try
         'Throw a SecurityException.
         CheckConnectPermission("http://www.contoso.com/Private.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  Connect property.
[WebPermission(SecurityAction.Deny, Connect=@"http://www.contoso.com/Private.htm")]

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

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

 }

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


[C++] 
// Set the WebPermissionAttribute  Connect property.
[method:WebPermission(SecurityAction::Deny, Connect=S"http://www.contoso.com/Private.htm")]
static void demoDenySite() {
   //Pass the security check.
   CheckConnectPermission(S"http://www.contoso.com/Public.htm");
   Console::WriteLine(S"Public page has passed connect permission check");

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

static void CheckConnectPermission(String* uriToCheck) {
   WebPermission* permissionToCheck = new WebPermission();
   permissionToCheck->AddPermission(NetworkAccess::Connect, uriToCheck);
   permissionToCheck->Demand();
}

[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, Common Language Infrastructure (CLI) Standard

See Also

WebPermissionAttribute Class | WebPermissionAttribute Members | System.Net Namespace | Introducing Pluggable Protocols

Show: