다음을 통해 공유


PathTooLongException 클래스

정의

경로나 정규화된 파일 이름이 시스템에서 정의한 최대 길이보다 더 긴 경우에 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
상속
PathTooLongException
상속
특성

설명

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

message로 설정된 메시지 문자열과 COR_E_PATHTOOLONG으로 설정된 HRESULT를 사용하여 PathTooLongException 클래스의 새 인스턴스를 초기화합니다.

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)

적용 대상

추가 정보