在C#的异常处理体系中，NotImplementedException是专门用于标识方法或功能尚未实现的异常类型，属于System命名空间下的内置异常类，当程序执行到未完成的代码逻辑时抛出该异常，可以明确告知调用方当前功能暂不可用。
NotImplementedException的基本定义
NotImplementedException继承自System.Exception类，它的核心作用就是标记代码中尚未实现的功能点。当我们在开发过程中，先定义好方法签名，但是暂时没有时间或者不需要实现具体逻辑时，就可以抛出这个异常，避免方法留空导致后续调用时出现逻辑混乱。
该异常有几个常用的构造函数，开发者可以根据需要选择使用：
- 无参构造函数：创建不包含错误信息的NotImplementedException实例
- 带字符串参数的构造函数：传入自定义的错误提示信息，方便定位问题
- 带字符串和内部异常参数的构造函数：同时传递错误信息和引发当前异常的内部异常
NotImplementedException的适用场景
场景一：接口方法暂未实现
当我们实现某个接口时，部分方法暂时不需要具体逻辑，或者后续才会补充实现，这时候可以在方法体中抛出NotImplementedException，明确标识该方法未完成。
using System;
namespace ExceptionDemo
{
// 定义用户服务接口
public interface IUserService
{
// 获取用户列表
void GetUserList();
// 删除用户，暂未实现
void DeleteUser(int userId);
}
// 实现用户服务接口
public class UserService : IUserService
{
public void GetUserList()
{
Console.WriteLine("获取用户列表逻辑执行");
}
public void DeleteUser(int userId)
{
// 该方法暂未实现，抛出NotImplementedException
throw new NotImplementedException("删除用户功能尚未实现，预计下个版本上线");
}
}
}
场景二：抽象类的子类未实现父类抽象方法
虽然抽象类的抽象方法子类必须实现，但有时候我们可能先写出子类的框架，暂时不实现具体逻辑，这时候也可以在重写的方法中抛出NotImplementedException。
using System;
namespace ExceptionDemo
{
// 抽象数据访问基类
public abstract class BaseRepository
{
// 抽象查询方法
public abstract void QueryData();
}
// 用户数据访问类
public class UserRepository : BaseRepository
{
public override void QueryData()
{
// 查询逻辑暂未实现
throw new NotImplementedException("用户数据查询逻辑待补充");
}
}
}
场景三：预留的方法框架
在开发初期，我们可能会先写好整个类的所有方法框架，部分方法后续才会填充逻辑，这时候可以在这些预留方法中抛出NotImplementedException，避免方法空置导致调用时没有任何反馈。
NotImplementedException的使用注意事项
不要滥用该异常
NotImplementedException仅用于标识确实尚未实现的功能，不能用来处理其他类型的错误。比如参数校验失败、业务逻辑错误等场景，应该使用ArgumentException、InvalidOperationException等其他异常类型，不要为了省事统一抛出NotImplementedException。
及时补充实现逻辑
抛出NotImplementedException只是临时方案，在后续开发过程中，需要及时替换掉这些异常抛出逻辑，补充完整的业务代码，避免程序上线后调用到未实现的方法导致崩溃。
和其他异常的区别
很多开发者容易混淆NotImplementedException和NotSupportedException，两者的核心区别是：NotImplementedException表示方法或功能完全还没有实现；而NotSupportedException表示该方法或功能在当前场景下不支持，比如某个基类的方法在子类中不适用，就可以抛出NotSupportedException。
| 异常类型 | 适用场景 |
|---|---|
| NotImplementedException | 功能完全尚未实现，后续会补充逻辑 |
| NotSupportedException | 功能在当前场景不支持，不会补充实现 |
| InvalidOperationException | 对象状态不符合方法执行条件 |
如何处理抛出的NotImplementedException
当调用可能抛出NotImplementedException的方法时，我们可以使用try-catch块捕获该异常，根据业务需求做对应的处理，比如记录日志、提示用户功能暂不可用等。
using System;
namespace ExceptionDemo
{
class Program
{
static void Main(string[] args)
{
UserService userService = new UserService();
try
{
// 调用暂未实现的方法
userService.DeleteUser(1);
}
catch (NotImplementedException ex)
{
// 捕获异常，记录日志并提示用户
Console.WriteLine($"操作失败：{ex.Message}");
// 实际开发中这里可以替换为日志框架记录异常信息
}
}
}
}
需要注意的是，如果是在生产环境的代码中，尽量不要保留未处理的NotImplementedException，否则会导致程序意外终止，影响用户体验。如果确实有暂未实现的功能，应该在捕获异常后给出友好的提示，而不是直接让程序崩溃。
NotImplementedExceptionC#未实现方法处理异常处理修改时间：2026-07-23 07:00:22