NotImplementedException Třída

Definice

Výjimka, která je vyvolána, když není implementována požadovaná metoda nebo operace.The exception that is thrown when a requested method or operation is not implemented.

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
Dědičnost
NotImplementedException
Dědičnost
NotImplementedException
Atributy

Příklady

Následující příklad vyvolá tuto výjimku pro metodu, která nebyla vyvinuta.The following example throws this exception for a method that has not been developed.

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

Poznámky

NotImplementedExceptionVýjimka je vyvolána, když je k dispozici konkrétní metoda, přístupový objekt get nebo přístupový objekt set jako člen typu, ale není implementován.The NotImplementedException exception is thrown when a particular method, get accessor, or set accessor is present as a member of a type but is not implemented.

NotImplementedException používá výchozí Object.Equals implementaci, která podporuje rovnost odkazů.NotImplementedException uses the default Object.Equals implementation, which supports reference equality. Seznam počátečních hodnot instance třídy NotImplementedException naleznete v tématu NotImplementedException konstruktory.For a list of initial values for an instance of NotImplementedException, see the NotImplementedException constructors.

Vyvolání výjimkyThrowing the exception

NotImplementedExceptionPokud je tento člen stále ve vývoji a bude později implementován pouze v produkčním kódu, můžete se rozhodnout vyvolat výjimku ve vlastnostech nebo metodách ve vlastních typech.You might choose to throw a NotImplementedException exception in properties or methods in your own types when the that member is still in development and will only later be implemented in production code. Jinými slovy, NotImplementedException výjimka by měla být synonymem "stále probíhá vývoj".In other words, a NotImplementedException exception should be synonymous with "still in development."

Zpracovává se výjimka.Handling the exception

NotImplementedExceptionVýjimka označuje, že metoda nebo vlastnost, kterou se pokoušíte vyvolat, nemá žádnou implementaci a proto neposkytuje žádné funkce.The NotImplementedException exception indicates that the method or property that you are attempting to invoke has no implementation and therefore provides no functionality. V důsledku toho byste tuto chybu neměli zpracovávat v try/catch bloku.As a result, you should not handle this error in a try/catch block. Místo toho byste měli odebrat vyvolání členů z kódu.Instead, you should remove the member invocation from your code. Můžete zahrnout volání členu, když je implementováno v produkční verzi knihovny.You can include a call to the member when it is implemented in the production version of a library.

V některých případech se NotImplementedException výjimka nedá použít k označení funkcí, které jsou stále ve vývoji v předprodukční knihovně.In some cases, a NotImplementedException exception may not be used to indicate functionality that is still in development in a pre-production library. To však stále znamená, že funkce není k dispozici a měli byste odebrat vyvolání členů z kódu.However, this still indicates that the functionality is unavailable, and you should remove the member invocation from your code.

NotImplementedException a jiné typy výjimekNotImplementedException and other exception types

.NET Framework také obsahuje dva další typy výjimek NotSupportedException a PlatformNotSupportedException , které označují, že pro konkrétního člena typu neexistuje žádná implementace.The .NET Framework also includes two other exception types, NotSupportedException and PlatformNotSupportedException, that indicate that no implementation exists for a particular member of a type. V následujících podmínkách byste měli vyvolat jednu z těchto NotImplementedException možností místo výjimky.You should throw one of these instead of a NotImplementedException exception under the following conditions.

PlatformNotSupportedException jímkaPlatformNotSupportedException exception
Pokud jste navrhli typ s jedním nebo více členy, kteří jsou k dispozici na některých platformách nebo v některých verzích, ale ne v jiných, můžete tuto výjimku vyvolat na platformách, na kterých není tato funkce podporovaná.If you've designed a type with one or more members that are available on some platforms or in some versions but not on others, you can throw this exception on platforms on which the functionality is not supported.

NotSupportedException jímkaNotSupportedException exception
Vyvolejte NotSupportedException výjimku, pokud není možné implementovat člen rozhraní nebo přepsání metody abstraktní základní třídy.Throw a NotSupportedException exception if the implementation of an interface member or an override to an abstract base class method is not possible. Například Convert.ToInt32(DateTime) metoda vyvolá NotSupportedException výjimku, protože neexistuje smysluplný převod mezi datem a časem a nepodepsaným celým číslem 32.For example, the Convert.ToInt32(DateTime) method throws a NotSupportedException exception because no meaningful conversion between a date and time and a 32-bit signed integer exists. V tomto případě musí být metoda přítomna, protože Convert Třída implementuje IConvertible rozhraní.The method must be present in this case because the Convert class implements the IConvertible interface.

Výjimku byste měli vyvolat také v případě, že jste NotSupportedException implementovali abstraktní základní třídu a přidáte do ní nového člena, který musí být přepsán odvozenými třídami.You should also throw a NotSupportedException exception if you've implemented an abstract base class and add a new member to it that must be overridden by derived classes. V takovém případě by abstrakce členů způsobila, že se nepodaří načíst existující podtřídy.In that case, making the member abstract causes existing subclasses to fail to load.

Konstruktory

NotImplementedException()

Inicializuje novou instanci NotImplementedException třídy s výchozími vlastnostmi.Initializes a new instance of the NotImplementedException class with default properties.

NotImplementedException(SerializationInfo, StreamingContext)

Inicializuje novou instanci třídy NotImplementedException se serializovanými daty.Initializes a new instance of the NotImplementedException class with serialized data.

NotImplementedException(String)

Inicializuje novou instanci NotImplementedException třídy se zadanou chybovou zprávou.Initializes a new instance of the NotImplementedException class with a specified error message.

NotImplementedException(String, Exception)

Inicializuje novou instanci NotImplementedException třídy se zadanou chybovou zprávou a odkazem na vnitřní výjimku, která je příčinou této výjimky.Initializes a new instance of the NotImplementedException class with a specified error message and a reference to the inner exception that is the cause of this exception.

Vlastnosti

Data

Získá kolekci párů klíč/hodnota, které poskytují další uživatelsky definované informace o výjimce.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Zděděno od Exception)
HelpLink

Získá nebo nastaví odkaz na soubor s nápovědě spojený s touto výjimkou.Gets or sets a link to the help file associated with this exception.

(Zděděno od Exception)
HResult

Získá nebo nastaví hodnotu HRESULT, kódované číselné hodnoty, která je přiřazena konkrétní výjimce.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Zděděno od Exception)
InnerException

Získá Exception instanci, která způsobila aktuální výjimku.Gets the Exception instance that caused the current exception.

(Zděděno od Exception)
Message

Získá zprávu s popisem aktuální výjimky.Gets a message that describes the current exception.

(Zděděno od Exception)
Source

Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu.Gets or sets the name of the application or the object that causes the error.

(Zděděno od Exception)
StackTrace

Načte řetězcovou reprezentaci okamžitých snímků v zásobníku volání.Gets a string representation of the immediate frames on the call stack.

(Zděděno od Exception)
TargetSite

Získá metodu, která vyvolá aktuální výjimku.Gets the method that throws the current exception.

(Zděděno od Exception)

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetBaseException()

Při přepsání v odvozené třídě vrátí hodnotu Exception , která je hlavní příčinou jedné nebo více následných výjimek.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Zděděno od Exception)
GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)

Při přepsání v odvozené třídě nastaví na SerializationInfo výjimku informace o výjimce.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Zděděno od Exception)
GetType()

Získá typ modulu runtime aktuální instance.Gets the runtime type of the current instance.

(Zděděno od Exception)
MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
ToString()

Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky.Creates and returns a string representation of the current exception.

(Zděděno od Exception)

Události

SerializeObjectState

Nastane, pokud je serializovaná výjimka pro vytvoření objektu stavu výjimky, který obsahuje Serializovaná data o výjimce.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Zděděno od Exception)

Platí pro

Viz také