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.cs

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

C#

public WebPermission();

備註

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

另請參閱

• IsUnrestricted()

WebPermission(PermissionState)

來源:

WebPermission.cs

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

C#

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

參數

state

PermissionState

PermissionState 值。

範例

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

C#

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

備註

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

另請參閱

• Unrestricted

WebPermission(NetworkAccess, String)

來源:

WebPermission.cs

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

C#

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

參數

access

NetworkAccess

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

uriString

String

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

例外狀況

ArgumentNullException

uriString 為 null。

範例

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

C#

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

備註

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

另請參閱

• Regex

WebPermission(NetworkAccess, Regex)

來源:

WebPermission.cs

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

C#

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

參數

access

NetworkAccess

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

uriRegex

Regex

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

範例

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

C#

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

備註

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

備註

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

備註

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

另請參閱

• Regex