PathTooLongException 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
경로나 정규화된 파일 이름이 시스템에서 정의한 최대 길이보다 더 긴 경우에 throw되는 예외입니다.
public ref class PathTooLongException : System::IO::IOException
public class PathTooLongException : System.IO.IOException
[System.Serializable]
public class PathTooLongException : System.IO.IOException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class PathTooLongException : System.IO.IOException
type PathTooLongException = class
inherit IOException
[<System.Serializable>]
type PathTooLongException = class
inherit IOException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type PathTooLongException = class
inherit IOException
Public Class PathTooLongException
Inherits IOException
- 상속
- 상속
- 특성
설명
.NET Framework 4.6.2 이전의 .NET Framework 버전에서 실행되는 앱에서는 Windows 운영 체제와의 호환성을 유지하기 위해 전체 경로가 260자를 초과하지 않아야 합니다. 260자를 초과하는 경로는 자동으로 을 PathTooLongExceptionthrow합니다. 이 제한에 대한 자세한 내용은 BCL 팀 블로그 에서 .NET의 긴 경로 항목을 참조하세요.
참고
이 예외는 Windows 스토어 앱 또는 이식 가능한 클래스 라이브러리용 .NET에 포함되지 않지만 일부 멤버가 throw합니다. 이 경우 예외를 catch하려면 대신 를 catch
처리하는 문을 작성합니다 IOException .
.NET Framework 4.6.2에서 실행되는 앱부터 .NET Framework 260(또는 MAX_PATH
) 문자를 초과하는 긴 경로를 지원합니다. 예외가 PathTooLongException throw되는 조건은 앱이 대상으로 하는 .NET Framework 버전에 따라 달라집니다.
.NET Framework 4.6.2 이상 버전을 대상으로 하는 앱은 기본적으로 긴 경로가 지원됩니다. 런타임은 다음 조건에서 을 throw합니다 PathTooLongException .
운영 체제가
COR_E_PATHTOOLONG
또는 동급을 반환하는 경우경로 길이가 (32,767)를 초과합니다 Int16.MaxValue .
.NET Framework 4.6.1 및 이전 버전의 Long 경로를 대상으로 하는 앱은 기본적으로 사용하지 않도록 설정되며 레거시 동작은 유지 관리됩니다. 런타임은 경로가 PathTooLongException 260자를 초과할 때마다 을 throw합니다.
바람직하지 않은 경우 .NET Framework 4.6.1 이하를 대상으로 하지만 .NET Framework 4.6.2에서 실행되는 앱은 애플리케이션 구성 파일의 런타임> 요소에< 다음 설정을 포함하여 긴 경로 지원을 사용하도록 설정할 수 있습니다.
<runtime>
<AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />
</runtime>
PathTooLongException 는 값이 0x800700CE HRESULT COR_E_PATHTOOLONG
를 사용합니다.
생성자
PathTooLongException() |
COR_E_PATHTOOLONG으로 설정된 HRESULT를 사용하여 PathTooLongException 클래스의 새 인스턴스를 초기화합니다. |
PathTooLongException(SerializationInfo, StreamingContext) |
사용되지 않음.
지정한 직렬화 및 컨텍스트 정보를 사용하여 PathTooLongException 클래스의 새 인스턴스를 초기화합니다. |
PathTooLongException(String) |
|
PathTooLongException(String, Exception) |
지정된 오류 메시지와 해당 예외의 원인인 내부 예외에 대한 참조를 사용하여 PathTooLongException 클래스의 새 인스턴스를 초기화합니다. |
속성
Data |
예외에 대한 사용자 정의 정보를 추가로 제공하는 키/값 쌍 컬렉션을 가져옵니다. (다음에서 상속됨 Exception) |
HelpLink |
이 예외와 연결된 도움말 파일에 대한 링크를 가져오거나 설정합니다. (다음에서 상속됨 Exception) |
HResult |
특정 예외에 할당된 코드화된 숫자 값인 HRESULT를 가져오거나 설정합니다. (다음에서 상속됨 Exception) |
InnerException |
현재 예외를 발생시킨 Exception 인스턴스를 가져옵니다. (다음에서 상속됨 Exception) |
Message |
현재 예외를 설명하는 메시지를 가져옵니다. (다음에서 상속됨 Exception) |
Source |
오류를 발생시키는 애플리케이션 또는 개체의 이름을 가져오거나 설정합니다. (다음에서 상속됨 Exception) |
StackTrace |
호출 스택의 직접 실행 프레임 문자열 표현을 가져옵니다. (다음에서 상속됨 Exception) |
TargetSite |
현재 예외를 throw하는 메서드를 가져옵니다. (다음에서 상속됨 Exception) |
메서드
Equals(Object) |
지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object) |
GetBaseException() |
파생 클래스에서 재정의된 경우 하나 이상의 후속 예외의 근본 원인이 되는 Exception 을 반환합니다. (다음에서 상속됨 Exception) |
GetHashCode() |
기본 해시 함수로 작동합니다. (다음에서 상속됨 Object) |
GetObjectData(SerializationInfo, StreamingContext) |
사용되지 않음.
파생 클래스에서 재정의된 경우 예외에 관한 정보를 SerializationInfo 에 설정합니다. (다음에서 상속됨 Exception) |
GetType() |
현재 인스턴스의 런타임 형식을 가져옵니다. (다음에서 상속됨 Exception) |
MemberwiseClone() |
현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
ToString() |
현재 예외에 대한 문자열 표현을 만들고 반환합니다. (다음에서 상속됨 Exception) |
이벤트
SerializeObjectState |
사용되지 않음.
예외에 대한 serialize된 데이터가 들어 있는 예외 상태 개체가 만들어지도록 예외가 serialize될 때 발생합니다. (다음에서 상속됨 Exception) |
적용 대상
추가 정보
.NET