NotImplementedException Sınıf

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

NotImplementedException.cs

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

public ref class NotImplementedException : SystemException

public class NotImplementedException : SystemException

type NotImplementedException = class
    inherit SystemException

Public Class NotImplementedException
Inherits SystemException

Devralma

Object

Exception

SystemException

NotImplementedException

Ö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 küme 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 uygulamasını kullanır. örneğin başlangıç değerlerinin bir listesi için NotImplementedException'a bakın, NotImplementedException oluşturucuya başvurun.

İstisnayı fırlat

Bir üye hala geliştirme aşamasındayken ve yalnızca üretim kodunda daha sonra uygulanırken kendi türlerinizdeki özelliklerde veya yöntemlerde özel durum oluşturmayı NotImplementedException seçebilirsiniz.

İstisnayı ele al

Özel NotImplementedException durum, çağırmaya çalıştığınız yöntemin veya özelliğin hiçbir uygulaması olmadığını ve bu nedenle hiç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, bir ön üretim kitaplığında hala geliştirme aşamasında olan işlevselliği göstermek için bir NotImplementedException ö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 ayrıca, NotSupportedExceptionPlatformNotSupportedExceptionbir türün belirli bir üyesi için hiçbir uygulamanın mevcut olmadığını gösteren iki özel durum türü daha içerir. Aşağıdaki koşullarda NotImplementedException istisnası yerine bunlardan birini atmalısınız:

• PlatformNotSupportedException Bazı platformlarda veya sürümlerde mevcut olup diğerlerinde bulunmayan bir veya daha fazla üyeye sahip bir tür tasarladıysanız, işlevselliğin desteklenmediği platformlarda bir özel durum oluşturun.

• NotSupportedException Bir arabirim üyesinin uygulanması veya soyut bir temel sınıf yöntemine geçersiz kılma mümkün değilse bir istisna fırlatın.

  Örneğin, Convert.ToInt32(DateTime) yöntemi, bir tarih ve saat ile 32 bit imzalı tamsayı arasında anlamlı bir dönüştürme olmadığından NotSupportedException özel durumunu fırlatır. Bu durumda Convert sınıfı IConvertible arabirimini uyguladığı için yöntem mevcut olmalıdır.

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şturmalısınız. Bu durumda, üye soyut yapmak mevcut alt sınıfların yüklenememesine neden olur.

Oluşturucular

Name	Description
NotImplementedException()	Sınıfın NotImplementedException yeni bir örneğini varsayılan özelliklerle başlatır.
NotImplementedException(SerializationInfo, StreamingContext)	Geçersiz. Serileştirilmiş verilerle NotImplementedException sınıfının yeni bir örneğini başlatır.
NotImplementedException(String, Exception)	Belirtilen bir hata iletisi ve bu özel durumun nedeni olan iç özel duruma başvuru ile NotImplementedException sınıfının yeni bir örneğini başlatır.
NotImplementedException(String)	Belirtilen bir hata iletisiyle sınıfının yeni bir örneğini NotImplementedException başlatır.

Özellikler

Name	Description
Data	Özel durum hakkında kullanıcı tanımlı ek bilgiler sağlayan anahtar/değer çiftleri koleksiyonunu 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 neden olan Exception örneğini 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

Name	Description
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 Exception döndürür. (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 durumla ilgili bilgilerle SerializationInfo ayarlar. (Devralındığı yer: Exception)
GetType()	Geçerli örneğin çalışma zamanı türünü alır. (Devralındığı yer: Exception)
MemberwiseClone()	Geçerli Objectbasit 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

Name	Description
SerializeObjectState	Geçersiz. Özel durum hakkında serileştirilmiş veriler içeren bir özel durum durumu nesnesi oluşturmak için bir özel durum seri hale getirildiğinde gerçekleşir. (Devralındığı yer: Exception)

Ayrıca bkz.

• Exception
• NotSupportedException