FileIOPermission 建構函式

定義

命名空間:

System.Security.Permissions

組件:

System.Security.Permissions.dll

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

多載

FileIOPermission(PermissionState)	依照指定使用完全限制或無限制的權限，初始化 FileIOPermission 類別的新執行個體。
FileIOPermission(FileIOPermissionAccess, String)	初始化具有指定檔案或目錄之指定存取權的 FileIOPermission 類別的新執行個體。
FileIOPermission(FileIOPermissionAccess, String[])	初始化具有指定檔案及目錄之指定存取權的 FileIOPermission 類別的新執行個體。
FileIOPermission(FileIOPermissionAccess, AccessControlActions, String)	以針對指定檔案或目錄的指定存取權限和檔案控制資訊的指定存取權限，初始化 FileIOPermission 類別的新執行個體。
FileIOPermission(FileIOPermissionAccess, AccessControlActions, String[])	以針對指定檔案和目錄的指定存取權限和檔案控制資訊的指定存取權限，初始化 FileIOPermission 類別的新執行個體。

FileIOPermission(PermissionState)

依照指定使用完全限制或無限制的權限，初始化 FileIOPermission 類別的新執行個體。

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

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

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

Public Sub New (state As PermissionState)

參數

state

PermissionState

其中一個 PermissionState 列舉值。

例外狀況

ArgumentException

state 參數不是有效的 PermissionState 值。

範例

下列程式代碼範例會建立具有完全限制讀取許可權之 FileIOPermission 類別的新實例。

FileIOPermission^ f = gcnew FileIOPermission( PermissionState::None );
f->AllLocalFiles = FileIOPermissionAccess::Read;
try
{
    f->Demand();
}
catch (SecurityException^ s)
{
    Console::WriteLine(s->Message);
}

FileIOPermission f = new FileIOPermission(PermissionState.None);
f.AllLocalFiles = FileIOPermissionAccess.Read;
try
{
    f.Demand();
}
catch (SecurityException s)
{
    Console.WriteLine(s.Message);
}

Dim f As New FileIOPermission(PermissionState.None)
f.AllLocalFiles = FileIOPermissionAccess.Read
Try
    f.Demand()
Catch s As SecurityException
    Console.WriteLine(s.Message)
End Try

備註

建立完全受限 () None 或 Unrestricted 存取檔案和目錄。

FileIOPermission(FileIOPermissionAccess, String)

初始化具有指定檔案或目錄之指定存取權的 FileIOPermission 類別的新執行個體。

public:
 FileIOPermission(System::Security::Permissions::FileIOPermissionAccess access, System::String ^ path);

public FileIOPermission (System.Security.Permissions.FileIOPermissionAccess access, string path);

new System.Security.Permissions.FileIOPermission : System.Security.Permissions.FileIOPermissionAccess * string -> System.Security.Permissions.FileIOPermission

Public Sub New (access As FileIOPermissionAccess, path As String)

參數

access

FileIOPermissionAccess

FileIOPermissionAccess 列舉值的位元組合。

path

String

檔案或目錄的絕對路徑。

例外狀況

ArgumentException

access 參數不是有效的 FileIOPermissionAccess 值。

-或-

path 參數不是有效的字串。

-或-

path 參數未指定檔案或目錄的絕對路徑。

範例

下列程式代碼範例示範如何使用 FileIOPermission.FileIOPermission(FileIOPermissionAccess, String) 建構函式來建立 類別的新實例 FileIOPermission ，以提供 C：\test_r 檔案的完整存取權。

FileIOPermission^ f2 = gcnew FileIOPermission( FileIOPermissionAccess::Read,"C:\\test_r" );
f2->AddPathList( (FileIOPermissionAccess) (FileIOPermissionAccess::Write | FileIOPermissionAccess::Read), "C:\\example\\out.txt" );
try
{
    f2->Demand();
}
catch (SecurityException^ s)
{
    Console::WriteLine(s->Message);
}

FileIOPermission f2 = new FileIOPermission(FileIOPermissionAccess.Read, "C:\\test_r");
f2.AddPathList(FileIOPermissionAccess.Write | FileIOPermissionAccess.Read, "C:\\example\\out.txt");
try
{
    f2.Demand();
}
catch (SecurityException s)
{
    Console.WriteLine(s.Message);
}

Dim f2 As New FileIOPermission(FileIOPermissionAccess.Read, "C:\test_r")
f2.AddPathList(FileIOPermissionAccess.Write Or FileIOPermissionAccess.Read, "C:\example\out.txt")
Try
    f2.Demand()
Catch s As SecurityException
    Console.WriteLine(s.Message)
End Try

備註

這個建構函式只允許為指定的檔案或目錄指定其中一個 FileIOPermissionAccess 值。 AddPathList使用方法來定義複雜許可權。

FileIOPermission(FileIOPermissionAccess, String[])

初始化具有指定檔案及目錄之指定存取權的 FileIOPermission 類別的新執行個體。

public:
 FileIOPermission(System::Security::Permissions::FileIOPermissionAccess access, cli::array <System::String ^> ^ pathList);

public FileIOPermission (System.Security.Permissions.FileIOPermissionAccess access, string[] pathList);

new System.Security.Permissions.FileIOPermission : System.Security.Permissions.FileIOPermissionAccess * string[] -> System.Security.Permissions.FileIOPermission

Public Sub New (access As FileIOPermissionAccess, pathList As String())

參數

access

FileIOPermissionAccess

FileIOPermissionAccess 列舉值的位元組合。

pathList

String[]

包含檔案和目錄之絕對路徑的陣列。

例外狀況

ArgumentException

access 參數不是有效的 FileIOPermissionAccess 值。

-或-

pathList 陣列中的項目不是有效的字串。

備註

這個建構函式只允許為指定的檔案和目錄指定一個 FileIOPermissionAccess 值。 AddPathList使用方法來定義複雜許可權。

FileIOPermission(FileIOPermissionAccess, AccessControlActions, String)

以針對指定檔案或目錄的指定存取權限和檔案控制資訊的指定存取權限，初始化 FileIOPermission 類別的新執行個體。

public:
 FileIOPermission(System::Security::Permissions::FileIOPermissionAccess access, System::Security::AccessControl::AccessControlActions actions, System::String ^ path);

public FileIOPermission (System.Security.Permissions.FileIOPermissionAccess access, System.Security.AccessControl.AccessControlActions actions, string path);

new System.Security.Permissions.FileIOPermission : System.Security.Permissions.FileIOPermissionAccess * System.Security.AccessControl.AccessControlActions * string -> System.Security.Permissions.FileIOPermission

Public Sub New (access As FileIOPermissionAccess, actions As AccessControlActions, path As String)

參數

access

FileIOPermissionAccess

FileIOPermissionAccess 列舉值的位元組合。

actions

AccessControlActions

AccessControlActions 列舉值的位元組合。

path

String

檔案或目錄的絕對路徑。

例外狀況

ArgumentException

access 參數不是有效的 FileIOPermissionAccess 值。

-或-

path 參數不是有效的字串。

-或-

path 參數未指定檔案或目錄的絕對路徑。

備註

這個建構函式只允許為指定的檔案或目錄指定一個 FileIOPermissionAccess 值。 AddPathList使用方法來定義複雜許可權。

參數 control 會指定是否可以變更、檢視或無法存取 所 path 指定檔案或目錄的訪問控制清單 (ACL) 。

重要

訪問控制清單 (ACL) 描述具有或沒有指定檔案及其屬性上特定動作之個人或群組的許可權。 變更或檢視 ACL 的能力是重要的許可權，應謹慎授與。

FileIOPermission(FileIOPermissionAccess, AccessControlActions, String[])

以針對指定檔案和目錄的指定存取權限和檔案控制資訊的指定存取權限，初始化 FileIOPermission 類別的新執行個體。

public:
 FileIOPermission(System::Security::Permissions::FileIOPermissionAccess access, System::Security::AccessControl::AccessControlActions actions, cli::array <System::String ^> ^ pathList);

public FileIOPermission (System.Security.Permissions.FileIOPermissionAccess access, System.Security.AccessControl.AccessControlActions actions, string[] pathList);

new System.Security.Permissions.FileIOPermission : System.Security.Permissions.FileIOPermissionAccess * System.Security.AccessControl.AccessControlActions * string[] -> System.Security.Permissions.FileIOPermission

Public Sub New (access As FileIOPermissionAccess, actions As AccessControlActions, pathList As String())

參數

access

FileIOPermissionAccess

FileIOPermissionAccess 列舉值的位元組合。

actions

AccessControlActions

AccessControlActions 列舉值的位元組合。

pathList

String[]

包含檔案和目錄之絕對路徑的陣列。

例外狀況

ArgumentException

access 參數不是有效的 FileIOPermissionAccess 值。

-或-

pathList 陣列中的項目不是有效的字串。

備註

這個建構函式只允許為指定的檔案和目錄指定一個 FileIOPermissionAccess 值。 AddPathList使用方法來定義複雜許可權。

參數 control 會指定是否可以變更、檢視或無法存取 所 path 指定檔案或目錄的訪問控制清單 (ACL) 。

重要

訪問控制清單 (ACL) 描述具有或沒有指定檔案及其屬性上特定動作之個人或群組的許可權。 變更或檢視 ACL 的能力是重要的許可權，應謹慎授與。