WebPermission.AddPermission Methode

Definition

Namespace:

System.Net

Assembly:

System.Security.Permissions.dll

Fügt der aktuellen WebPermission den angegebenen URI mit den angegebenen Zugriffsrechten hinzu.

Überlädt

AddPermission(NetworkAccess, String)	Fügt der aktuellen WebPermission die angegebene URI-Zeichenfolge mit den angegebenen Zugriffsrechten hinzu.
AddPermission(NetworkAccess, Regex)	Fügt der aktuellen WebPermission den angegebenen URI mit den angegebenen Zugriffsrechten hinzu.

AddPermission(NetworkAccess, String)

Fügt der aktuellen WebPermission die angegebene URI-Zeichenfolge mit den angegebenen Zugriffsrechten hinzu.

public:
 void AddPermission(System::Net::NetworkAccess access, System::String ^ uriString);

public void AddPermission (System.Net.NetworkAccess access, string uriString);

member this.AddPermission : System.Net.NetworkAccess * string -> unit

Public Sub AddPermission (access As NetworkAccess, uriString As String)

Parameter

access

NetworkAccess

Ein NetworkAccess, der die Zugriffsrechte angibt, die dem URI gewährt werden.

uriString

String

Eine Zeichenfolge, die den URI beschreibt, dem Zugriffsrechte erteilt werden.

Ausnahmen

ArgumentNullException

uriString ist null.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie bestimmten URL-Zeichenfolgen Zugriffsrechte hinzufügen.

// Allow access to the first set of resources.
myWebPermission1->AddPermission( NetworkAccess::Connect, "http://www.contoso.com/default.htm" );
myWebPermission1->AddPermission( NetworkAccess::Connect, "http://www.adventure-works.com/default.htm" );

// Check whether if the callers higher in the call stack have been granted
// access permissions.
myWebPermission1->Demand();

  // Allow access to the first set of resources.
  myWebPermission1.AddPermission(NetworkAccess.Connect,"http://www.contoso.com/default.htm");
  myWebPermission1.AddPermission(NetworkAccess.Connect,"http://www.adventure-works.com/default.htm");

  // Check whether if the callers higher in the call stack have been granted 
  // access permissions.
  myWebPermission1.Demand();

' Allow access to the first set of resources.
myWebPermission1.AddPermission(NetworkAccess.Connect, "http://www.contoso.com/default.htm")
myWebPermission1.AddPermission(NetworkAccess.Connect, "http://www.adventure-works.com/default.htm")

' Check whether if the callers higher in the call stack have been granted 
' access permissions.
myWebPermission1.Demand()

Hinweise

Wenn Sie als angegeben None haben, verwenden SieAddPermission, um die Verwendung von uriString in der Zielklasse zuzulassenPermissionState. Die Art und Weise, die von der Zielklasse verwendet werden kann, uriString wird durch accessangegeben. Geben Sie Accept als Zugriffsparameter an, um den vom uriString Parameter angegebenen URI der Liste der URI-Annahmezeichenfolgen hinzuzufügen, oder geben Sie Connect als Zugriffsparameter an, um den URI der Liste der URI-Verbindungszeichenfolgen hinzuzufügen.

Hinweis

Das Aufrufen AddPermission von UnrestrictedWebPermission hat keine Auswirkung, da allen URIs die Berechtigung erteilt wird.

Hinweis

Eine Kandidaten-URI-Zeichenfolge wird auf zwei Arten anhand der Liste der relevanten regulären Ausdrücke (AcceptList oder ConnectList) überprüft. Zunächst wird die Zeichenfolge des Kandidaten-URI anhand der entsprechenden Liste überprüft. Wenn dann keine Übereinstimmung vorhanden ist, wird die Zeichenfolge des Kandidaten-URI in eine Uri konvertiert und mit der entsprechenden Liste überprüft.

Weitere Informationen

• NetworkAccess

AddPermission(NetworkAccess, Regex)

Fügt der aktuellen WebPermission den angegebenen URI mit den angegebenen Zugriffsrechten hinzu.

public:
 void AddPermission(System::Net::NetworkAccess access, System::Text::RegularExpressions::Regex ^ uriRegex);

public void AddPermission (System.Net.NetworkAccess access, System.Text.RegularExpressions.Regex uriRegex);

member this.AddPermission : System.Net.NetworkAccess * System.Text.RegularExpressions.Regex -> unit

Public Sub AddPermission (access As NetworkAccess, uriRegex As Regex)

Parameter

access

NetworkAccess

Ein NetworkAccess, der die Zugriffsrechte angibt, die dem URI gewährt werden.

uriRegex

Regex

Ein regulärer Ausdruck, der den Satz der URIs beschreibt, dem Zugriffsrechte erteilt werden.

Ausnahmen

ArgumentNullException

Der uriRegex-Parameter ist null.

Beispiele

Im folgenden Beispiel wird verwendet AddPermission , um Zugriffsrechte für den angegebenen URI zu erteilen.

// Create a WebPermission.
WebPermission^ myWebPermission1 = gcnew WebPermission;

// Allow Connect access to the specified URLs.
myWebPermission1->AddPermission( NetworkAccess::Connect, gcnew Regex( "http://www\\.contoso\\.com/.*",
   (RegexOptions)(RegexOptions::Compiled | RegexOptions::IgnoreCase | RegexOptions::Singleline) ) );

myWebPermission1->Demand();

// Create a WebPermission.
WebPermission myWebPermission1 = new WebPermission();

// Allow Connect access to the specified URLs.
myWebPermission1.AddPermission(NetworkAccess.Connect,new Regex("http://www\\.contoso\\.com/.*", 
  RegexOptions.Compiled | RegexOptions.IgnoreCase | RegexOptions.Singleline));
 
myWebPermission1.Demand();

' Create a WebPermission.
Dim myWebPermission1 As New WebPermission()

' Allow Connect access to the specified URLs.
myWebPermission1.AddPermission(NetworkAccess.Connect, New Regex("http://www\.contoso\.com/.*", RegexOptions.Compiled Or RegexOptions.IgnoreCase Or RegexOptions.Singleline))

myWebPermission1.Demand()

Hinweise

Wenn Sie als angegeben None haben, verwenden SieAddPermission, um die Verwendung von uriRegex in der Zielklasse zuzulassenPermissionState. Geben Sie Accept als access Parameter an, um den vom uriRegex Parameter angegebenen URI der Liste der URI-Annahmezeichenfolgen hinzuzufügen, oder geben Sie Connect als Zugriffsparameter an, um den URI der Liste der URI-Verbindungszeichenfolgen hinzuzufügen.

Hinweis

Das Aufrufen AddPermission einer UnrestrictedWebPermission Instanz hat keine Auswirkung, da allen URIs berechtigungen erteilt werden.

Hinweis

Es wird empfohlen, die Erstellung mit den RegexOptions.IgnoreCaseFlags , RegexOptions.Compiledund RegexOptions.Singleline zu erstellenuriRegex.

Hinweis

Eine Kandidaten-URI-Zeichenfolge wird auf zwei Arten anhand der Liste der relevanten regulären Ausdrücke (AcceptList oder ConnectList) überprüft. Zunächst wird die Zeichenfolge des Kandidaten-URI anhand der entsprechenden Liste überprüft. Wenn dann keine Übereinstimmung vorhanden ist, wird die Zeichenfolge des Kandidaten-URI in eine Uri konvertiert und mit der entsprechenden Liste überprüft.

Weitere Informationen

• NetworkAccess