NotImplementedException Класс

Определение

Это исключение выбрасывается, когда запрошенный метод или операция не реализованы.

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
Наследование
NotImplementedException
Наследование
NotImplementedException
Атрибуты

Примеры

В следующем примере это исключение создается для метода, который не был разработан.

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

static void FutureFeature()
{
    // Not developed yet.
    throw new NotImplementedException();
}
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

Комментарии

NotImplementedExceptionИсключение возникает, когда конкретный метод, метод доступа get или метод доступа set имеются в качестве члена типа, но не реализованы.

NotImplementedException использует реализацию по умолчанию Object.Equals , которая поддерживает равенство ссылок. Список начальных значений для экземпляра NotImplementedException см. в разделе NotImplementedException конструкторы.

Создание исключения

Вы можете создать NotImplementedException исключение в свойствах или методах в собственных типах, когда этот элемент все еще разрабатывается и будет реализован в рабочем коде только позднее. Иными словами, NotImplementedException исключение должно быть синонимом «все еще в разработке».

Обработка исключения

NotImplementedExceptionИсключение указывает, что метод или свойство, которое вы пытаетесь вызвать, не имеет реализации и, следовательно, не предоставляет никаких функциональных возможностей. Поэтому не следует обрабатывайте эту ошибку в try/catch блоке. Вместо этого следует удалить вызов члена из кода. При реализации в рабочей версии библиотеки можно включить вызов члена.

В некоторых случаях NotImplementedException исключение может не использоваться для указания функций, которые все еще разрабатывается в подготовительной библиотеке. Однако это по-прежнему означает, что функциональность недоступна, и необходимо удалить вызов члена из кода.

NotImplementedException и другие типы исключений

платформа .NET Framework также содержит два других типа исключений, NotSupportedException и PlatformNotSupportedException , которые указывают на отсутствие реализации для конкретного элемента типа. При следующих условиях следует вызывать одно из них вместо NotImplementedException исключения.

PlatformNotSupportedException об
Если вы разработали тип с одним или несколькими элементами, доступными на некоторых платформах или в некоторых версиях, но не на других, это исключение можно создать на платформах, на которых эта функция не поддерживается.

NotSupportedException об
Исключение, NotSupportedException Если реализация члена интерфейса или переопределения в абстрактный метод базового класса невозможна. Например, Convert.ToInt32(DateTime) метод вызывает NotSupportedException исключение, так как не существует осмысленного преобразования между датой и временем и 32-разрядным целым числом со знаком. В этом случае метод должен присутствовать, поскольку Convert класс реализует IConvertible интерфейс.

NotSupportedExceptionЕсли вы реализовали абстрактный базовый класс и добавили в него новый элемент, который должен быть переопределен производными классами, следует также создать исключение. В этом случае создание абстрактного элемента приводит к сбою загрузки существующих подклассов.

Конструкторы

NotImplementedException()

Инициализирует новый экземпляр класса NotImplementedException стандартными свойствами.

NotImplementedException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса NotImplementedException с сериализованными данными.

NotImplementedException(String)

Инициализирует новый экземпляр класса NotImplementedException с указанным сообщением об ошибке.

NotImplementedException(String, Exception)

Инициализирует новый экземпляр класса NotImplementedException указанным сообщением об ошибке и ссылкой на внутреннее исключение, вызвавшее данное исключение.

Свойства

Data

Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении.

(Унаследовано от Exception)
HelpLink

Получает или задает ссылку на файл справки, связанный с этим исключением.

(Унаследовано от Exception)
HResult

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.

(Унаследовано от Exception)
InnerException

Возвращает экземпляр класса Exception, который вызвал текущее исключение.

(Унаследовано от Exception)
Message

Возвращает сообщение, описывающее текущее исключение.

(Унаследовано от Exception)
Source

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.

(Унаследовано от Exception)
StackTrace

Получает строковое представление непосредственных кадров в стеке вызова.

(Унаследовано от Exception)
TargetSite

Возвращает метод, создавший текущее исключение.

(Унаследовано от Exception)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetBaseException()

При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений.

(Унаследовано от Exception)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)

При переопределении в производном классе задает объект SerializationInfo со сведениями об исключении.

(Унаследовано от Exception)
GetType()

Возвращает тип среды выполнения текущего экземпляра.

(Унаследовано от Exception)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Создает и возвращает строковое представление текущего исключения.

(Унаследовано от Exception)

События

SerializeObjectState
Является устаревшей.

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.

(Унаследовано от Exception)

Применяется к

См. также раздел