Programlama dilinde System.NotImplementedException sınıfı

Bu makale, bu API'nin başvuru belgelerine ek açıklamalar sağlar.

Ö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

Kendi türlerinizdeki özelliklerde veya yöntemlerde, o üye hâlâ geliştirme aşamasındayken ve sadece daha sonra üretim kodunda uygulanacaksa, bir NotImplementedException özel durum fırlatmayı seçebilirsiniz. Başka bir deyişle, bir NotImplementedException özel durum "hala geliştirme aşamasında" ile eş anlamlı olmalıdır.

İ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, üretim öncesi bir kitaplıkta hâlâ geliştirme aşamasında olan işlevselliği belirtmek için bir NotImplementedException özel durum kullanılmayabilir. 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.