Condividi tramite


PathTooLongException Classe

Definizione

Eccezione che viene generata quando un percorso o un nome file completo contiene un numero di caratteri superiore alla lunghezza massima definita dal 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
Ereditarietà
PathTooLongException
Ereditarietà
Attributi

Commenti

Nelle app eseguite nelle versioni di .NET Framework precedenti a .NET Framework 4.6.2, i percorsi completi non devono superare i 260 caratteri per mantenere la compatibilità con i sistemi operativi Windows. Qualsiasi percorso superiore a 260 caratteri genera automaticamente un'eccezione PathTooLongException. Per altre informazioni su questa restrizione, vedere la voce Percorsi lunghi in .NET nel blog del team BCL.

Nota

Questa eccezione non è inclusa in .NET per le app di Windows Store o nella libreria di classi portabile, ma viene generata da alcuni membri. Per intercettare l'eccezione in questo caso, scrivere invece un'istruzione catch che gestisce un oggetto IOException .

A partire dalle app in esecuzione in .NET Framework 4.6.2, .NET Framework supporta percorsi lunghi in eccesso di 260 (o MAX_PATH) caratteri. Le condizioni in cui viene generata un'eccezione PathTooLongException dipendono dalla versione di .NET Framework destinata a un'app:

App destinate a .NET Framework 4.6.2 e versioni successive I percorsi lunghi sono supportati per impostazione predefinita. Il runtime genera un'eccezione PathTooLongException nelle condizioni seguenti:

  • Il sistema operativo restituisce COR_E_PATHTOOLONG o equivalente.

  • La lunghezza del percorso supera Int16.MaxValue (32.767) caratteri.

App destinate a .NET Framework 4.6.1 e versioni precedenti I percorsi lunghi sono disabilitati per impostazione predefinita e il comportamento legacy viene mantenuto. Il runtime genera un'eccezione PathTooLongException ogni volta che un percorso supera i 260 caratteri.

Se questo è indesiderato, le app destinate a .NET Framework 4.6.1 e versioni precedenti, ma eseguite in .NET Framework 4.6.2 possono abilitare il supporto lungo del percorso includendo l'impostazione seguente nell'elemento di runtime> del file di configurazione dell'applicazione<:

<runtime>
   <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />
</runtime>

PathTooLongException usa HRESULT COR_E_PATHTOOLONG, che ha il valore 0x800700CE.

Costruttori

PathTooLongException()

Inizializza una nuova istanza della classe PathTooLongException con HRESULT impostato su COR_E_PATHTOOLONG.

PathTooLongException(SerializationInfo, StreamingContext)
Obsoleti.

Inizializza una nuova istanza della classe PathTooLongException con le informazioni di serializzazione e di contesto specificate.

PathTooLongException(String)

Inizializza una nuova istanza della classe PathTooLongException con la relativa stringa di messaggio impostata su message e HRESULT impostato su COR_E_PATHTOOLONG.

PathTooLongException(String, Exception)

Inizializza una nuova istanza della classe PathTooLongException con un messaggio di errore specificato e un riferimento all'eccezione interna che è la causa dell'eccezione corrente.

Proprietà

Data

Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione.

(Ereditato da Exception)
HelpLink

Ottiene o imposta un collegamento al file della Guida associato all'eccezione.

(Ereditato da Exception)
HResult

Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica.

(Ereditato da Exception)
InnerException

Ottiene l'istanza di Exception che ha causato l'eccezione corrente.

(Ereditato da Exception)
Message

Ottiene un messaggio che descrive l'eccezione corrente.

(Ereditato da Exception)
Source

Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore.

(Ereditato da Exception)
StackTrace

Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate.

(Ereditato da Exception)
TargetSite

Ottiene il metodo che genera l'eccezione corrente.

(Ereditato da Exception)

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetBaseException()

Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive.

(Ereditato da Exception)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)
Obsoleti.

Quando ne viene eseguito l'override in una classe derivata, imposta il controllo SerializationInfo con le informazioni sull'eccezione.

(Ereditato da Exception)
GetType()

Ottiene il tipo di runtime dell'istanza corrente.

(Ereditato da Exception)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Crea e restituisce una rappresentazione di stringa dell'eccezione corrente.

(Ereditato da Exception)

Eventi

SerializeObjectState
Obsoleti.

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione.

(Ereditato da Exception)

Si applica a

Vedi anche