FileIOPermission 建構函式

參考

定義

命名空間:: System.Security.Permissions

組件:: System.Security.Permissions.dll

組件:

組件:: mscorlib.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 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 control, System::String ^ path);

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

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

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

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)

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

參數

access: FileIOPermissionAccess

FileIOPermissionAccess 列舉值的位元組合。

actionscontrol: 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 control, cli::array <System::String ^> ^ pathList);

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

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

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

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

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

參數

access: FileIOPermissionAccess

FileIOPermissionAccess 列舉值的位元組合。

actionscontrol: AccessControlActions

AccessControlActions 列舉值的位元組合。

pathList: String[]

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

例外狀況

ArgumentException

access 參數不是有效的 FileIOPermissionAccess 值。

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

備註

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

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

重要

(ACL) 的存取控制清單，會描述對指定的檔案和其屬性具有特定動作之許可權的個人或群組。變更或查看 ACL 的能力是一項重要的許可權，應謹慎授與。

適用於

FileIOPermission 建構函式

定義

多載

FileIOPermission(PermissionState)

參數

例外狀況

範例

備註

適用於

FileIOPermission(FileIOPermissionAccess, String)

參數

例外狀況

範例

備註

適用於

FileIOPermission(FileIOPermissionAccess, String[])

參數

例外狀況

備註

適用於

FileIOPermission(FileIOPermissionAccess, AccessControlActions, String)

參數

例外狀況

備註

適用於

FileIOPermission(FileIOPermissionAccess, AccessControlActions, String[])

參數

例外狀況

備註

適用於

其他資源