PathTooLongException Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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::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- Herencia
- Herencia
- Atributos
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_PATHTOOLONGo 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 |
| 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) |
