WebPermission.AddPermission Metoda

Definicja

Dodaje określony identyfikator URI z określonymi prawami dostępu do bieżącego WebPermission.Adds the specified URI with the specified access rights to the current WebPermission.

Przeciążenia

AddPermission(NetworkAccess, String)

Dodaje określony ciąg identyfikatora URI z określonymi prawami dostępu do bieżącego WebPermission.Adds the specified URI string with the specified access rights to the current WebPermission.

AddPermission(NetworkAccess, Regex)

Dodaje określony identyfikator URI z określonymi prawami dostępu do bieżącego WebPermission.Adds the specified URI with the specified access rights to the current WebPermission.

AddPermission(NetworkAccess, String)

Dodaje określony ciąg identyfikatora URI z określonymi prawami dostępu do bieżącego WebPermission.Adds the specified URI string with the specified access rights to the current WebPermission.

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)

Parametry

access
NetworkAccess

NetworkAccess, który określa prawa dostępu przyznane identyfikatorowi URI.A NetworkAccess that specifies the access rights that are granted to the URI.

uriString
String

Ciąg opisujący identyfikator URI, do którego przyznano prawa dostępu.A string that describes the URI to which access rights are granted.

Wyjątki

Parametr uriString ma wartość null.uriString is null.

Przykłady

Poniższy przykład pokazuje, jak dodać prawa dostępu do określonych ciągów adresów URL.The following example demonstrates how to add access rights to particular URL strings.

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

Uwagi

Jeśli określono None jako PermissionState, użyj AddPermission, aby zezwolić na użycie uriString w klasie docelowej.If you have specified None as the PermissionState, use AddPermission to permit the use of uriString in the target class. Sposób, w jaki uriString może być używany przez klasę docelową, jest określony przez access.The way that uriString can be used by the target class is specified by access. Określ Accept jako parametr dostępu, aby dodać identyfikator URI określony przez parametr uriString do listy akceptowanych ciągów identyfikatorów URI, lub określ Connect jako parametr dostępu, aby dodać identyfikator URI do listy ciągów połączenia identyfikatora URI.Specify Accept as the access parameter to add the URI specified by the uriString parameter to the list of URI accept strings, or specify Connect as the access parameter to add the URI to the list of URI connect strings.

Uwaga

Wywołanie AddPermission na UnrestrictedWebPermission nie będzie miało efektu, ponieważ uprawnienia są przyznawane wszystkim identyfikatorom URI.Calling AddPermission on UnrestrictedWebPermission will have no effect, because permission is granted to all URIs.

Uwaga

Ciąg identyfikatora URI kandydata jest sprawdzany względem listy odpowiednich wyrażeń regularnych (AcceptList lub ConnectList) na dwa sposoby.A candidate URI string is checked against the list of relevant regular expressions (AcceptList or ConnectList) in two ways. Po pierwsze, ciąg identyfikatora URI kandydata jest sprawdzany względem odpowiedniej listy; następnie, jeśli nie ma dopasowania, ciąg identyfikatora URI kandydata zostanie przekonwertowany na Uri i sprawdzony z odpowiednią listą.First, the candidate URI string is checked against the appropriate list; then, if there is no match, the candidate URI string is converted into a Uri and checked against the appropriate list.

Zobacz też

AddPermission(NetworkAccess, Regex)

Dodaje określony identyfikator URI z określonymi prawami dostępu do bieżącego WebPermission.Adds the specified URI with the specified access rights to the current WebPermission.

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)

Parametry

access
NetworkAccess

NetworkAccess, który określa prawa dostępu przyznane identyfikatorowi URI.A NetworkAccess that specifies the access rights that are granted to the URI.

uriRegex
Regex

Wyrażenie regularne, które opisuje zestaw identyfikatorów URI, do których przyznano prawa dostępu.A regular expression that describes the set of URIs to which access rights are granted.

Wyjątki

Parametr uriRegex ma wartość null.The uriRegex parameter is null.

Przykłady

Poniższy przykład używa AddPermission, aby nadać prawa dostępu dla określonego identyfikatora URI.The following example uses AddPermission to give access rights for the specified URI.

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

Uwagi

Jeśli określono None jako PermissionState, użyj AddPermission, aby zezwolić na użycie uriRegex w klasie docelowej.If you have specified None as the PermissionState, use AddPermission to allow the use of uriRegex in the target class. Określ Accept jako parametr access, aby dodać identyfikator URI określony przez parametr uriRegex do listy ciągów akceptowanych przez identyfikator URI lub określić Connect jako parametr dostępu, aby dodać identyfikator URI do listy ciągów połączenia identyfikatora URI.Specify Accept as the access parameter to add the URI specified by the uriRegex parameter to the list of URI accept strings, or specify Connect as the access parameter to add the URI to the list of URI connect strings.

Uwaga

Wywołanie AddPermission w wystąpieniu UnrestrictedWebPermission nie będzie miało żadnego efektu, ponieważ uprawnienie zostanie przyznane wszystkim identyfikatorom URI.Calling AddPermission on an UnrestrictedWebPermission instance will have no effect as permission is granted to all URIs.

Uwaga

Zaleca się utworzenie uriRegex przy użyciu flag RegexOptions.IgnoreCase, RegexOptions.Compiledi RegexOptions.Singleline.It is recommended that you create uriRegex using the RegexOptions.IgnoreCase, RegexOptions.Compiled, and RegexOptions.Singleline flags.

Uwaga

Ciąg identyfikatora URI kandydata jest sprawdzany względem listy odpowiednich wyrażeń regularnych (AcceptList lub ConnectList) na dwa sposoby.A candidate URI string is checked against the list of relevant regular expressions (AcceptList or ConnectList) in two ways. Po pierwsze, ciąg identyfikatora URI kandydata jest sprawdzany względem odpowiedniej listy; następnie, jeśli nie ma dopasowania, ciąg identyfikatora URI kandydata zostanie przekonwertowany na Uri i sprawdzony z odpowiednią listą.First, the candidate URI string is checked against the appropriate list; then, if there is no match, the candidate URI string is converted into a Uri and checked against the appropriate list.

Zobacz też

Dotyczy