WebPermissionAttribute.Connect Property

Definition

Namespace:

System.Net

Assembly:

System.Security.Permissions.dll

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

public:
 property System::String ^ Connect { System::String ^ get(); void set(System::String ^ value); };

public string Connect { get; set; }

member this.Connect : string with get, set

Public Property Connect As String

Property Value

String

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

Exceptions

ArgumentException

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

Examples

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

public:
   // Set the WebPermissionAttribute  Connect property.
   [method:WebPermission(SecurityAction::Deny,Connect="http://www.contoso.com/Private.htm")]

   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 {0}", e->Message );
      }
   }

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

// 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();
}

' 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


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

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.

See also

• Introducing Pluggable Protocols