namespace MyConsoleApp
{
 /// <summary>
 /// InputArgsSimple.cs
 /// Defines the parameters we expect at the command line.
 /// Here is a simple class that define two optional parameters.
 /// First is a bool named Flag and second is a string named Name.
 /// The command line to set these fields could be:
 /// MyCmd -Flag -Name John
 /// MyCmd -Fl:true -Nam:John
 /// MyCmd -n John -f:F
 ///
 /// Note: When using Named parameters, the order is not important.
 /// We can also seperate the parm name from the value using a space or ":".
 /// If a parameter is not given, the default value after construction is the
 /// value (i.e. not changed.)  Only need to supply enouph chars in parm names
 /// to disambiguate from other parms.
 /// </summary>
 [CmdHelp("Simple console app.", "This is a simple console app to demo CmdParser.", "www.mysite.com", "Copyright (c) 2005 MyOrg", null)]
 public class InputArgsSimple
 {
  [ParameterHelp("Starts app in windows mode.", "Start the program in windows mode.")]
  public bool W;

  [ParameterHelp("Name of user to find.", "The name of the user to find.")]
  public string Name;
  
  public InputArgsSimple()
  {
  }
 }
}

// Main console class.
using System;
using CmdParser;
using System.Reflection;
using System.Collections;

namespace MyConsoleApp
{
 class Class1
 {
  /// <summary>
  /// The main entry point for the application.
  /// </summary>
  [STAThread]
  static void Main(string[] args)
  {
   InputArgsSimple inArgs = new InputArgsSimple();
   try
   {
    Parameters parms = Parameters.CreateParameters(inArgs, args);

    if ( parms.IsHelpNeeded )
    {
     string helpString = "";
     switch(parms.HelpChars)
     {
      case "?":
       helpString = parms.GetUsageString(Assembly.GetExecutingAssembly());
       Console.WriteLine("\nUsage:");
       Console.WriteLine(helpString);
       Console.WriteLine("Note: For detailed help, use -??, -h, or -help.");
       break;
      case "h":
      case "help":
      case "??":
       helpString = parms.GetDetailedHelp(Assembly.GetExecutingAssembly());
       Console.WriteLine();
       Console.WriteLine(helpString);
       break;
     }
     return;
    }

    if ( parms.IsVersionNeeded )
    {
     Assembly assem = Assembly.GetExecutingAssembly();
     string ver = assem.GetName().Version.ToString();
     Console.WriteLine("Version: " + ver);
     return;
    }

    if ( parms.BeenSetCount == 0 )
    {
     // No parameters set at commandline, so display help.
     // This could mean something else to your program.
     string helpString = parms.GetUsageString(Assembly.GetExecutingAssembly());
     Console.WriteLine("\nUsage:");
     Console.WriteLine(helpString);
     Console.WriteLine("Note: For detailed help, use -??, -h, or -help.");
     return;
    }

    // Just testing, so show the parms we set.
    Console.WriteLine("\n\nParms:");
    ParameterSet pSet = parms.ActiveSet;
    foreach(Parameter p in pSet.Parameters)
    {
     string val = (p.Value == null) ? "Null" : p.Value.ToString();
     Console.WriteLine("{0}: {1}", p.Name, val);
    }
   }
   catch(Exception ex)
   {
    Console.WriteLine(ex.Message);
   }
  }
 }
}

As we defined some help, we can get automatic Usage and Help.  Usage looks like so:
V:\MyConsoleApp\bin\Debug>myconsoleapp -?

Usage:
MyConsoleApp [-W boolean] [-Name string]

Parameters:
W         - Starts app in windows mode.
Name      - Name of user to find.

Note: For detailed help, use -??, -h, or -help.


Detailed help would look like:
V:\MyConsoleApp\bin\Debug>myconsoleapp -??

MyConsoleApp Help
======================================================================
Copyright (c) 2005 MyOrg
Web Site: www.mysite.com
Version : 1.0.1920.24820
This is a simple console app to demo CmdParser.

Parameters
----------------------------------------------------------------------
-W
[Boolean]
[Mappings=(Default:-1)]
Start the program in windows mode.

-Name
[String]
[Mappings=(Default:-1)]

Naturally, you could build your own help if required.
Would really appreciate any feedback on issues, new features, likes/dislikes, etc.

Version History
-------------------
1/9/2005 - v1.5 Updated to include SendMail sample client project using the CmdParser library.  Added CmdParser.Doc.


--William Stacey[MVP]