PathTooLongException Kelas

Referensi

Definisi

Ruang nama:: System.IO

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Sumber:: PathTooLongException.cs

Sumber:: PathTooLongException.cs

Sumber:: PathTooLongException.cs

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

Exception

IOException
PathTooLongException

Warisan: Object

Exception

SystemException

IOException
PathTooLongException

Atribut: SerializableAttribute ComVisibleAttribute

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 `message` dan HRESULT-nya diatur ke COR_E_PATHTOOLONG.
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)

Berlaku untuk