Freigeben über


WebPermissionAttribute.ConnectPattern-Eigenschaft

Ruft ein Muster eines regulären Ausdrucks ab, das die vom aktuellen WebPermissionAttribute gesteuerte URI-Verbindung beschreibt, oder legt dieses fest.

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

Syntax

'Declaration
Public Property ConnectPattern As String
'Usage
Dim instance As WebPermissionAttribute
Dim value As String

value = instance.ConnectPattern

instance.ConnectPattern = value
public string ConnectPattern { get; set; }
public:
property String^ ConnectPattern {
    String^ get ();
    void set (String^ value);
}
/** @property */
public String get_ConnectPattern ()

/** @property */
public void set_ConnectPattern (String value)
public function get ConnectPattern () : String

public function set ConnectPattern (value : String)

Eigenschaftenwert

Eine Zeichenfolge mit einem Muster eines regulären Ausdrucks, das die von diesem WebPermissionAttribute gesteuerte URI-Verbindung beschreibt.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

Wenn Sie versuchen, den Wert festzulegen, ist ConnectPattern nicht NULL (Nothing in Visual Basic). Wenn Sie für Connect mehrere URIs angeben möchten, müssen Sie eine zusätzliche Anweisung für die Attributdeklaration verwenden.

Hinweise

Wenn WebPermissionAttribute auf die Klasse angewendet wird, gibt diese Eigenschaft die für die Verwendung in dieser Klasse akzeptierte Verbindungszeichenfolge regulärer Ausdrücke an. Diese Eigenschaft kann nur einmal festgelegt werden.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie WebPermissionAttribute zum Angeben eines zulässigen ConnectPattern verwendet wird.

  ' Set the WebPermissionAttribute  ConnectPattern property.
<WebPermission(SecurityAction.Deny, ConnectPattern := "http://www\.contoso\.com/Private/.*")> _
    Public Shared Sub CheckConnectPermission(uriToCheck As String)
     Dim re As New Regex("http://www\.contoso\.com/Public/.*")
     Dim con As New WebPermission(NetworkAccess.Connect, re)
     con.Assert()
     Dim permissionToCheck As New WebPermission()
     permissionToCheck.AddPermission(NetworkAccess.Connect, uriToCheck)
     permissionToCheck.Demand()
  End Sub 'CheckConnectPermission
  
  
  Public Shared Sub demoDenySite()
     'Pass the security check.
     CheckConnectPermission("https://www.contoso.com/Public/page.htm")
     Console.WriteLine("Public page has passed Connect permission check")
     
     Try
        'Throw a SecurityException.
        CheckConnectPermission("https://www.contoso.com/Private/page.htm")
        Console.WriteLine("This line will not be printed")
     Catch e As SecurityException
        Console.WriteLine(("Expected exception" + e.Message))
     End Try
  End Sub 'demoDenySite
   
  
  
  // Set the WebPermissionAttribute  ConnectPattern property.
  [WebPermission(SecurityAction.Deny, ConnectPattern=@"http://www\.contoso\.com/Private/.*")]

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

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

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

 }
public:
   // Set the WebPermissionAttribute ConnectPattern property.
   [WebPermission(SecurityAction::Deny,ConnectPattern="http://www\\.contoso\\.com/Private/.*")]

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

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

      try
      {
         //Throw a SecurityException.
         CheckConnectPermission( "https://www.contoso.com/Private/page.htm" );
         Console::WriteLine( "This line will not be printed" );
      }
      catch ( SecurityException^ e ) 
      {
         Console::WriteLine( "Expected exception {0}", e->Message );
      }
   }
};
// Set the WebPermissionAttribute  ConnectPattern property.
/** @attribute WebPermission(SecurityAction.Deny, ConnectPattern = 
    "http://www\\.contoso\\.com/Private/.*")
 */
public static void CheckConnectPermission(String uriToCheck)
{
    WebPermission permissionToCheck = new WebPermission();
    permissionToCheck.AddPermission(NetworkAccess.Connect, uriToCheck);
    permissionToCheck.Demand();
} //CheckConnectPermission

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

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

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebPermissionAttribute-Klasse
WebPermissionAttribute-Member
System.Net-Namespace

Weitere Ressourcen

Sprachelemente für reguläre Ausdrücke