PathTooLongException Classe

Riferimento

Definizione

Spazio dei nomi:: System.IO

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: PathTooLongException.cs

Source:: PathTooLongException.cs

Source:: PathTooLongException.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Exception

IOException
PathTooLongException

Ereditarietà: Object

Exception

SystemException

IOException
PathTooLongException

Attributi: SerializableAttribute ComVisibleAttribute

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