PathTooLongException PathTooLongException PathTooLongException PathTooLongException Class

Definition

Die Ausnahme wird ausgelöst, wenn ein Pfad oder vollqualifizierter Dateiname die vom System definierte maximale Länge übersteigt.The exception that is thrown when a path or fully qualified file name is longer than the system-defined maximum length.

public ref class PathTooLongException : System::IO::IOException
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class PathTooLongException : System.IO.IOException
type PathTooLongException = class
    inherit IOException
Public Class PathTooLongException
Inherits IOException
Vererbung
Attribute

Hinweise

Wenn Ihr Code keinen FileIOPermissionAttribute.PathDiscovery -Berechtigung, die Fehlermeldung für diese Ausnahme nur Datei- bzw. Verzeichnisnamen anstelle von vollständigen Pfade enthalten kann.If your code does not have FileIOPermissionAttribute.PathDiscovery permission, the error message for this exception may contain only file or directory names instead of full paths.

In apps, die unter Versionen von .NET Framework vor dem Ausführen der .NET Framework 4.6.2.NET Framework 4.6.2, vollständige Pfade darf 260 Zeichen ein, um die Kompatibilität mit Windows-Betriebssystemen nicht überschreiten.In apps that run under versions of the .NET Framework prior to the .NET Framework 4.6.2.NET Framework 4.6.2, full paths must not exceed 260 characters to maintain compatibility with Windows operating systems. Einen beliebigen Pfad mehr als 260 Zeichen automatisch löst eine PathTooLongException.Any path in excess of 260 characters automatically throws a PathTooLongException. Weitere Informationen zu dieser Einschränkung finden Sie im Eintrag langen Pfaden in .NET im BCL-Teamblog.For more information about this restriction, see the entry Long Paths in .NET in the BCL Team blog.

Hinweis

Diese Ausnahme befindet sich nicht im .NET für Windows Store-apps oder Portable Class Library, aber sie durch einige Member, die ausgelöst wird.This exception is not included in .NET for Windows Store apps or the Portable Class Library, but it is thrown by some members that are. Um in diesem Fall die Ausnahme abzufangen, Schreiben einer catch -Anweisung, behandelt eine IOException stattdessen.To catch the exception in that case, write a catch statement that handles an IOException instead.

Beginnend mit apps, die unter der .NET Framework 4.6.2.NET Framework 4.6.2, .NET Framework unterstützt lange Pfaden, die mehr als 260 (oder MAX_PATH) Zeichen.Starting with apps running under the .NET Framework 4.6.2.NET Framework 4.6.2, the .NET Framework supports long paths in excess of 260 (or MAX_PATH) characters. Die Bedingungen, unter denen eine PathTooLongException Ausnahme sind hängt von der Version von .NET Framework, die eine app ausgerichtet ist:The conditions under which a PathTooLongException exception are thrown depend on the version of the .NET Framework that an app targets:

Apps für die .NET Framework 4.6.2.NET Framework 4.6.2 und höhere VersionenApps that target the .NET Framework 4.6.2.NET Framework 4.6.2 and later versions
Lange Pfade werden standardmäßig unterstützt.Long paths are supported by default. Löst die Laufzeit eine PathTooLongException unter den folgenden Bedingungen:The runtime throws a PathTooLongException under the following conditions:

  • Das Betriebssystem gibt COR_E_PATHTOOLONG oder einen dazu äquivalenten Wert zurück.The operating system returns COR_E_PATHTOOLONG or its equivalent.

  • Die Länge des Pfads überschreitet Int16.MaxValue (32.767) Zeichen.The length of the path exceeds Int16.MaxValue (32,767) characters.

Apps für die .NET Framework 4.6.1.NET Framework 4.6.1 und früheren VersionenApps that target the .NET Framework 4.6.1.NET Framework 4.6.1 and earlier versions
Lange Pfade sind standardmäßig deaktiviert, und das Legacyverhalten beibehalten wird.Long paths are disabled by default, and the legacy behavior is maintained. Löst die Laufzeit eine PathTooLongException jedes Mal, wenn ein Pfad die Länge von 260 Zeichen überschreitet.The runtime throws a PathTooLongException whenever a path exceeds 260 characters.

Wenn dies nicht erwünscht ist, apps für die Zielplattform die .NET Framework 4.6.1.NET Framework 4.6.1 und früheren, aber führen Sie unter der .NET Framework 4.6.2.NET Framework 4.6.2 können Unterstützung für lange Pfade dazu die folgende Einstellung in der <Runtime > Element der Anwendung Konfigurationsdatei:If this is undesirable, apps that target the .NET Framework 4.6.1.NET Framework 4.6.1 and earlier but run under the .NET Framework 4.6.2.NET Framework 4.6.2 can enable long path support by including the following setting in the <runtime> element of the application configuration file:


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

PathTooLongException verwendet das HRESULT COR_E_PATHTOOLONG, die über den Wert 0x800700CE verfügt.PathTooLongException uses the HRESULT COR_E_PATHTOOLONG, which has the value 0x800700CE.

Konstruktoren

PathTooLongException() PathTooLongException() PathTooLongException() PathTooLongException()

Initialisiert eine neue Instanz der PathTooLongException-Klasse, bei der HRESULT auf COR_E_PATHTOOLONG festgelegt ist.Initializes a new instance of the PathTooLongException class with its HRESULT set to COR_E_PATHTOOLONG.

PathTooLongException(SerializationInfo, StreamingContext) PathTooLongException(SerializationInfo, StreamingContext) PathTooLongException(SerializationInfo, StreamingContext) PathTooLongException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der PathTooLongException-Klasse mit der angegebenen Serialisierung und den angegebenen Kontextinformationen.Initializes a new instance of the PathTooLongException class with the specified serialization and context information.

PathTooLongException(String) PathTooLongException(String) PathTooLongException(String) PathTooLongException(String)

Initialisiert eine neue Instanz der PathTooLongException-Klasse, bei der die Meldungszeichenfolge auf message und HRESULT auf COR_E_PATHTOOLONG festgelegt ist.Initializes a new instance of the PathTooLongException class with its message string set to message and its HRESULT set to COR_E_PATHTOOLONG.

PathTooLongException(String, Exception) PathTooLongException(String, Exception) PathTooLongException(String, Exception) 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.Initializes a new instance of the PathTooLongException class with a specified error message and a reference to the inner exception that is the cause of this exception.

Eigenschaften

Data Data Data Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt.Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.Gets the method that throws the current exception.

(Inherited from Exception)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Inherited from Exception)
GetType() GetType() GetType() GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.Creates and returns a string representation of the current exception.

(Inherited from Exception)

Ereignisse

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Gilt für:

Siehe auch