FileSecurity 생성자

정의

네임스페이스:

System.Security.AccessControl

어셈블리:

System.IO.FileSystem.AccessControl.dll

패키지:

System.IO.FileSystem.AccessControl v5.0.0

FileSecurity 클래스의 새 인스턴스를 초기화합니다.

오버로드

FileSecurity()	FileSecurity 클래스의 새 인스턴스를 초기화합니다.
FileSecurity(String, AccessControlSections)	FileSecurity 열거형의 지정된 값을 사용하여 지정된 파일에서 AccessControlSections 클래스의 새 인스턴스를 초기화합니다.

FileSecurity()

FileSecurity 클래스의 새 인스턴스를 초기화합니다.

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

예외

PlatformNotSupportedException

현재 운영 체제가 Microsoft Windows 2000 이상이 아닌 경우

설명

기존 파일을 기반으로 하지 않는 빈 FileSecurity 개체를 만들려는 경우 이 생성자를 사용합니다. 그런 다음 액세스 제어 정보로 개체를 채우고 파일에 적용할 수 있습니다.

메서드를 사용하여 AddAccessRule 개체에 FileSecurity 액세스 또는 감사 규칙을 추가할 수 있습니다. 메서드를 사용하여 RemoveAccessRule 액세스 또는 감사 규칙을 제거할 수 있습니다.

파일에 대한 새 액세스 또는 변경된 액세스 또는 감사 규칙을 유지하려면 또는 SetAccessControl 메서드를 SetAccessControl 사용합니다. 기존 파일에서 액세스 또는 감사 규칙을 검색하려면 또는 GetAccessControl 메서드를 GetAccessControl 사용합니다.

FileSecurity(String, AccessControlSections)

FileSecurity 열거형의 지정된 값을 사용하여 지정된 파일에서 AccessControlSections 클래스의 새 인스턴스를 초기화합니다.

public:
 FileSecurity(System::String ^ fileName, System::Security::AccessControl::AccessControlSections includeSections);

public FileSecurity (string fileName, System.Security.AccessControl.AccessControlSections includeSections);

new System.Security.AccessControl.FileSecurity : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Sub New (fileName As String, includeSections As AccessControlSections)

매개 변수

fileName

String

FileSecurity 개체를 만드는 데 사용할 파일의 위치입니다.

includeSections

AccessControlSections

검색할 ACL(액세스 제어 목록) 정보의 형식을 지정하는 AccessControlSections 값 중 하나입니다.

예외

ArgumentException

fileName 매개 변수가 길이가 빈 문자열이거나 공백만 포함하거나 InvalidPathChars로 정의된 하나 이상의 잘못된 문자를 포함합니다.

DirectoryNotFoundException

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).

FileNotFoundException

fileName 매개 변수에 지정한 파일을 찾을 수 없는 경우

IOException

파일을 여는 동안 I/O 오류가 발생했습니다.

NotSupportedException

path의 형식이 잘못되었습니다.

SEHException

fileName 매개 변수가 null인 경우

PlatformNotSupportedException

현재 운영 체제가 Microsoft Windows 2000 이상이 아닌 경우

PathTooLongException

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.

PrivilegeNotHeldException

현재 시스템 계정에 관리 권한이 없는 경우

SystemException

파일을 찾을 수 없습니다.

UnauthorizedAccessException

fileName 매개 변수가 읽기 전용 파일을 지정합니다.

또는

현재 플랫폼이 해당 작업을 지원하지 않는 경우

또는

fileName 매개 변수가 디렉터리를 지정합니다.

또는

호출자에게 필요한 권한이 없는 경우

설명

이 생성자는 지정된 파일에 대한 액세스 제어 정보를 검색한 다음 해당 정보를 캡슐화하는 개체를 만듭니다 FileSecurity . 그런 다음 지정된 파일에 대한 액세스 제어 정보를 검사, 추가 또는 삭제할 수 있습니다.

메서드를 사용하여 AddAccessRule 개체에 FileSecurity 액세스 또는 감사 규칙을 추가할 수 있습니다. 메서드를 사용하여 RemoveAccessRule 액세스 또는 감사 규칙을 제거할 수 있습니다.

파일에 대한 새 액세스 또는 변경된 액세스 또는 감사 규칙을 유지하려면 또는 SetAccessControl 메서드를 SetAccessControl 사용합니다. 기존 파일에서 액세스 또는 감사 규칙을 검색하려면 또는 GetAccessControl 메서드를 GetAccessControl 사용합니다.

호출자 참고

FileSecurity(String, AccessControlSections) 생성자에는 현재 계정에 관리 권한이 있어야 합니다. 관리 권한이 없는 계정을 사용하여 특정 파일에 대한 클래스의 FileSecurity 새 instance 만들려면 메서드를 GetAccessControl() 사용합니다.