CommandParameter

Wraps a ParameterInfo from a command method, providing type metadata and string-to-value conversion via CommandParameterParser.

Definition

Namespace: Paragon.Core.Command Assembly: Paragon.dll

public class CommandParameter

Remarks

CommandParameter instances are created by CommandMethod during construction. Each wraps a single method parameter and provides:

• Type metadata — The parameter's Type and Name

• String parsing — SetValueFromString() delegates to CommandParameterParser.Parse() to convert a string input to the parameter's expected type

• Value storage — The parsed value is stored in Value for later use during invocation

The constructor is private. Instances are created via the static Create() factory method.

Quick Lookup

Goal	How
Create from ParameterInfo	CommandParameter.Create(parameterInfo)
Parse a string value	parameter.SetValueFromString("42")
Read the parsed value	parameter.Value
Get parameter type	parameter.Type
Get parameter name	parameter.Name

Properties

Type

public Type Type { get; }

The CLR type of the parameter (e.g., typeof(int), typeof(string)).

Name

public string Name { get; }

The parameter name as declared in the method signature.

Value

public object Value { get; }

The parsed value after calling SetValueFromString(). Initially null until a value is parsed.

Methods

Create

Factory method that creates a CommandParameter from a ParameterInfo.

public static CommandParameter Create(ParameterInfo parameterInfo)

Parameter	Type	Description
parameterInfo	ParameterInfo	The reflected parameter info

Returns: A new CommandParameter wrapping the given parameter.

SetValueFromString

Parses a string input into the parameter's expected type and stores the result in Value.

public void SetValueFromString(string input)

Parameter	Type	Description
input	string	String representation of the value

Delegates to CommandParameterParser.Parse(Type, input) for conversion.

Common Pitfalls

Value is null before SetValueFromString The Value property returns null until SetValueFromString() is called. Always parse before reading.

Unsupported types throw KeyNotFoundException If the parameter type does not have a registered parser in CommandParameterParser, calling SetValueFromString() throws a KeyNotFoundException. Default parsers support: int, float, string.

Examples

Basic Usage (internal to Command system)

// Typically called by Command.Execute, not directly:
CommandParameter[] parameters = commandMethod.GetParameters();
parameters[0].SetValueFromString("42");
parameters[1].SetValueFromString("\"hello\"");

object intValue = parameters[0].Value;    // 42 (int)
object strValue = parameters[1].Value;    // "hello" (string)

See Also

• CommandMethod — Creates and owns CommandParameter instances

• CommandParameterParser — Performs the actual string-to-value conversion

• Command — Orchestrates parameter parsing during Execute()