PathTooLongException Třída

Reference

Definice

Obor názvů:: System.IO

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Zdroj:: PathTooLongException.cs

Zdroj:: PathTooLongException.cs

Zdroj:: PathTooLongException.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Výjimka, která je vyvolán, když cesta nebo plně kvalifikovaný název souboru je delší než maximální délka definovaná systémem.

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

Dědičnost: Object

Exception

IOException
PathTooLongException

Dědičnost: Object

Exception

SystemException

IOException
PathTooLongException

Atributy: SerializableAttribute ComVisibleAttribute

Poznámky

V aplikacích, které běží ve verzích rozhraní .NET Framework před rozhraním .NET Framework 4.6.2, nesmí úplné cesty překročit 260 znaků, aby byla zachována kompatibilita s operačními systémy Windows. Jakákoli cesta přesahující 260 znaků automaticky vyvolá PathTooLongException. Další informace o tomto omezení najdete v položce Dlouhé cesty v .NET na blogu týmu BCL.

Poznámka

Tato výjimka není zahrnuta v rozhraní .NET pro aplikace pro Windows Store ani v knihovně přenosných tříd, ale je vyvolán některými členy, kteří jsou. Pokud chcete zachytit výjimku v takovém případě, napište catch příkaz, který místo toho zpracuje .IOException

Počínaje aplikacemi spuštěnými v rozhraní .NET Framework 4.6.2 podporuje rozhraní .NET Framework dlouhé cesty přesahující 260 (nebo MAX_PATH) znaků. Podmínky, za kterých dojde k výjimce PathTooLongException , závisí na verzi rozhraní .NET Framework, na kterou aplikace cílí:

Aplikace, které cílí na rozhraní .NET Framework 4.6.2 a novější verze Dlouhé cesty jsou ve výchozím nastavení podporované. Modul runtime vyvolá za PathTooLongException následujících podmínek:

Operační systém vrátí COR_E_PATHTOOLONG hodnotu nebo její ekvivalent.
Délka cesty přesahuje Int16.MaxValue (32 767) znaků.

Aplikace, které cílí na rozhraní .NET Framework 4.6.1 a starší verze Dlouhé cesty jsou ve výchozím nastavení zakázané a starší verze se zachová. Modul runtime vyvolá výjimku vždy PathTooLongException , když cesta překročí 260 znaků.

Pokud je to nežádoucí, aplikace, které cílí na rozhraní .NET Framework 4.6.1 a starší, ale běží pod rozhraním .NET Framework 4.6.2, mohou povolit podporu dlouhých cest zahrnutím následujícího nastavení do elementu <runtime> konfiguračního souboru aplikace:

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

PathTooLongException používá hodnotu HRESULT COR_E_PATHTOOLONG, která má hodnotu 0x800700CE.

Konstruktory

PathTooLongException()	Inicializuje novou instanci PathTooLongException třídy s hresult nastavenou na COR_E_PATHTOOLONG.
PathTooLongException(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci PathTooLongException třídy se zadaným serializace a kontextové informace.
PathTooLongException(String)	Inicializuje novou instanci PathTooLongException třídy s řetězcem zprávy nastaveným na `message` a hresult nastaveným na COR_E_PATHTOOLONG.
PathTooLongException(String, Exception)	Inicializuje novou instanci PathTooLongException třídy se zadanou chybovou zprávou a odkazem na vnitřní výjimku, která je příčinou této výjimky.

Vlastnosti

Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovaná číselná hodnota, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcovou reprezentaci okamžitých rámců v zásobníku volání. (Zděděno od Exception)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí hodnotu Exception , která je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Při přepsání v odvozené třídě nastaví s SerializationInfo informacemi o výjimce. (Zděděno od Exception)
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

Událost

SerializeObjectState

Zastaralé.

Nastane, když je výjimka serializována k vytvoření objektu stavu výjimky, který obsahuje serializovaná data o výjimce.

(Zděděno od Exception)

Platí pro