PathTooLongException Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
A exceção gerada quando um caminho ou nome de arquivo totalmente qualificado é maior que o tamanho máximo definido pelo 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- Herança
- Herança
- Atributos
Comentários
Em aplicativos executados em versões do .NET Framework antes do .NET Framework 4.6.2, os caminhos completos não devem exceder 260 caracteres para manter a compatibilidade com os sistemas operacionais Windows. Qualquer caminho com mais de 260 caracteres gera automaticamente um PathTooLongException. Para obter mais informações sobre essa restrição, consulte a entrada Caminhos Longos no .NET no blog da Equipe BCL.
Observação
Essa exceção não está incluída no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, mas é gerada por alguns membros que são. Para capturar a exceção nesse caso, escreva uma catch instrução que manipula um IOException .
Começando com aplicativos em execução no .NET Framework 4.6.2, o .NET Framework dá suporte a caminhos longos superiores a 260 (ou MAX_PATH) caracteres. As condições sob as quais uma PathTooLongException exceção é lançada dependem da versão do .NET Framework que um aplicativo tem como destino:
Aplicativos direcionados ao .NET Framework 4.6.2 e versões posteriores Caminhos longos têm suporte por padrão. O runtime lança um PathTooLongException sob as seguintes condições:
O sistema operacional retorna
COR_E_PATHTOOLONGou seu equivalente.O comprimento do caminho excede (32.767) caracteres Int16.MaxValue .
Os aplicativos direcionados ao .NET Framework 4.6.1 e versões anteriores Caminhos longos são desabilitados por padrão e o comportamento herdado é mantido. O runtime lança um PathTooLongException sempre que um caminho excede 260 caracteres.
Se isso for indesejável, os aplicativos direcionados ao .NET Framework 4.6.1 e anteriores, mas executados no .NET Framework 4.6.2, poderão habilitar o suporte a caminhos longos incluindo a seguinte configuração no <elemento de runtime> do arquivo de configuração do aplicativo:
<runtime>
<AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />
</runtime>
PathTooLongException usa o HRESULT COR_E_PATHTOOLONG, que tem o valor 0x800700CE.
Construtores
| PathTooLongException() |
Inicializa uma nova instância da classe PathTooLongException com o HRESULT definido como COR_E_PATHTOOLONG. |
| PathTooLongException(SerializationInfo, StreamingContext) |
Obsoleto.
Inicializa uma nova instância da classe PathTooLongException com as informações de serialização e contexto especificadas. |
| PathTooLongException(String) |
Inicializa uma nova instância da classe PathTooLongException com sua cadeia de caracteres de mensagem definida como |
| PathTooLongException(String, Exception) |
Inicializa uma nova instância da classe PathTooLongException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção. |
Propriedades
| Data |
Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção. (Herdado de Exception) |
| HelpLink |
Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception) |
| HResult |
Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception) |
| InnerException |
Obtém a instância Exception que causou a exceção atual. (Herdado de Exception) |
| Message |
Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception) |
| Source |
Obtém ou define o nome do aplicativo ou objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que gerou a exceção atual. (Herdado de Exception) |
Métodos
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Obsoleto.
Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção. (Herdado de Exception) |
| GetType() |
Obtém o tipo de runtime da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| ToString() |
Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception) |
Eventos
| SerializeObjectState |
Obsoleto.
Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception) |
