Aracılığıyla paylaş


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 tüm yollar 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 Mağazası 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 öğesini işleyen bir catchIOException 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 bir 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şullarda 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 çalışma zamanı> öğesine aşağıdaki ayarı< ekleyerek uzun yol desteğini etkinleştirebilir:

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

PathTooLongException değeri 0x800700CE olan HRESULT COR_E_PATHTOOLONGkullanır.

Oluşturucular

PathTooLongException()

HRESULT COR_E_PATHTOOLONG olarak ayarlanmış yeni bir sınıf örneği PathTooLongException başlatır.

PathTooLongException(SerializationInfo, StreamingContext)
Geçersiz.

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 COR_E_PATHTOOLONG olarak ayarlanmış olarak sınıfın yeni bir örneğini PathTooLongException başlatır.

PathTooLongException(String, Exception)

Belirtilen bir hata iletisi ve bu özel durumun nedeni olan iç özel duruma başvuru ile sınıfının yeni bir örneğini PathTooLongException 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

Geçerli özel duruma Exception 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)
Geçersiz.

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
Geçersiz.

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.