Teilen über


PathTooLongException Klasse

Definition

Die Ausnahme wird ausgelöst, wenn ein Pfad oder vollqualifizierter Dateiname die vom System definierte maximale Länge übersteigt.

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
Vererbung
PathTooLongException
Vererbung
Attribute

Hinweise

In Apps, die unter Versionen der .NET Framework vor der .NET Framework 4.6.2 ausgeführt werden, dürfen vollständige Pfade nicht mehr als 260 Zeichen lang sein, um die Kompatibilität mit Windows-Betriebssystemen zu gewährleisten. Jeder Pfad, der mehr als 260 Zeichen umfasst, löst automatisch einen aus PathTooLongException. Weitere Informationen zu dieser Einschränkung finden Sie im BCL-Teamblog im Eintrag Long Paths in .NET .

Hinweis

Diese Ausnahme ist nicht in .NET für Windows Store-Apps oder der portablen Klassenbibliothek enthalten, wird aber von einigen Mitgliedern ausgelöst. Um die Ausnahme in diesem Fall abzufangen, schreiben Sie eine catch Anweisung, die stattdessen ein IOException behandelt.

Ab Apps, die unter der .NET Framework 4.6.2 ausgeführt werden, unterstützt die .NET Framework lange Pfade mit mehr als 260 Zeichen (oder MAX_PATH) . Die Bedingungen, unter denen eine PathTooLongException Ausnahme ausgelöst wird, hängen von der Version des .NET Framework ab, auf die eine App abzielt:

Apps, die auf lange Pfade .NET Framework 4.6.2 und höher abzielen, werden standardmäßig unterstützt. Die Runtime löst einen PathTooLongException unter den folgenden Bedingungen aus:

  • Das Betriebssystem gibt COR_E_PATHTOOLONG oder einen dazu äquivalenten Wert zurück.

  • Die Länge des Pfads Int16.MaxValue überschreitet (32.767) Zeichen.

Apps, die auf die .NET Framework 4.6.1 und frühere Versionen von Long-Pfaden abzielen, sind standardmäßig deaktiviert, und das Legacyverhalten wird beibehalten. Die Laufzeit löst ein PathTooLongException aus, wenn ein Pfad 260 Zeichen überschreitet.

Wenn dies nicht wünschenswert ist, können Apps, die auf die .NET Framework 4.6.1 und früher abzielen, aber unter der .NET Framework 4.6.2 ausgeführt werden, die Unterstützung für lange Pfade aktivieren, indem sie die folgende Einstellung in das <Laufzeitelement> der Anwendungskonfigurationsdatei einschließen:

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

PathTooLongException verwendet das HRESULT COR_E_PATHTOOLONG, das den Wert 0x800700CE hat.

Konstruktoren

PathTooLongException()

Initialisiert eine neue Instanz der PathTooLongException-Klasse, bei der HRESULT auf COR_E_PATHTOOLONG festgelegt ist.

PathTooLongException(SerializationInfo, StreamingContext)
Veraltet.

Initialisiert eine neue Instanz der PathTooLongException-Klasse mit den angegebenen Serialisierungs- und Kontextinformationen.

PathTooLongException(String)

Initialisiert eine neue Instanz der PathTooLongException-Klasse, bei der die Meldungszeichenfolge auf message und HRESULT auf COR_E_PATHTOOLONG festgelegt ist.

PathTooLongException(String, Exception)

Initialisiert eine neue Instanz der PathTooLongException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.

Eigenschaften

Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen.

(Geerbt von Exception)
HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.

(Geerbt von Exception)
HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.

(Geerbt von Exception)
InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.

(Geerbt von Exception)
Message

Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird.

(Geerbt von Exception)
Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.

(Geerbt von Exception)
StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.

(Geerbt von Exception)
TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.

(Geerbt von Exception)

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist.

(Geerbt von Exception)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)
Veraltet.

Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest.

(Geerbt von Exception)
GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.

(Geerbt von Exception)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.

(Geerbt von Exception)

Ereignisse

SerializeObjectState
Veraltet.

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.

(Geerbt von Exception)

Gilt für:

Weitere Informationen