PathTooLongException Clase

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Source:

PathTooLongException.cs

Excepción que se produce cuando la longitud de una ruta de acceso o un nombre de archivo completo supera la longitud máxima definida por el sistema.

public ref class PathTooLongException : System::IO::IOException

public class PathTooLongException : System.IO.IOException

type PathTooLongException = class
    inherit IOException

Public Class PathTooLongException
Inherits IOException

Herencia

Object

Exception

SystemException

IOException

PathTooLongException

Comentarios

En las aplicaciones que se ejecutan en versiones de .NET Framework anteriores a .NET Framework 4.6.2, las rutas de acceso completas no deben superar los 260 caracteres para mantener la compatibilidad con los sistemas operativos Windows. Cualquier ruta de acceso superior a 260 caracteres inicia automáticamente .PathTooLongException Para obtener más información sobre esta restricción, consulte la entrada Rutas de acceso largas en .NET en el blog del equipo de BCL.

Nota

Esta excepción no se incluye en .NET para aplicaciones de la Tienda Windows ni en la biblioteca de clases portable, pero algunos miembros los inician. Para detectar la excepción en ese caso, escriba una catch instrucción que controle en IOException su lugar.

A partir de las aplicaciones que se ejecutan en .NET Framework 4.6.2, .NET Framework admite rutas de acceso largas superiores a 260 caracteres (o MAX_PATH). Las condiciones en las que se produce una PathTooLongException excepción dependen de la versión de .NET Framework a la que se dirige una aplicación:

Aplicaciones destinadas a .NET Framework 4.6.2 y versiones posteriores Las rutas de acceso largas se admiten de forma predeterminada. El tiempo de ejecución produce una PathTooLongException excepción en las siguientes condiciones:

• El sistema operativo devuelve COR_E_PATHTOOLONG o su equivalente.

• La longitud de la ruta de acceso supera ( Int16.MaxValue 32 767) caracteres.

Aplicaciones destinadas a .NET Framework 4.6.1 y versiones anteriores Las rutas de acceso largas están deshabilitadas de forma predeterminada y se mantiene el comportamiento heredado. El tiempo de ejecución produce una PathTooLongException siempre que una ruta de acceso supere los 260 caracteres.

Si esto no es deseable, las aplicaciones que tienen como destino .NET Framework 4.6.1 y versiones anteriores, pero que se ejecutan en .NET Framework 4.6.2 pueden habilitar la compatibilidad con rutas de acceso largas mediante la inclusión de la siguiente configuración en el <elemento en tiempo de ejecución> del archivo de configuración de la aplicación:

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

PathTooLongException usa HRESULT COR_E_PATHTOOLONG, que tiene el valor 0x800700CE.

Constructores

PathTooLongException()	Inicializa una nueva instancia de la clase PathTooLongException con HRESULT establecido en COR_E_PATHTOOLONG.
PathTooLongException(SerializationInfo, StreamingContext)	Obsoletos. Inicializa una nueva instancia de la clase PathTooLongException con la serialización y la información de contexto especificados.
PathTooLongException(String)	Inicializa una nueva instancia de la clase PathTooLongException con la cadena de mensaje establecida en message y HRESULT en COR_E_PATHTOOLONG.
PathTooLongException(String, Exception)	Inicializa una nueva instancia de la clase PathTooLongException con el mensaje de error especificado y una referencia a la excepción interna que representa la causa de esta excepción.

Propiedades

Data	Obtiene una colección de pares clave/valor que proporciona información definida por el usuario adicional sobre la excepción. (Heredado de Exception)
HelpLink	Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción. (Heredado de Exception)
HResult	Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica. (Heredado de Exception)
InnerException	Obtiene la instancia Exception que produjo la excepción actual. (Heredado de Exception)
Message	Obtiene un mensaje que describe la excepción actual. (Heredado de Exception)
Source	Devuelve o establece el nombre de la aplicación o del objeto que generó el error. (Heredado de Exception)
StackTrace	Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas. (Heredado de Exception)
TargetSite	Obtiene el método que produjo la excepción actual. (Heredado de Exception)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetBaseException()	Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores. (Heredado de Exception)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Obsoletos. Cuando se invalida en una clase derivada, establece SerializationInfo con información sobre la excepción. (Heredado de Exception)
GetType()	Obtiene el tipo de tiempo de ejecución de la instancia actual. (Heredado de Exception)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Crea y devuelve una representación de cadena de la excepción actual. (Heredado de Exception)

Eventos

SerializeObjectState

Obsoletos. Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción. (Heredado de Exception)

Consulte también

• Exception
• Controlar y generar excepciones en .NET
• E/S de archivos y secuencias
• Cómo: Leer texto de un archivo
• Cómo: Escribir texto en un archivo