Bagikan melalui


PathTooLongException Kelas

Definisi

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
PathTooLongException
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 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

Lihat juga