PathTooLongException Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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::IOExceptionpublic 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.IOExceptiontype PathTooLongException = class
inherit IOException[<System.Serializable>]
type PathTooLongException = class
inherit IOException[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type PathTooLongException = class
inherit IOExceptionPublic Class PathTooLongException
Inherits IOException- Vererbung
- 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_PATHTOOLONGoder 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 |
| 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) |
