Share via


LogStore 생성자

정의

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

오버로드

LogStore(SafeFileHandle)

지정된 핸들에 대한 LogStore 클래스의 새 인스턴스를 초기화합니다.

LogStore(String, FileMode)

지정된 경로 및 모드를 사용하여 LogStore 클래스의 새 인스턴스를 초기화합니다.

LogStore(String, FileMode, FileAccess)

지정된 경로, 모드 및 액세스 권한을 사용하여 LogStore 클래스의 새 인스턴스를 초기화합니다.

LogStore(String, FileMode, FileAccess, FileShare)

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

LogStore(String, FileMode, FileAccess, FileShare, FileSecurity)

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

LogStore(SafeFileHandle)

지정된 핸들에 대한 LogStore 클래스의 새 인스턴스를 초기화합니다.

public:
 LogStore(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle);
public LogStore (Microsoft.Win32.SafeHandles.SafeFileHandle handle);
new System.IO.Log.LogStore : Microsoft.Win32.SafeHandles.SafeFileHandle -> System.IO.Log.LogStore
Public Sub New (handle As SafeFileHandle)

매개 변수

handle
SafeFileHandle

현재 LogStore 개체가 캡슐화하는 로그 파일에 대한 파일 핸들입니다.

예외

handle이(가) null인 경우

로그 핸들을 스레드 풀에 바인딩할 수 없는 경우

지정된 로그 저장소에 대한 액세스가 운영 체제에서 거부된 경우

시퀀스가 삭제된 후 메서드가 호출된 경우

메모리가 부족하여 프로그램을 계속 실행할 수 없는 경우

적용 대상

LogStore(String, FileMode)

지정된 경로 및 모드를 사용하여 LogStore 클래스의 새 인스턴스를 초기화합니다.

public:
 LogStore(System::String ^ path, System::IO::FileMode mode);
public LogStore (string path, System.IO.FileMode mode);
new System.IO.Log.LogStore : string * System.IO.FileMode -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode)

매개 변수

path
String

열려는 로그 저장소의 기본 파일에 대한 상대 또는 절대 경로입니다.

mode
FileMode

저장소를 열거나 만드는 방법을 결정하는 FileMode 값 중 하나입니다.

예외

path이(가) null인 경우

path가 빈 문자열("")인 경우

또는

path에 공백만 포함된 경우

또는

path에 하나 이상의 잘못된 문자가 포함된 경우

mode에 잘못된 값이 포함된 경우

파일을 찾을 수 없는 경우

로그 저장소를 열 때 I/O 오류가 발생한 경우

지정된 로그 저장소에 대한 액세스가 운영 체제에서 거부된 경우

필요한 CLFS(Common Log File System) 구성 요소가 설치되어 있지 않기 때문에 LogStore를 사용할 수 없는 경우. 사용자 플랫폼에 CLFS 구성 요소를 사용할 수 있으면 설치하거나 FileRecordSequence 클래스를 대신 사용합니다.

메모리가 부족하여 프로그램을 계속 실행할 수 없는 경우

설명

이 생성자를 사용하여 지정된 경로와 모드로 로그 저장소를 엽니다. 저장소는 읽기/쓰기 권한으로 열리고 읽기 권한을 공유합니다.

path 매개 변수는 다음 구문을 사용해야 합니다.

log:<physical log name>[::<log client name>]

여기서 <physical log name>은 로그 파일의 유효한 경로이고 <log client name>은 고유한 클라이언트 식별자입니다. 로그 저장소는 실제 로그 저장소나 가상 로그 저장소 중 하나여야 합니다. 로그 저장소를 실제로 만들거나 가상으로 만들면 로그 저장소의 수명이 끝날 때까지 만든 상태로 유지됩니다. 실제 로그 저장소는 실제 로그 이름만 지정하여 만들어지고, 가상 로그 저장소는 실제 로그 이름과 로그 클라이언트 이름을 모두 지정하여 만들어집니다.

동일한 실제 로그 이름을 공유하는 클라이언트는 동일한 범위 컬렉션과 정책을 공유합니다.

적용 대상

LogStore(String, FileMode, FileAccess)

지정된 경로, 모드 및 액세스 권한을 사용하여 LogStore 클래스의 새 인스턴스를 초기화합니다.

public:
 LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);
public LogStore (string path, System.IO.FileMode mode, System.IO.FileAccess access);
new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode, access As FileAccess)

매개 변수

path
String

열려는 로그 저장소의 기본 파일에 대한 상대 또는 절대 경로입니다.

mode
FileMode

저장소를 열거나 만드는 방법을 결정하는 FileMode 값 중 하나입니다.

access
FileAccess

FileAccess에서 파일에 액세스할 수 있는 방법을 결정하는 LogStore 값 중 하나입니다.

예외

path이(가) null인 경우

path가 빈 문자열("")인 경우

또는

path에 공백만 포함된 경우

또는

path에 하나 이상의 잘못된 문자가 포함된 경우

mode에 잘못된 값이 포함된 경우

-또는-

access에 잘못된 값이 포함된 경우

파일을 찾을 수 없는 경우

로그 저장소를 열 때 I/O 오류가 발생한 경우

지정된 로그 저장소에 대한 액세스가 운영 체제에서 거부된 경우

필요한 CLFS(Common Log File System) 구성 요소가 설치되어 있지 않기 때문에 LogStore를 사용할 수 없는 경우. 사용자 플랫폼에 CLFS 구성 요소를 사용할 수 있으면 설치하거나 FileRecordSequence 클래스를 대신 사용합니다.

메모리가 부족하여 프로그램을 계속 실행할 수 없는 경우

설명

이 생성자를 사용하여 지정된 경로, 모드 및 액세스 권한으로 새 로그 저장소를 엽니다. 저장소는 읽기 권한을 공유하여 열립니다.

path 매개 변수는 다음 구문을 사용해야 합니다.

log:<physical log name>[::<log client name>]

여기서 <physical log name>은 로그 파일의 유효한 경로이고 <log client name>은 고유한 클라이언트 식별자입니다. 로그 저장소는 실제 로그 저장소나 가상 로그 저장소 중 하나여야 합니다. 로그 저장소를 실제로 만들거나 가상으로 만들면 로그 저장소의 수명이 끝날 때까지 만든 상태로 유지됩니다. 실제 로그 저장소는 실제 로그 이름만 지정하여 만들어지고, 가상 로그 저장소는 실제 로그 이름과 로그 클라이언트 이름을 모두 지정하여 만들어집니다.

동일한 실제 로그 이름을 공유하는 클라이언트는 동일한 범위 컬렉션과 정책을 공유합니다.

적용 대상

LogStore(String, FileMode, FileAccess, FileShare)

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

public:
 LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);
public LogStore (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);
new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)

매개 변수

path
String

열려는 로그 저장소의 기본 파일에 대한 상대 또는 절대 경로입니다.

mode
FileMode

저장소를 열거나 만드는 방법을 결정하는 FileMode 값 중 하나입니다.

access
FileAccess

FileAccess에서 파일에 액세스할 수 있는 방법을 결정하는 LogStore 값 중 하나입니다.

share
FileShare

로그 저장소가 프로세스 간에 공유되는 방법을 결정하는 FileShare 값 중 하나입니다.

예외

path이(가) null인 경우

path가 빈 문자열("")인 경우

또는

path에 공백만 포함된 경우

또는

path에 하나 이상의 잘못된 문자가 포함된 경우

mode에 잘못된 값이 포함된 경우

-또는-

access에 잘못된 값이 포함된 경우

또는

share에 잘못된 값이 포함된 경우

파일을 찾을 수 없는 경우

로그 저장소를 열 때 I/O 오류가 발생한 경우

지정된 로그 저장소에 대한 액세스가 운영 체제에서 거부된 경우

필요한 CLFS(Common Log File System) 구성 요소가 설치되어 있지 않기 때문에 LogStore를 사용할 수 없는 경우. 사용자 플랫폼에 CLFS 구성 요소를 사용할 수 있으면 설치하거나 FileRecordSequence 클래스를 대신 사용합니다.

메모리가 부족하여 프로그램을 계속 실행할 수 없는 경우

설명

이 생성자는 지정된 경로, 모드 및 액세스 권한을 사용하여 여는 새 LogStore 개체를 초기화합니다. 저장소는 지정된 액세스 권한을 공유하여 열립니다.

path 매개 변수는 다음 구문을 사용해야 합니다.

log:<physical log name>[::<log client name>]

여기서 <physical log name>은 로그 파일의 유효한 경로이고 <log client name>은 고유한 클라이언트 식별자입니다. 로그 저장소는 실제 로그 저장소나 가상 로그 저장소 중 하나여야 합니다. 로그 저장소를 실제로 만들거나 가상으로 만들면 로그 저장소의 수명이 끝날 때까지 만든 상태로 유지됩니다. 실제 로그 저장소는 실제 로그 이름만 지정하여 만들어지고, 가상 로그 저장소는 실제 로그 이름과 로그 클라이언트 이름을 모두 지정하여 만들어집니다.

동일한 실제 로그 이름을 공유하는 클라이언트는 동일한 범위 컬렉션과 정책을 공유합니다.

적용 대상

LogStore(String, FileMode, FileAccess, FileShare, FileSecurity)

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

public:
 LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public LogStore (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, System.Security.AccessControl.FileSecurity fileSecurity);
new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * System.Security.AccessControl.FileSecurity -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, fileSecurity As FileSecurity)

매개 변수

path
String

열려는 로그 저장소의 기본 파일에 대한 상대 또는 절대 경로입니다.

mode
FileMode

저장소를 열거나 만드는 방법을 결정하는 FileMode 값 중 하나입니다.

access
FileAccess

FileAccess에서 파일에 액세스할 수 있는 방법을 결정하는 LogStore 값 중 하나입니다.

share
FileShare

로그 저장소가 프로세스 간에 공유되는 방법을 결정하는 FileShare 값 중 하나입니다.

fileSecurity
FileSecurity

저장소를 만들어야 하는 경우 새로 만든 저장소에서 설정할 보안을 지정하는 FileSecurity 값 중 하나입니다.

예외

path이(가) null인 경우

path로 지정된 로그 저장소 파일 이름이 잘못된 경우

또는

Mode가 쓰기 권한 없이 사용할 수 없는 CreateNew인 경우

또는

Mode가 쓰기 권한 없이 사용할 수 없는 OpenOrCreate인 경우

mode에 잘못된 값이 포함된 경우

-또는-

access에 잘못된 값이 포함된 경우

또는

share에 잘못된 값이 포함된 경우

파일을 찾을 수 없는 경우

로그 저장소를 열 때 I/O 오류가 발생한 경우

path로 지정된 파일을 다른 프로세스에서 사용 중이기 때문에 액세스할 수 없는 경우

또는

path로 지정된 파일이나 디렉터리가 이미 있기 때문에 해당 파일을 만들 수 없는 경우

또는

로그 핸들을 스레드 풀에 바인딩할 수 없는 경우

또는

지정된 로그 파일 형식이나 버전이 잘못된 경우

필요한 CLFS(Common Log File System) 구성 요소가 설치되어 있지 않기 때문에 LogStore를 사용할 수 없는 경우. 사용자 플랫폼에 CLFS 구성 요소를 사용할 수 있으면 설치하거나 FileRecordSequence 클래스를 대신 사용합니다.

시퀀스가 삭제된 후 메서드가 호출된 경우

메모리가 부족하여 프로그램을 계속 실행할 수 없는 경우

레코드 시퀀스가 꽉 찼습니다.

지정된 로그 저장소에 대한 액세스가 운영 체제에서 거부된 경우

설명

이 생성자는 지정된 경로, 모드 및 액세스 권한을 사용하여 여는 새 LogStore 개체를 초기화합니다. 저장소는 지정된 액세스 권한을 공유하여 열립니다. path 매개 변수는 다음 구문을 따라야 합니다.

log:<physical log name>[::<log client name>]

여기서 <physical log name>은 로그 파일의 유효한 경로이고 <log client name>은 고유한 클라이언트 식별자입니다. 로그 저장소는 실제 로그 저장소나 가상 로그 저장소 중 하나여야 합니다. 로그 저장소를 실제로 만들거나 가상으로 만들면 로그 저장소의 수명이 끝날 때까지 만든 상태로 유지됩니다. 실제 로그 저장소는 실제 로그 이름만 지정하여 만들어지고, 가상 로그 저장소는 실제 로그 이름과 로그 클라이언트 이름을 모두 지정하여 만들어집니다.

동일한 실제 로그 이름을 공유하는 클라이언트는 동일한 범위 컬렉션과 정책을 공유합니다.

적용 대상