RootCommand Class

Definition

Represents the main action that the application performs.

public ref class RootCommand : System::CommandLine::Command
public class RootCommand : System.CommandLine.Command
type RootCommand = class
    inherit Command
Public Class RootCommand
Inherits Command
Inheritance

Remarks

Use the RootCommand object without any subcommands for applications that perform one action. Add subcommands to the root for applications that require actions identified by specific strings. For example, `dir` does not use any subcommands. See Command for applications with multiple actions.

Constructors

RootCommand(String)

Properties

Aliases

Gets the set of strings that can be used on the command line to specify the symbol.

(Inherited from IdentifierSymbol)
Arguments

Represents all of the arguments for the command.

(Inherited from Command)
Children

Gets the child symbols.

(Inherited from Command)
Description

Gets or sets the description of the symbol.

(Inherited from Symbol)
ExecutableName

The name of the currently running executable.

ExecutablePath

The path to the currently running executable.

Handler

Gets or sets the ICommandHandler for the command. The handler represents the action that will be performed when the command is invoked.

(Inherited from Command)
IsHidden

Gets or sets a value indicating whether the symbol is hidden.

(Inherited from Symbol)
Name

Gets or sets the symbol name.

(Inherited from IdentifierSymbol)
Options

Represents all of the options for the command, including global options that have been applied to any of the command's ancestors.

(Inherited from Command)
Parents

Gets the parent symbols.

(Inherited from Symbol)
Subcommands

Represents all of the subcommands for the command.

(Inherited from Command)
TreatUnmatchedTokensAsErrors

Gets or sets a value that indicates whether unmatched tokens should be treated as errors. For example, if set to true and an extra command or argument is provided, validation will fail.

(Inherited from Command)

Methods

Add(Argument)

Adds an Argument to the command.

(Inherited from Command)
Add(Command)

Adds a subcommand to the command.

(Inherited from Command)
Add(Option)

Adds an Option to the command.

(Inherited from Command)
AddAlias(String)

Adds an alias.

(Inherited from IdentifierSymbol)
AddArgument(Argument)

Adds an Argument to the command.

(Inherited from Command)
AddCommand(Command)

Adds a subcommand to the command.

(Inherited from Command)
AddGlobalOption(Option)

Adds a global Option to the command.

(Inherited from Command)
AddOption(Option)

Adds an Option to the command.

(Inherited from Command)
AddValidator(ValidateSymbolResult<CommandResult>)

Adds a custom validator to the command. Validators can be used to create custom validation logic.

(Inherited from Command)
Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCompletions()

Gets completions for the symbol.

(Inherited from Symbol)
GetCompletions(CompletionContext)

Gets the suggested values for command line completion.

(Inherited from Command)
GetEnumerator()

Gets an enumerator that represents all of the symbols for the command.

(Inherited from Command)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
HasAlias(String)

Determines whether the alias has already been defined.

(Inherited from IdentifierSymbol)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that represents the current object.

(Inherited from Symbol)

Explicit Interface Implementations

IEnumerable.GetEnumerator()

Returns an enumerator that iterates through a collection.

(Inherited from Command)

Extension Methods

Invoke(Command, String, IConsole)

Parses and invokes a command.

Invoke(Command, String[], IConsole)

Parses and invokes a command.

InvokeAsync(Command, String, IConsole)

Parses and invokes a command.

InvokeAsync(Command, String[], IConsole)

Parses and invokes a command.

Parse(Command, String)

Parses a command line string value using the specified command.

Parse(Command, String[])

Parses an array strings using the specified command.

SetHandler(Command, Action)

Sets a command's handler based on an Action.

SetHandler(Command, Func<Task>)

Sets a command's handler based on a Func<TResult>.

SetHandler<T>(Command, Action<T>, IValueDescriptor[])

Sets a command's handler based on an Action<T>.

SetHandler<T>(Command, Func<T,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10>(Command, Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10>(Command, Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11>(Command, Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11>(Command, Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12>(Command, Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12>(Command, Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13>(Command, Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13>(Command, Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14>(Command, Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14>(Command, Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15>(Command, Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15>(Command, Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15, T16>(Command, Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13, T14,T15,T16>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15, T16>(Command, Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13, T14,T15,T16,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,TResult>.

SetHandler<T1,T2>(Command, Action<T1,T2>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2>.

SetHandler<T1,T2>(Command, Func<T1,T2,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,TResult>.

SetHandler<T1,T2,T3>(Command, Action<T1,T2,T3>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3>.

SetHandler<T1,T2,T3>(Command, Func<T1,T2,T3,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,TResult>.

SetHandler<T1,T2,T3,T4>(Command, Action<T1,T2,T3,T4>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4>.

SetHandler<T1,T2,T3,T4>(Command, Func<T1,T2,T3,T4,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,TResult>.

SetHandler<T1,T2,T3,T4,T5>(Command, Action<T1,T2,T3,T4,T5>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5>.

SetHandler<T1,T2,T3,T4,T5>(Command, Func<T1,T2,T3,T4,T5,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6>(Command, Action<T1,T2,T3,T4,T5,T6>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6>.

SetHandler<T1,T2,T3,T4,T5,T6>(Command, Func<T1,T2,T3,T4,T5,T6,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7>(Command, Action<T1,T2,T3,T4,T5,T6,T7>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7>.

SetHandler<T1,T2,T3,T4,T5,T6,T7>(Command, Func<T1,T2,T3,T4,T5,T6,T7,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8>(Command, Action<T1,T2,T3,T4,T5,T6,T7,T8>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7,T8>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8>(Command, Func<T1,T2,T3,T4,T5,T6,T7,T8,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,T8,TResult>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9>(Command, Action<T1,T2,T3,T4,T5,T6,T7,T8,T9>, IValueDescriptor[])

Sets a command's handler based on an Action<T1,T2,T3,T4,T5,T6,T7,T8,T9>.

SetHandler<T1,T2,T3,T4,T5,T6,T7,T8,T9>(Command, Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,Task>, IValueDescriptor[])

Sets a command's handler based on a Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,TResult>.

Applies to