PathTooLongException Класс

Ссылка

Определение

Пространство имен:: System.IO

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Исходный код:: PathTooLongException.cs

Исходный код:: PathTooLongException.cs

Исходный код:: PathTooLongException.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

Наследование: Object

Exception

IOException
PathTooLongException

Наследование: Object

Exception

SystemException

IOException
PathTooLongException

Атрибуты: SerializableAttribute ComVisibleAttribute

В приложениях, работающих в версиях платформа .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)

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

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