PathTooLongException Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Pengecualian yang dilemparkan ketika jalur atau nama file yang sepenuhnya memenuhi syarat lebih panjang dari panjang maksimum yang ditentukan sistem.
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
- Warisan
- Warisan
- Atribut
Keterangan
Dalam aplikasi yang berjalan di bawah versi .NET Framework sebelum .NET Framework 4.6.2, jalur lengkap tidak boleh melebihi 260 karakter untuk mempertahankan kompatibilitas dengan sistem operasi Windows. Jalur apa pun yang melebihi 260 karakter secara otomatis melempar PathTooLongException. Untuk informasi selengkapnya tentang pembatasan ini, lihat entri Jalur Panjang di .NET di blog Tim BCL.
Catatan
Pengecualian ini tidak disertakan dalam .NET untuk aplikasi Windows Store atau Pustaka Kelas Portabel, tetapi dilemparkan oleh beberapa anggota. Untuk menangkap pengecualian dalam hal ini, tulis catch
pernyataan yang menangani sebagai IOException gantinya.
Dimulai dengan aplikasi yang berjalan di bawah .NET Framework 4.6.2, .NET Framework mendukung jalur panjang lebih dari 260 karakter (atau MAX_PATH
). Kondisi di mana PathTooLongException pengecualian dilemparkan bergantung pada versi .NET Framework yang ditargetkan aplikasi:
Aplikasi yang menargetkan .NET Framework 4.6.2 dan versi yang lebih baru Jalur panjang didukung secara default. Runtime melempar PathTooLongException dalam kondisi berikut:
Sistem operasi menampilkan
COR_E_PATHTOOLONG
atau yang setara.Panjang jalur melebihi Int16.MaxValue (32.767) karakter.
Aplikasi yang menargetkan .NET Framework 4.6.1 dan versi yang lebih lama Jalur panjang dinonaktifkan secara default, dan perilaku warisan dipertahankan. Runtime melempar PathTooLongException setiap kali jalur melebihi 260 karakter.
Jika ini tidak diinginkan, aplikasi yang menargetkan .NET Framework 4.6.1 dan yang lebih lama tetapi berjalan di bawah .NET Framework 4.6.2 dapat mengaktifkan dukungan jalur panjang dengan menyertakan pengaturan berikut dalam <elemen runtime> file konfigurasi aplikasi:
<runtime>
<AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />
</runtime>
PathTooLongException menggunakan HRESULT COR_E_PATHTOOLONG
, yang memiliki nilai 0x800700CE.
Konstruktor
PathTooLongException() |
Menginisialisasi instans PathTooLongException baru kelas dengan HRESULT-nya diatur ke COR_E_PATHTOOLONG. |
PathTooLongException(SerializationInfo, StreamingContext) |
Kedaluwarsa.
Menginisialisasi instans PathTooLongException baru kelas dengan informasi serialisasi dan konteks yang ditentukan. |
PathTooLongException(String) |
Menginisialisasi instans PathTooLongException baru kelas dengan string pesannya diatur ke |
PathTooLongException(String, Exception) |
Menginisialisasi instans PathTooLongException baru kelas dengan pesan kesalahan tertentu dan referensi ke pengecualian dalam yang merupakan penyebab pengecualian ini. |
Properti
Data |
Mendapatkan kumpulan pasangan kunci/nilai yang memberikan informasi tambahan yang ditentukan pengguna tentang pengecualian. (Diperoleh dari Exception) |
HelpLink |
Mendapatkan atau mengatur tautan ke file bantuan yang terkait dengan pengecualian ini. (Diperoleh dari Exception) |
HResult |
Mendapatkan atau mengatur HRESULT, nilai numerik berkode yang ditetapkan ke pengecualian tertentu. (Diperoleh dari Exception) |
InnerException |
Mendapatkan instans Exception yang menyebabkan pengecualian saat ini. (Diperoleh dari Exception) |
Message |
Mendapatkan pesan yang menjelaskan pengecualian saat ini. (Diperoleh dari Exception) |
Source |
Get dan set nama aplikasi atau objek yang menyebabkan kesalahan. (Diperoleh dari Exception) |
StackTrace |
Mendapatkan representasi string dari bingkai langsung pada tumpukan panggilan. (Diperoleh dari Exception) |
TargetSite |
Mendapatkan metode yang melemparkan pengecualian saat ini. (Diperoleh dari Exception) |
Metode
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetBaseException() |
Ketika ditimpa di kelas turunan Exception , mengembalikan yang merupakan akar penyebab dari satu atau beberapa pengecualian berikutnya. (Diperoleh dari Exception) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetObjectData(SerializationInfo, StreamingContext) |
Kedaluwarsa.
Saat ditimpa di kelas turunan SerializationInfo , mengatur dengan informasi tentang pengecualian. (Diperoleh dari Exception) |
GetType() |
Mendapatkan jenis runtime dari instans saat ini. (Diperoleh dari Exception) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
ToString() |
Membuat dan mengembalikan representasi string dari pengecualian saat ini. (Diperoleh dari Exception) |
Acara
SerializeObjectState |
Kedaluwarsa.
Terjadi ketika pengecualian diserialisasikan untuk membuat objek status pengecualian yang berisi data berseri tentang pengecualian. (Diperoleh dari Exception) |