PathTooLongException Sınıf

Tanım

Bir yol veya tam dosya adı sistem tarafından tanımlanan uzunluk üst sınırından daha uzun olduğunda oluşan özel durum.

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
Devralma
PathTooLongException
Devralma
Öznitelikler

Açıklamalar

.NET Framework 4.6.2'den önceki .NET Framework sürümleri altında çalışan uygulamalarda, Windows işletim sistemleriyle uyumluluğu korumak için tam yolların 260 karakteri aşmaması gerekir. 260 karakterden fazla olan herhangi bir yol otomatik olarak bir PathTooLongExceptionoluşturur. Bu kısıtlama hakkında daha fazla bilgi için BCL Ekibi blogunda .NET'te Uzun Yollar girdisine bakın.

Not

Bu özel durum Windows Store uygulamaları veya Taşınabilir Sınıf Kitaplığı için .NET'e dahil değildir, ancak bazı üyeler tarafından oluşturulur. Bu durumda özel durumu yakalamak için bunun yerine işleyen bir catch IOException deyim yazın.

.NET Framework 4.6.2 altında çalışan uygulamalardan başlayarak, .NET Framework 260 (veya MAX_PATH) karakterden uzun yolları destekler. Özel durumun oluşturulduğu koşullar, PathTooLongException uygulamanın hedeflediği .NET Framework sürümüne bağlıdır:

.NET Framework 4.6.2 ve sonraki sürümleri hedefleyen uygulamalar
Uzun yollar varsayılan olarak desteklenir. Çalışma zamanı aşağıdaki koşullar altında bir PathTooLongException oluşturur:

  • İşletim sistemi veya eşdeğerini döndürür COR_E_PATHTOOLONG .

  • Yolun uzunluğu (32.767) karakteri aşıyor Int16.MaxValue .

.NET Framework 4.6.1 ve önceki sürümleri hedefleyen uygulamalar
Uzun yollar varsayılan olarak devre dışı bırakılır ve eski davranış korunur. Bir yol 260 karakteri aştığında çalışma zamanı bir PathTooLongException oluşturur.

Bu istenmeyen bir durumsa, .NET Framework 4.6.1 ve önceki sürümleri hedefleyen ancak .NET Framework 4.6.2 altında çalışan uygulamalar, uygulama yapılandırma dosyasının öğesine aşağıdaki ayarı <runtime> ekleyerek uzun yol desteğini etkinleştirebilir:

<runtime>   
   <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />   
</runtime>  

PathTooLongException , 0x800700CE değerine sahip HRESULT COR_E_PATHTOOLONGkullanır.

Oluşturucular

PathTooLongException()

HRESULT değerinin PathTooLongException COR_E_PATHTOOLONG olarak ayarlandığı sınıfının yeni bir örneğini başlatır.

PathTooLongException(SerializationInfo, StreamingContext)

Belirtilen serileştirme ve bağlam bilgileriyle sınıfının yeni bir örneğini PathTooLongException başlatır.

PathTooLongException(String)

İleti dizesi olarak ve message HRESULT değerinin PathTooLongException COR_E_PATHTOOLONG olarak ayarlanmasıyla sınıfının yeni bir örneğini başlatır.

PathTooLongException(String, Exception)

Sınıfın PathTooLongException yeni bir örneğini belirtilen bir hata iletisiyle ve bu özel durumun nedeni olan iç özel duruma başvuruyla başlatır.

Özellikler

Data

Özel durum hakkında kullanıcı tanımlı ek bilgiler sağlayan bir anahtar/değer çifti koleksiyonu alır.

(Devralındığı yer: Exception)
HelpLink

Bu özel durumla ilişkili yardım dosyasının bağlantısını alır veya ayarlar.

(Devralındığı yer: Exception)
HResult

Belirli bir özel duruma atanan kodlanmış sayısal bir değer olan HRESULT değerini alır veya ayarlar.

(Devralındığı yer: Exception)
InnerException

Exception Geçerli özel duruma neden olan örneği alır.

(Devralındığı yer: Exception)
Message

Geçerli özel durumu açıklayan bir ileti alır.

(Devralındığı yer: Exception)
Source

Hataya neden olan uygulamanın veya nesnenin adını alır veya ayarlar.

(Devralındığı yer: Exception)
StackTrace

Çağrı yığınındaki anlık çerçevelerin dize gösterimini alır.

(Devralındığı yer: Exception)
TargetSite

Geçerli özel durumu oluşturan yöntemini alır.

(Devralındığı yer: Exception)

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetBaseException()

Türetilmiş bir sınıfta geçersiz kılındığında, sonraki bir veya daha fazla özel durumun kök nedeni olan değerini döndürür Exception .

(Devralındığı yer: Exception)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)

Türetilmiş bir sınıfta geçersiz kılındığında, özel durum hakkındaki bilgilerle öğesini ayarlar SerializationInfo .

(Devralındığı yer: Exception)
GetType()

Geçerli örneğin çalışma zamanı türünü alır.

(Devralındığı yer: Exception)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli özel durumun dize gösterimini oluşturur ve döndürür.

(Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState
Kullanımdan kalktı.

Bir özel durum, özel durum hakkında serileştirilmiş veriler içeren bir özel durum nesnesi oluşturmak üzere seri hale getirildiğinde gerçekleşir.

(Devralındığı yer: Exception)

Şunlara uygulanır

Ayrıca bkz.