WebPermission 建構函式

定義

命名空間:

System.Net

組件:

System.Security.Permissions.dll

建立 WebPermission 類別的新執行個體。

多載

WebPermission()	建立 WebPermission 類別的新執行個體。
WebPermission(PermissionState)	初始化 WebPermission 類別的新執行個體，這個執行個體可決定是否通過所有要求。
WebPermission(NetworkAccess, String)	使用指定 URI 的指定存取權限，建立 WebPermission 類別的新執行個體。
WebPermission(NetworkAccess, Regex)	以指定 URI 規則運算式的指定存取權限，初始化 WebPermission 類別的新執行個體。

WebPermission()

建立 WebPermission 類別的新執行個體。

public:
 WebPermission();

public WebPermission ();

Public Sub New ()

備註

建立 WebPermission 類別的新執行個體。 此建構函式會建立不會授與任何許可權的空白許可權。

另請參閱

• IsUnrestricted()

WebPermission(PermissionState)

初始化 WebPermission 類別的新執行個體，這個執行個體可決定是否通過所有要求。

public:
 WebPermission(System::Security::Permissions::PermissionState state);

public WebPermission (System.Security.Permissions.PermissionState state);

new System.Net.WebPermission : System.Security.Permissions.PermissionState -> System.Net.WebPermission

Public Sub New (state As PermissionState)

參數

state

PermissionState

PermissionState 值。

範例

下列範例會建立的 WebPermission 實例，並提供特定URL的訪問許可權。

// Create a WebPermission instance.
WebPermission^ myWebPermission1 = gcnew WebPermission( PermissionState::None );

// Allow access to the first set of URL's.
myWebPermission1->AddPermission( NetworkAccess::Connect, "http://www.microsoft.com/default.htm" );
myWebPermission1->AddPermission( NetworkAccess::Connect, "http://www.msn.com" );

// Check whether all callers higher in the call stack have been granted the permissionor not.
myWebPermission1->Demand();

// Create a WebPermission instance.  
WebPermission myWebPermission1 = new WebPermission(PermissionState.None);

// Allow access to the first set of URL's.
myWebPermission1.AddPermission(NetworkAccess.Connect,"http://www.microsoft.com/default.htm");
myWebPermission1.AddPermission(NetworkAccess.Connect,"http://www.msn.com");

// Check whether all callers higher in the call stack have been granted the permissionor not.
myWebPermission1.Demand();

' Create a WebPermission instance.  
Dim myWebPermission1 As New WebPermission(PermissionState.None)

' Allow access to the first set of URL's.
myWebPermission1.AddPermission(NetworkAccess.Connect, "http://www.microsoft.com/default.htm")
myWebPermission1.AddPermission(NetworkAccess.Connect, "http://www.msn.com")

' Check whether all callers higher in the call stack have been granted the permissionor not.
myWebPermission1.Demand()

備註

參數的值 state 分別是 PermissionState.None 或 PermissionState.Unrestricted，分別產生完全受限或完全不受限制的所有安全性變數存取。 如果您指定 PermissionState.None，則可以使用 來授與個別 URI 的 AddPermission存取權。

另請參閱

• Unrestricted

WebPermission(NetworkAccess, String)

使用指定 URI 的指定存取權限，建立 WebPermission 類別的新執行個體。

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

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

new System.Net.WebPermission : System.Net.NetworkAccess * string -> System.Net.WebPermission

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

參數

access

NetworkAccess

NetworkAccess 值，表示對指定的 URI 所授與的存取權限類型。 Accept，表示允許應用程式接受從網際網路至本機資源的連接。 Connect指示允許將應用程式連接到特定的網際網路資源。

uriString

String

要授與存取權限的 URI 字串。

例外狀況

ArgumentNullException

uriString 為 null。

範例

下列範例會為指定的 URI 建立具有連接許可權的新 實例 WebPermission 。

// Create a WebPermission::instance.
WebPermission^ myWebPermission1 = gcnew WebPermission( NetworkAccess::Connect,"http://www.contoso.com/default.htm" );
myWebPermission1->Demand();

// Create a WebPermission.instance.
WebPermission myWebPermission1 = new WebPermission(NetworkAccess.Connect,"http://www.contoso.com/default.htm");
myWebPermission1.Demand();

' Create a WebPermission.instance.
Dim myWebPermission1 As New WebPermission(NetworkAccess.Connect, "http://www.contoso.com/default.htm")
myWebPermission1.Demand()

備註

此建構函式會初始化 ， WebPermission 並授與其目標許可權，以建立遠端主機連線，或使用 參數所述的 uriString URI 接受遠端主機連線。

另請參閱

• Regex

WebPermission(NetworkAccess, Regex)

以指定 URI 規則運算式的指定存取權限，初始化 WebPermission 類別的新執行個體。

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

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

new System.Net.WebPermission : System.Net.NetworkAccess * System.Text.RegularExpressions.Regex -> System.Net.WebPermission

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

參數

access

NetworkAccess

NetworkAccess 值，表示對指定的 URI 所授與的存取權限類型。 Accept，表示允許應用程式接受從網際網路至本機資源的連接。 Connect指示允許將應用程式連接到特定的網際網路資源。

uriRegex

Regex

規則運算式，說明要授與存取權限的 URI。

範例

下列範例會為指定的 System.Text.RegularExpressions.Regex建立具有連接許可權的新 實例WebPermission。

// Create an instance of 'Regex' that accepts all URL's containing the host
// fragment 'www.contoso.com'.
Regex^ myRegex = gcnew Regex( "http://www.contoso.com/.*" );

// Create a WebPermission that gives the permissions to all the hosts containing
// the same fragment.
WebPermission^ myWebPermission = gcnew WebPermission( NetworkAccess::Connect,myRegex );

// Checks all callers higher in the call stack have been granted the permission.
myWebPermission->Demand();

 // Create an instance of 'Regex' that accepts all  URL's containing the host 
 // fragment 'www.contoso.com'.
 Regex myRegex = new Regex(@"http://www\.contoso\.com/.*");

// Create a WebPermission that gives the permissions to all the hosts containing 
// the same fragment.
WebPermission myWebPermission = new WebPermission(NetworkAccess.Connect,myRegex);
   
// Checks all callers higher in the call stack have been granted the permission.
myWebPermission.Demand();

'  Creates an instance of 'Regex' that accepts all  URL's containing the host fragment 'www.contoso.com'.
Dim myRegex As New Regex("http://www\.contoso\.com/.*")
  
   ' Creates a 'WebPermission' that gives the permissions to all the hosts containing same host fragment.
   Dim myWebPermission As New WebPermission(NetworkAccess.Connect, myRegex)
   
  '  Checks all callers higher in the call stack have been granted the permission.
  myWebPermission.Demand()

備註

此建構函式會初始化 ， WebPermission 並授與其目標許可權，以建立遠端主機連線，或使用 參數所述的 uriRegex URI 接受遠端主機連線。

注意

建議您使用RegexOptions.IgnoreCase、 RegexOptions.Compiled與 RegexOptions.Singleline 旗標來建立 uriRegex 。

注意

系統會以兩種方式檢查候選 URI 字串，以 (或 ConnectList) 相關的正則表示式AcceptList清單。 首先，系統會根據適當的清單檢查候選 URI 字串;然後，如果沒有相符專案，候選 URI 字串會轉換成 ， Uri 並針對適當的清單進行檢查。

另請參閱

• Regex