WebPermissionAttribute.Connect Property

Definition

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

public string Connect { get; set; }

Property Value

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

Exceptions

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.


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

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.

Applies to

Product Versions
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also