PathTooLongException Classe
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::IOException
public 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.IOException
type PathTooLongException = class
inherit IOException
[<System.Serializable>]
type PathTooLongException = class
inherit IOException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type PathTooLongException = class
inherit IOException
Public Class PathTooLongException
Inherits IOException
- Herança
- Herança
- Atributos
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_PATHTOOLONG
ou 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.
Path |
Inicializa uma nova instância da classe PathTooLongException com o HRESULT definido como COR_E_PATHTOOLONG. |
Path |
Obsoleto.
Inicializa uma nova instância da classe PathTooLongException com as informações de serialização e contexto especificadas. |
Path |
Inicializa uma nova instância da classe PathTooLongException com sua cadeia de caracteres de mensagem definida como |
Path |
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. |
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) |
Help |
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) |
Inner |
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) |
Stack |
Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception) |
Target |
Obtém o método que gerou a exceção atual. (Herdado de Exception) |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
Get |
Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
Get |
Serve como a função de hash padrão. (Herdado de Object) |
Get |
Obsoleto.
Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção. (Herdado de Exception) |
Get |
Obtém o tipo de runtime da instância atual. (Herdado de Exception) |
Memberwise |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
To |
Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception) |
Serialize |
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) |
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: