Export (0) Print
Expand All

WebPermissionAttribute.Connect Property

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

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

public:
property String^ Connect {
	String^ get ();
	void set (String^ value);
}
/** @property */
public String get_Connect ()

/** @property */
public void set_Connect (String value)

public function get Connect () : String

public function set Connect (value : String)

Not applicable.

Property Value

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

Exception typeCondition

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.

When applying WebPermissionAttribute to your class, this property specifies what URI connection is accepted for use within your class. This property is write-once.

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.
/** @attribute 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.get_Message());
    }
} //DemoDenySite

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

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft