NotImplementedException Sınıf

Tanım

İstenen yöntem veya işlem uygulanmadığında oluşan özel durum.

public ref class NotImplementedException : Exception
public ref class NotImplementedException : SystemException
public class NotImplementedException : Exception
public class NotImplementedException : SystemException
[System.Serializable]
public class NotImplementedException : SystemException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class NotImplementedException : SystemException
type NotImplementedException = class
    inherit Exception
type NotImplementedException = class
    inherit SystemException
[<System.Serializable>]
type NotImplementedException = class
    inherit SystemException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type NotImplementedException = class
    inherit SystemException
Public Class NotImplementedException
Inherits Exception
Public Class NotImplementedException
Inherits SystemException
Devralma
NotImplementedException
Devralma
NotImplementedException
Öznitelikler

Örnekler

Aşağıdaki örnek, geliştirilmemiş bir yöntem için bu özel durumu oluşturur.

static void Main(string[] args)
{
    try
    {
        FutureFeature();
    }
    catch (NotImplementedException notImp)
    {
        Console.WriteLine(notImp.Message);
    }
}

static void FutureFeature()
{
    // Not developed yet.
    throw new NotImplementedException();
}
open System

let futureFeature () =
    // Not developed yet.
    raise (NotImplementedException())

[<EntryPoint>]
let main _ =
    try
        futureFeature ()
    with :? NotImplementedException as notImp ->
        printfn $"{notImp.Message}"
    0
Sub Main()
    Try
        FutureFeature()
    Catch NotImp As NotImplementedException
        Console.WriteLine(NotImp.Message)
    End Try


End Sub

Sub FutureFeature()
    ' not developed yet.
    Throw New NotImplementedException()
End Sub

Açıklamalar

Özel NotImplementedException durum, belirli bir yöntem, alma erişimcisi veya ayar erişimcisi bir türün üyesi olarak mevcut olduğunda ancak uygulanmadığında oluşturulur.

NotImplementedException başvuru eşitliğini destekleyen varsayılan Object.Equals uygulamayı kullanır. örneğinin başlangıç değerlerinin NotImplementedExceptionlistesi için oluşturuculara NotImplementedException bakın.

Özel durum oluşturma

Bu üye hala geliştirme aşamasındayken ve yalnızca daha sonra üretim kodunda uygulanacaksa, kendi türlerinizdeki özelliklerde veya yöntemlerde özel NotImplementedException durum oluşturmayı seçebilirsiniz. Başka bir deyişle, bir NotImplementedException özel durum "hala geliştirme aşamasında" ile eş anlamlı olmalıdır.

Özel durumu işleme

Özel NotImplementedException durum, çağırmaya çalıştığınız yöntemin veya özelliğin uygulaması olmadığını ve bu nedenle herhangi bir işlev sağlamadığını gösterir. Sonuç olarak, bu hatayı bir try/catch blokta işlememelisiniz. Bunun yerine, üye çağrısını kodunuzdan kaldırmanız gerekir. Bir kitaplığın üretim sürümünde uygulandığında üyeye çağrı ekleyebilirsiniz.

Bazı durumlarda, üretim NotImplementedException öncesi kitaplıkta hala geliştirme aşamasında olan işlevselliği göstermek için özel durum kullanılamayabilir. Ancak, bu yine de işlevselliğin kullanılamadığını gösterir ve üye çağrısını kodunuzdan kaldırmanız gerekir.

NotImplementedException ve diğer özel durum türleri

.NET Framework ayrıca, NotSupportedException PlatformNotSupportedExceptionbir türün belirli bir üyesi için hiçbir uygulamanın mevcut olmadığını belirten iki özel durum türü daha içerir. Aşağıdaki koşullarda özel NotImplementedException durum yerine bunlardan birini oluşturmalısınız.

PlatformNotSupportedException Özel durum
Bazı platformlarda veya bazı sürümlerde kullanılabilen ancak bazı sürümlerde bulunmayan bir veya daha fazla üyeye sahip bir tür tasarladıysanız, bu özel durumu işlevselliğin desteklenmediği platformlarda oluşturabilirsiniz.

NotSupportedException Özel durum
NotSupportedException Bir arabirim üyesinin veya soyut bir temel sınıf yöntemine geçersiz kılmanın uygulanması mümkün değilse bir özel durum oluşturun. Örneğin, Convert.ToInt32(DateTime) bir tarih ve saat ile 32 bit imzalı tamsayı NotSupportedException arasında anlamlı bir dönüştürme olmadığından yöntemi bir özel durum oluşturur. sınıfı arabirimini uyguladığından bu durumda yönteminin Convert IConvertible mevcut olması gerekir.

Ayrıca soyut bir NotSupportedException temel sınıf uyguladıysanız ve türetilmiş sınıflar tarafından geçersiz kılınması gereken yeni bir üye eklediyseniz bir özel durum oluşturmanız gerekir. Bu durumda, üyenin soyut hale getirilmesi mevcut alt sınıfların yüklenememesine neden olur.

Oluşturucular

NotImplementedException()

Sınıfın NotImplementedException yeni bir örneğini varsayılan özelliklerle başlatır.

NotImplementedException(SerializationInfo, StreamingContext)

NotImplementedException sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.

NotImplementedException(String)

Belirtilen hata iletisiyle sınıfının yeni bir örneğini NotImplementedException başlatır.

NotImplementedException(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 NotImplementedException 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.