WebPermissionAttribute.Connect Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
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.
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.