PathTooLongException Classe
Definizione
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::IOExceptionpublic 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.IOExceptiontype PathTooLongException = class
inherit IOException[<System.Serializable>]
type PathTooLongException = class
inherit IOException[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type PathTooLongException = class
inherit IOExceptionPublic Class PathTooLongException
Inherits IOException- Ereditarietà
- 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_PATHTOOLONGo 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 |
| 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) |
