PathTooLongException Sınıf

Başvuru

Tanım

Ad Alanı:: System.IO

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Kaynak:: PathTooLongException.cs

Kaynak:: PathTooLongException.cs

Kaynak:: PathTooLongException.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Exception

IOException
PathTooLongException

Devralma: Object

Exception

SystemException

IOException
PathTooLongException

Öznitelikler: SerializableAttribute ComVisibleAttribute

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