WebPermission.AddPermission Método

Definição

Adiciona o URI especificado com os direitos de acesso especificados para o WebPermission atual.Adds the specified URI with the specified access rights to the current WebPermission.

Sobrecargas

AddPermission(NetworkAccess, String)

Adiciona a cadeia de caracteres do URI com os direitos de acesso especificados para o WebPermission atual.Adds the specified URI string with the specified access rights to the current WebPermission.

AddPermission(NetworkAccess, Regex)

Adiciona o URI especificado com os direitos de acesso especificados para o WebPermission atual.Adds the specified URI with the specified access rights to the current WebPermission.

AddPermission(NetworkAccess, String)

Adiciona a cadeia de caracteres do URI com os direitos de acesso especificados para o WebPermission atual.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)

Parâmetros

access
NetworkAccess

Um NetworkAccess que especifica os direitos de acesso que são concedidos ao URI.A NetworkAccess that specifies the access rights that are granted to the URI.

uriString
String

Uma cadeia de caracteres que descreve o URI para o qual os direitos de acesso serão concedidos.A string that describes the URI to which access rights are granted.

Exceções

uriString é null.uriString is null.

Exemplos

O exemplo a seguir demonstra como adicionar direitos de acesso a cadeias de caracteres de URL específicas.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()

Comentários

Se você tiver especificado None como o PermissionState, use AddPermission para permitir o uso de uriString na classe de destino.If you have specified None as the PermissionState, use AddPermission to permit the use of uriString in the target class. A maneira como uriString pode ser usada pela classe de destino é especificada por access.The way that uriString can be used by the target class is specified by access. Especifique Accept como o parâmetro de acesso para adicionar o URI especificado pelo parâmetro uriString à lista de cadeias de caracteres de aceitação de URI ou especifique Connect como o parâmetro de acesso para adicionar o URI à lista de cadeias de conexão de 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.

Observação

Chamar AddPermission em UnrestrictedWebPermission não terá efeito, pois a permissão é concedida a todos os URIs.Calling AddPermission on UnrestrictedWebPermission will have no effect, because permission is granted to all URIs.

Observação

Uma cadeia de caracteres de URI candidata é verificada em relação à lista de expressões regulares relevantes (AcceptList ou ConnectList) de duas maneiras.A candidate URI string is checked against the list of relevant regular expressions (AcceptList or ConnectList) in two ways. Primeiro, a cadeia de caracteres do URI candidato é verificada na lista apropriada; em seguida, se não houver correspondência, a cadeia de caracteres do URI candidato será convertida em um Uri e marcada na lista apropriada.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.

Veja também

AddPermission(NetworkAccess, Regex)

Adiciona o URI especificado com os direitos de acesso especificados para o WebPermission atual.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)

Parâmetros

access
NetworkAccess

Um NetworkAccess que especifica os direitos de acesso que são concedidos para o URI.A NetworkAccess that specifies the access rights that are granted to the URI.

uriRegex
Regex

Uma expressão regular que descreve o conjunto de URIs para o qual os direitos de acesso são concedidos.A regular expression that describes the set of URIs to which access rights are granted.

Exceções

O parâmetro uriRegex é null.The uriRegex parameter is null.

Exemplos

O exemplo a seguir usa AddPermission para conceder direitos de acesso para o URI especificado.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()

Comentários

Se você tiver especificado None como o PermissionState, use AddPermission para permitir o uso de uriRegex na classe de destino.If you have specified None as the PermissionState, use AddPermission to allow the use of uriRegex in the target class. Especifique Accept como o parâmetro access para adicionar o URI especificado pelo parâmetro uriRegex à lista de cadeias de caracteres de aceitação de URI ou especifique Connect como o parâmetro de acesso para adicionar o URI à lista de cadeias de conexão de 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.

Observação

A chamada de AddPermission em uma instância de WebPermission de Unrestrictednão terá efeito, pois a permissão é concedida a todos os URIs.Calling AddPermission on an UnrestrictedWebPermission instance will have no effect as permission is granted to all URIs.

Observação

É recomendável que você crie uriRegex usando os sinalizadores RegexOptions.IgnoreCase, RegexOptions.Compilede RegexOptions.Singleline.It is recommended that you create uriRegex using the RegexOptions.IgnoreCase, RegexOptions.Compiled, and RegexOptions.Singleline flags.

Observação

Uma cadeia de caracteres de URI candidata é verificada em relação à lista de expressões regulares relevantes (AcceptList ou ConnectList) de duas maneiras.A candidate URI string is checked against the list of relevant regular expressions (AcceptList or ConnectList) in two ways. Primeiro, a cadeia de caracteres do URI candidato é verificada na lista apropriada; em seguida, se não houver correspondência, a cadeia de caracteres do URI candidato será convertida em um Uri e marcada na lista apropriada.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.

Veja também

Aplica-se a