netcore/System.Private.CoreLib/src/System/NotImplemented.cs

   1 // Licensed to the .NET Foundation under one or more agreements.
   2 // The .NET Foundation licenses this file to you under the MIT license.
   3 // See the LICENSE file in the project root for more information.
   4
   5 namespace System
   6 {
   7     //
   8     // This simple class enables one to throw a NotImplementedException using the following
   9     // idiom:
  10     //
  11     //     throw NotImplemented.ByDesign;
  12     //
  13     // Used by methods whose intended implementation is to throw a NotImplementedException (typically
  14     // virtual methods in public abstract classes that intended to be subclassed by third parties.)
  15     //
  16     // This makes it distinguishable both from human eyes and CCI from NYI's that truly represent undone work.
  17     //
  18     internal static class NotImplemented
  19     {
  20         internal static Exception ByDesign
  21         {
  22             get
  23             {
  24                 return new NotImplementedException();
  25             }
  26         }
  27
  28         internal static Exception ByDesignWithMessage(string message)
  29         {
  30             return new NotImplementedException(message);
  31         }
  32     }
  33 }
  34