PathTooLongException Classe

Definição

A exceção gerada quando um caminho ou nome de arquivo totalmente qualificado é maior que o tamanho máximo definido pelo sistema.

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
Herança
PathTooLongException
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_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.

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 message e seu HRESULT definido como COR_E_PATHTOOLONG.

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)

Aplica-se a

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

Confira também