Поделиться через


PathTooLongException Класс

Определение

Исключение, которое создается, когда путь или полное имя файла длиннее, чем максимальная длина, определенная системой.

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 до платформа .NET Framework 4.6.2, полные пути не должны превышать 260 символов для обеспечения совместимости с операционными системами Windows. Любой путь, превышающий 260 символов, автоматически вызывает исключение PathTooLongException. Дополнительные сведения об этом ограничении см. в записи Длинные пути в .NET в блоге группы BCL.

Примечание

Это исключение не входит в состав .NET для приложений Магазина Windows или переносимой библиотеки классов, но оно создается некоторыми членами. Чтобы перехватить исключение в этом случае, напишите catch оператор, обрабатывающий IOException вместо этого .

Начиная с приложений, работающих в платформа .NET Framework 4.6.2, платформа .NET Framework поддерживает длинные пути, превышающие 260 (или MAX_PATH) символов. Условия, при которых возникает исключение, зависят от версии платформа .NET Framework, на которую PathTooLongException нацелено приложение:

Приложения, предназначенные для платформа .NET Framework 4.6.2 и более поздних версий Длинные пути, поддерживаются по умолчанию. Среда выполнения создает исключение при PathTooLongException следующих условиях:

  • операционная система возвращает COR_E_PATHTOOLONG или его эквивалент;

  • Длина пути превышает Int16.MaxValue (32 767) символов.

Приложения, предназначенные для платформа .NET Framework 4.6.1 и более ранних версий Длинные пути, по умолчанию отключены, и прежнее поведение сохраняется. Среда выполнения создает исключение , PathTooLongException если путь превышает 260 символов.

Если это нежелательно, приложения, предназначенные для платформа .NET Framework 4.6.1 и более ранних версий, но выполняющиеся в платформа .NET Framework 4.6.2, могут включить поддержку длинного пути, включив следующий параметр в <элемент среды выполнения> файла конфигурации приложения:

<runtime>
   <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />
</runtime>

PathTooLongException использует HRESULT COR_E_PATHTOOLONG, который имеет значение 0x800700CE.

Конструкторы

PathTooLongException()

Выполняет инициализацию нового экземпляра класса PathTooLongException с параметром HRESULT, для которого задано значение COR_E_PATHTOOLONG.

PathTooLongException(SerializationInfo, StreamingContext)
Устаревшие..

Инициализирует новый экземпляр класса PathTooLongException с указанными данными о сериализации и контексте.

PathTooLongException(String)

Инициализирует новый экземпляр класса PathTooLongException со строкой сообщения, для которой задан параметр message, и параметром HRESULT, для которого задано значение COR_E_PATHTOOLONG.

PathTooLongException(String, Exception)

Инициализирует новый экземпляр класса PathTooLongException указанным сообщением об ошибке и ссылкой на внутреннее исключение, вызвавшее данное исключение.

Свойства

Data

Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении.

(Унаследовано от Exception)
HelpLink

Получает или задает ссылку на файл справки, связанный с этим исключением.

(Унаследовано от Exception)
HResult

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.

(Унаследовано от Exception)
InnerException

Возвращает экземпляр класса Exception, который вызвал текущее исключение.

(Унаследовано от Exception)
Message

Возвращает сообщение, описывающее текущее исключение.

(Унаследовано от Exception)
Source

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.

(Унаследовано от Exception)
StackTrace

Получает строковое представление непосредственных кадров в стеке вызова.

(Унаследовано от Exception)
TargetSite

Возвращает метод, создавший текущее исключение.

(Унаследовано от Exception)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetBaseException()

При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений.

(Унаследовано от Exception)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)
Устаревшие..

При переопределении в производном классе задает объект SerializationInfo со сведениями об исключении.

(Унаследовано от Exception)
GetType()

Возвращает тип среды выполнения текущего экземпляра.

(Унаследовано от Exception)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Создает и возвращает строковое представление текущего исключения.

(Унаследовано от Exception)

События

SerializeObjectState
Устаревшие..

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.

(Унаследовано от Exception)

Применяется к

См. также раздел