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 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
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

Confira também