UrlIdentityPermission 建構函式

定義

命名空間:

System.Security.Permissions

組件:

System.Security.Permissions.dll

套件:

System.Security.Permissions v9.0.0-preview.4.24266.19

初始化 UrlIdentityPermission 類別的新執行個體。

多載

UrlIdentityPermission(PermissionState)	使用指定的 UrlIdentityPermission 初始化 PermissionState 類別的新執行個體。
UrlIdentityPermission(String)	初始化 UrlIdentityPermission 類別的新執行個體，以表示 site 所描述的 URL 識別。

UrlIdentityPermission(PermissionState)

來源:

UrlIdentityPermission.cs

使用指定的 UrlIdentityPermission 初始化 PermissionState 類別的新執行個體。

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

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

new System.Security.Permissions.UrlIdentityPermission : System.Security.Permissions.PermissionState -> System.Security.Permissions.UrlIdentityPermission

Public Sub New (state As PermissionState)

參數

state

PermissionState

其中一個 PermissionState 值。

例外狀況

ArgumentException

state 參數不是有效的 PermissionState 值。

範例

下列範例顯示建構函式的使用 UrlIdentityPermission.UrlIdentityPermission(PermissionState) 方式。

UrlIdentityPermission ^ permIdPerm2 = gcnew UrlIdentityPermission(PermissionState::None);

UrlIdentityPermission permIdPerm2 = new UrlIdentityPermission(PermissionState.None);

Dim permIdPerm2 As New UrlIdentityPermission(PermissionState.None)

備註

建立完全受限 () None 或 Unrestricted 許可權。

注意

在 .NET Framework 1.0 和 1.1 版中，身分識別許可權不能有Unrestricted許可權狀態值。 從 .NET Framework 2.0 版開始，身分識別許可權可以具有任何許可權狀態值。 這表示在 2.0 和更新版本中，身分識別許可權的行為與實作 IUnrestrictedPermission 介面的許可權相同。 也就是說，如果元件已獲得完全信任，則不論元件的身分識別為何，身分識別的需求一律會成功。

在 .NET Framework 1.0 和 1.1 版中，即使呼叫元件完全信任，身分識別許可權的需求仍有效。 也就是說，雖然呼叫元件具有完全信任，但如果元件不符合要求的準則，則身分識別許可權的需求會失敗。 從 .NET Framework 2.0 版開始，如果呼叫元件具有完全信任，則身分識別許可權的要求無效。 這可確保所有許可權的一致性，避免將身分識別許可權視為特殊案例的處理。

UrlIdentityPermission(String)

來源:

UrlIdentityPermission.cs

初始化 UrlIdentityPermission 類別的新執行個體，以表示 site 所描述的 URL 識別。

public:
 UrlIdentityPermission(System::String ^ site);

public UrlIdentityPermission (string site);

new System.Security.Permissions.UrlIdentityPermission : string -> System.Security.Permissions.UrlIdentityPermission

Public Sub New (site As String)

參數

site

String

URL 或萬用字元運算式。

例外狀況

ArgumentNullException

site 參數為 null。

FormatException

site 參數的長度為零。

ArgumentException

site 參數的 URL、目錄或網站部分無效。

範例

下列範例顯示建構函式的使用 UrlIdentityPermission.UrlIdentityPermission(String) 方式。

UrlIdentityPermission ^ permIdPerm1 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/process/");

UrlIdentityPermission permIdPerm1 = new UrlIdentityPermission("http://www.fourthcoffee.com/process/");

Dim permIdPerm1 As New UrlIdentityPermission("http://www.fourthcoffee.com/process/")

備註

系統會考慮完整的 URL，包括通訊協定 (HTTP、HTTPS、FTP) 和檔案，例如： http://www.fourthcoffee.com/process/grind.htm/。

URL 可以完全比對，或透過最終位置的通配符進行比對，例如： http://www.fourthcoffee.com/process/*。 URL 也可以包含位於點分隔符的通配符 (“*”) 前置詞。 例如，URL 名稱字串http://www.fourthcoffee.com/process/grind.htm/是 和 http://*.com/process/grind.htm/的http://*.fourthcoffee.com/process/grind.htm/子集。

注意

從 .NET Framework 2.0 版開始，基於效能考慮，無效的 URL 不會在建立新的類別實例時造成自變數例外狀況。 執行 Union、Intersect 或 IsSubsetOf) 的其中一個集合 (作業時，就會發生自變數例外狀況。 安全性基礎結構呼叫許可權 IsSubsetOf 的需求。 需求會因為自變數例外狀況而失敗，導致 SecurityException 擲回 。 在此情況下，將不會看到原始 ArgumentException 例外狀況。