PathTooLongException Classe

Referência

Definição

Namespace:: System.IO

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origem:: PathTooLongException.cs

Origem:: PathTooLongException.cs

Origem:: PathTooLongException.cs

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

Exception

IOException
PathTooLongException

Herança: Object

Exception

SystemException

IOException
PathTooLongException

Atributos: SerializableAttribute ComVisibleAttribute

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

Partilhar via