Skip to content

DiGi.Core.Parameter.Classes

github-actions[bot] edited this page Jul 15, 2026 · 3 revisions

DiGi.Core.Parameter.Classes Namespace

Classes

AssociatedTypes Class

Defines a set of types associated with an enum value.

public class AssociatedTypes : System.Attribute, System.Collections.IEnumerable, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject

Inheritance System.ObjectSystem.Attribute → AssociatedTypes

Implements System.Collections.IEnumerable, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject

Constructors

AssociatedTypes(AssociatedTypes) Constructor

Initializes a new instance of the AssociatedTypes class by copying another AssociatedTypes instance.

public AssociatedTypes(DiGi.Core.Parameter.Classes.AssociatedTypes? associatedTypes);

Parameters

associatedTypes AssociatedTypes

The AssociatedTypes instance to copy.

AssociatedTypes(JsonObject) Constructor

Initializes a new instance of the AssociatedTypes class from a JSON object.

public AssociatedTypes(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object containing associated types data.

AssociatedTypes(Type[]) Constructor

Initializes a new instance of the AssociatedTypes class with specified values.

public AssociatedTypes(params System.Type[]? values);

Parameters

values System.Type[]

The associated types.

Properties

AssociatedTypes.Types Property

Gets the collection of associated types.

public System.Type[]? Types { get; }

Property Value

System.Type[]

Methods

AssociatedTypes.Clone() Method

Creates a shallow copy of the current AssociatedTypes instance.

public virtual DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A cloned ISerializableObject.

AssociatedTypes.FromJsonObject(JsonObject) Method

Populates the current AssociatedTypes instance from a JSON object.

public virtual bool FromJsonObject(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to read data from.

Implements FromJsonObject(JsonObject)

Returns

System.Boolean
True if successful, false otherwise.

AssociatedTypes.GetEnumerator() Method

Returns an enumerator that iterates through the associated types.

public System.Collections.IEnumerator GetEnumerator();

Implements GetEnumerator()

Returns

System.Collections.IEnumerator
An IEnumerator for the Types collection.

AssociatedTypes.IsValid(Type) Method

Determines whether a specified type is associated with this instance.

public virtual bool IsValid(System.Type? type);

Parameters

type System.Type

The type to validate.

Returns

System.Boolean
True if the type is valid, false otherwise.

AssociatedTypes.ToJsonObject() Method

Converts the current AssociatedTypes instance to a JSON object.

public virtual System.Text.Json.Nodes.JsonObject? ToJsonObject();

Implements ToJsonObject()

Returns

System.Text.Json.Nodes.JsonObject
The resulting JsonObject.

BooleanParameterValue Class

Represents a boolean value for a parameter.

public class BooleanParameterValue : DiGi.Core.Parameter.Classes.ParameterValue

Inheritance System.ObjectSystem.AttributeParameterValue → BooleanParameterValue

Constructors

BooleanParameterValue() Constructor

Initializes a new instance of the BooleanParameterValue class.

public BooleanParameterValue();

BooleanParameterValue(bool) Constructor

Initializes a new instance of the BooleanParameterValue class with specified nullability.

public BooleanParameterValue(bool nullable);

Parameters

nullable System.Boolean

A value indicating whether the parameter is nullable.

BooleanParameterValue(BooleanParameterValue) Constructor

Initializes a new instance of the BooleanParameterValue class by copying an existing value.

public BooleanParameterValue(DiGi.Core.Parameter.Classes.BooleanParameterValue? booleanParameterValue);

Parameters

booleanParameterValue BooleanParameterValue

The BooleanParameterValue to copy.

BooleanParameterValue(JsonObject) Constructor

Initializes a new instance of the BooleanParameterValue class from a JSON object.

public BooleanParameterValue(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize the current instance from.

Properties

BooleanParameterValue.ParameterType Property

Gets the type of the parameter, which is Integer.

public override DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Property Value

ParameterType

Methods

BooleanParameterValue.Clone() Method

Creates a shallow copy of the current integer parameter value.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A shallow copy of the current integer parameter value.

BooleanParameterValue.IsValid(object) Method

Determines whether the specified value is a valid integer parameter value.

public override bool IsValid(object? value);

Parameters

value System.Object

The value to validate.

Returns

System.Boolean
True if the specified value is a valid integer parameter value; otherwise, false.

BooleanParameterValue.TryConvert(object, object) Method

Attempts to convert the specified input value to an integer parameter value.

public override bool TryConvert(object? value_In, out object? value_Out);

Parameters

value_In System.Object

The input value to be converted.

value_Out System.Object

When this method returns, contains the converted value if successful; otherwise, null.

Returns

System.Boolean
True if the conversion was successful; otherwise, false.

ComplexParameterDefinition Class

Represents the abstract base class for complex parameter definitions.

public abstract class ComplexParameterDefinition : DiGi.Core.Parameter.Classes.ParameterDefinition

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObjectParameterDefinition → ComplexParameterDefinition

Derived
EnumParameterDefinition
ExternalParameterDefinition

Constructors

ComplexParameterDefinition() Constructor

Creates a new instance of the ComplexParameterDefinition class.

public ComplexParameterDefinition();

ComplexParameterDefinition(ComplexParameterDefinition) Constructor

Creates a new instance of the ComplexParameterDefinition class by copying another ComplexParameterDefinition.

public ComplexParameterDefinition(DiGi.Core.Parameter.Classes.ComplexParameterDefinition? complexParameterDefinition);

Parameters

complexParameterDefinition ComplexParameterDefinition

The ComplexParameterDefinition to copy.

ComplexParameterDefinition(JsonObject) Constructor

Creates a new instance of the ComplexParameterDefinition class from a JSON object.

public ComplexParameterDefinition(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object containing the complex parameter definition data.

Properties

ComplexParameterDefinition.AccessType Property

Gets the access type of the complex parameter definition.

public abstract DiGi.Core.Parameter.Enums.AccessType AccessType { get; }

Property Value

AccessType

ComplexParameterDefinition.AssociatedTypes Property

Gets the associated types of the complex parameter definition.

public abstract DiGi.Core.Parameter.Classes.AssociatedTypes? AssociatedTypes { get; }

Property Value

AssociatedTypes

ComplexParameterDefinition.Description Property

Gets the description of the complex parameter definition.

public abstract string? Description { get; }

Property Value

System.String

ComplexParameterDefinition.ParameterType Property

Gets the type of the parameter.

public override DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Implements ParameterType

Property Value

ParameterType

ComplexParameterDefinition.ParameterValue Property

Gets the parameter value of the complex parameter definition.

public abstract DiGi.Core.Parameter.Classes.ParameterValue? ParameterValue { get; }

Property Value

ParameterValue

Methods

ComplexParameterDefinition.IsValid(object) Method

Determines whether the specified value is valid for this complex parameter definition.

public override bool IsValid(object? value);

Parameters

value System.Object

The value to validate.

Implements IsValid(object)

Returns

System.Boolean
True if the value is valid, false otherwise.

DoubleParameterValue Class

Represents a double-precision floating-point value for a parameter.

public class DoubleParameterValue : DiGi.Core.Parameter.Classes.ParameterValue

Inheritance System.ObjectSystem.AttributeParameterValue → DoubleParameterValue

Constructors

DoubleParameterValue() Constructor

Initializes a new instance of the DoubleParameterValue class.

public DoubleParameterValue();

DoubleParameterValue(bool) Constructor

Initializes a new instance of the DoubleParameterValue class with specified nullability.

public DoubleParameterValue(bool nullable);

Parameters

nullable System.Boolean

A value indicating whether the parameter is nullable.

DoubleParameterValue(bool, double, double) Constructor

Initializes a new instance of the DoubleParameterValue class with specified nullability and range.

public DoubleParameterValue(bool nullable, double min, double max);

Parameters

nullable System.Boolean

A value indicating whether the parameter is nullable.

min System.Double

The minimum value for the parameter.

max System.Double

The maximum value for the parameter.

DoubleParameterValue(DoubleParameterValue) Constructor

Initializes a new instance of the DoubleParameterValue class by copying an existing value.

public DoubleParameterValue(DiGi.Core.Parameter.Classes.DoubleParameterValue? doubleParameterValue);

Parameters

doubleParameterValue DoubleParameterValue

The existing value to copy from.

DoubleParameterValue(double) Constructor

Initializes a new instance of the DoubleParameterValue class with a minimum value.

public DoubleParameterValue(double min);

Parameters

min System.Double

The minimum value for the parameter.

DoubleParameterValue(double, double) Constructor

Initializes a new instance of the DoubleParameterValue class with a specified range.

public DoubleParameterValue(double min, double max);

Parameters

min System.Double

The minimum value for the parameter.

max System.Double

The maximum value for the parameter.

DoubleParameterValue(JsonObject) Constructor

Initializes a new instance of the DoubleParameterValue class from a JSON object.

public DoubleParameterValue(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize the value from.

Properties

DoubleParameterValue.ParameterType Property

Gets the type of the parameter, which is Integer.

public override DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Property Value

ParameterType

Methods

DoubleParameterValue.Clone() Method

Creates a shallow copy of the current integer parameter value.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A shallow copy of the current integer parameter value.

DoubleParameterValue.IsValid(object) Method

Determines whether the specified value is a valid integer parameter value.

public override bool IsValid(object? value);

Parameters

value System.Object

The value to validate.

Returns

System.Boolean
True if the specified value is a valid integer parameter value; otherwise, false.

DoubleParameterValue.TryConvert(object, object) Method

Attempts to convert the specified input value to an integer parameter value.

public override bool TryConvert(object? value_In, out object? value_Out);

Parameters

value_In System.Object

The input value to be converted.

value_Out System.Object

When this method returns, contains the converted value if successful; otherwise, null.

Returns

System.Boolean
True if the conversion was successful; otherwise, false.

EnumParameterDefinition Class

Defines a parameter based on an enumeration type.

public class EnumParameterDefinition : DiGi.Core.Parameter.Classes.ComplexParameterDefinition

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObjectParameterDefinitionComplexParameterDefinition → EnumParameterDefinition

Constructors

EnumParameterDefinition() Constructor

Initializes a new instance of the EnumParameterDefinition class.

public EnumParameterDefinition();

EnumParameterDefinition(EnumParameterDefinition) Constructor

Initializes a new instance of the EnumParameterDefinition class by copying an existing definition.

public EnumParameterDefinition(DiGi.Core.Parameter.Classes.EnumParameterDefinition? enumParameterDefinition);

Parameters

enumParameterDefinition EnumParameterDefinition

The existing enum parameter definition to copy.

EnumParameterDefinition(Enum) Constructor

Initializes a new instance of the EnumParameterDefinition class based on a specific enumeration value.

public EnumParameterDefinition(System.Enum? @enum);

Parameters

enum System.Enum

The enumeration value to use for initialization.

EnumParameterDefinition(JsonObject) Constructor

Initializes a new instance of the EnumParameterDefinition class from a JSON object.

public EnumParameterDefinition(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object used to initialize the parameter definition.

Properties

EnumParameterDefinition.AccessType Property

Gets the access type for the enum parameter.

public override DiGi.Core.Parameter.Enums.AccessType AccessType { get; }

Property Value

AccessType

EnumParameterDefinition.AssociatedTypes Property

Gets the associated types for the enum parameter.

public override DiGi.Core.Parameter.Classes.AssociatedTypes? AssociatedTypes { get; }

Property Value

AssociatedTypes

EnumParameterDefinition.Description Property

Gets or sets the description of the enum parameter.

public override string? Description { get; }

Property Value

System.String

EnumParameterDefinition.GroupName Property

Gets the group name to which the enum parameter belongs.

public override string GroupName { get; }

Implements GroupName

Property Value

System.String

EnumParameterDefinition.Name Property

Gets or sets the name of the enum parameter.

public override string? Name { get; }

Implements Name

Property Value

System.String

EnumParameterDefinition.ParameterValue Property

Gets or sets the current value of the enum parameter.

public override DiGi.Core.Parameter.Classes.ParameterValue? ParameterValue { get; }

Property Value

ParameterValue

EnumParameterDefinition.UniqueId Property

Gets or sets the unique identifier for the enum parameter.

public override string? UniqueId { get; }

Implements UniqueId

Property Value

System.String

Methods

EnumParameterDefinition.Clone() Method

Creates a copy of the current enum parameter definition.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A clone of the current enum parameter definition as an DiGi.Core.Interfaces.ISerializableObject.

EnumParameterDefinition.FromJsonObject(JsonObject) Method

Populates the enum parameter definition from a JSON object.

public override bool FromJsonObject(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to populate the definition from.

Implements FromJsonObject(JsonObject)

Returns

System.Boolean
true if the population was successful; otherwise, false.

EnumParameterDefinition.ToJsonObject() Method

Converts the enum parameter definition to a JSON object.

public override System.Text.Json.Nodes.JsonObject ToJsonObject();

Implements ToJsonObject()

Returns

System.Text.Json.Nodes.JsonObject
A System.Text.Json.Nodes.JsonObject representation of the enum parameter definition.

Operators

EnumParameterDefinition.explicit operator EnumParameterDefinition(Enum) Operator

Explicitly converts an System.Enum to an EnumParameterDefinition.

public static DiGi.Core.Parameter.Classes.EnumParameterDefinition? explicit operator DiGi.Core.Parameter.Classes.EnumParameterDefinition?(System.Enum? @enum);

Parameters

enum System.Enum

The enum value to convert.

Returns

EnumParameterDefinition
An EnumParameterDefinition instance created from the provided enum, or null if the input is null.

EnumParameterDefinition.explicit operator Enum(EnumParameterDefinition) Operator

Explicitly converts an EnumParameterDefinition to its underlying System.Enum value.

public static System.Enum? explicit operator System.Enum?(DiGi.Core.Parameter.Classes.EnumParameterDefinition? enumParameterDefinition);

Parameters

enumParameterDefinition EnumParameterDefinition

The enum parameter definition to convert.

Returns

System.Enum
The System.Enum value associated with the definition, or null if the input is null.

ExternalParameterDefinition Class

Represents a parameter definition defined externally with explicit metadata.

public class ExternalParameterDefinition : DiGi.Core.Parameter.Classes.ComplexParameterDefinition, DiGi.Core.Interfaces.INamedObject, DiGi.Core.Interfaces.IObject

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObjectParameterDefinitionComplexParameterDefinition → ExternalParameterDefinition

Implements DiGi.Core.Interfaces.INamedObject, DiGi.Core.Interfaces.IObject

Constructors

ExternalParameterDefinition() Constructor

Creates a new instance of the ExternalParameterDefinition class.

public ExternalParameterDefinition();

ExternalParameterDefinition(ExternalParameterDefinition) Constructor

Creates a new instance of the ExternalParameterDefinition class by copying another ExternalParameterDefinition.

public ExternalParameterDefinition(DiGi.Core.Parameter.Classes.ExternalParameterDefinition? externalParameterDefinition);

Parameters

externalParameterDefinition ExternalParameterDefinition

The ExternalParameterDefinition to copy.

ExternalParameterDefinition(Guid, string, string, AccessType, ParameterValue, AssociatedTypes, string) Constructor

Creates a new instance of the ExternalParameterDefinition class with the specified parameters.

public ExternalParameterDefinition(System.Guid guid, string? name, string? description, DiGi.Core.Parameter.Enums.AccessType accessType, DiGi.Core.Parameter.Classes.ParameterValue? parameterValue, DiGi.Core.Parameter.Classes.AssociatedTypes associatedTypes, string? groupName);

Parameters

guid System.Guid

The unique identifier.

name System.String

The name.

description System.String

The description.

accessType AccessType

The access type.

parameterValue ParameterValue

The parameter value.

associatedTypes AssociatedTypes

The associated types.

groupName System.String

The group name.

ExternalParameterDefinition(JsonObject) Constructor

Creates a new instance of the ExternalParameterDefinition class from a JSON object.

public ExternalParameterDefinition(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object containing the external parameter definition data.

Properties

ExternalParameterDefinition.AccessType Property

Gets the access type of the external parameter definition.

public override DiGi.Core.Parameter.Enums.AccessType AccessType { get; }

Property Value

AccessType

ExternalParameterDefinition.AssociatedTypes Property

Gets the associated types of the external parameter definition.

public override DiGi.Core.Parameter.Classes.AssociatedTypes? AssociatedTypes { get; }

Property Value

AssociatedTypes

ExternalParameterDefinition.Description Property

Gets the description of the external parameter definition.

public override string? Description { get; }

Property Value

System.String

ExternalParameterDefinition.GroupName Property

Gets the group name of the external parameter definition.

public override string? GroupName { get; }

Implements GroupName

Property Value

System.String

ExternalParameterDefinition.Name Property

Gets the name of the external parameter definition.

public override string? Name { get; }

Implements Name

Property Value

System.String

ExternalParameterDefinition.ParameterValue Property

Gets the parameter value of the external parameter definition.

public override DiGi.Core.Parameter.Classes.ParameterValue? ParameterValue { get; }

Property Value

ParameterValue

ExternalParameterDefinition.UniqueId Property

Gets the unique identifier of the external parameter definition.

public override string UniqueId { get; }

Implements UniqueId

Property Value

System.String

Methods

ExternalParameterDefinition.IsValid(object) Method

Determines whether the specified value is valid for this external parameter definition.

public override bool IsValid(object? value);

Parameters

value System.Object

The value to validate.

Implements IsValid(object)

Returns

System.Boolean
True if the value is valid, false otherwise.

GetValueSettings Class

Contains settings for retrieving a parameter value.

public class GetValueSettings

Inheritance System.Object → GetValueSettings

Constructors

GetValueSettings() Constructor

Initializes a new instance of the GetValueSettings class.

public GetValueSettings();

GetValueSettings(bool, bool) Constructor

Initializes a new instance of the GetValueSettings class with specified options.

public GetValueSettings(bool tryConvert, bool checkAccessType);

Parameters

tryConvert System.Boolean

Whether to attempt conversion if types do not match.

checkAccessType System.Boolean

Whether to check for read access permissions.

Properties

GetValueSettings.CheckAccessType Property

Gets or sets a value indicating whether the access type should be checked during retrieval.

public bool CheckAccessType { get; set; }

Property Value

System.Boolean

GetValueSettings.TryConvert Property

Gets or sets a value indicating whether to attempt conversion of the value during retrieval.

public bool TryConvert { get; set; }

Property Value

System.Boolean

GuidParameterValue Class

Represents a GUID value for a parameter.

public class GuidParameterValue : DiGi.Core.Parameter.Classes.ParameterValue

Inheritance System.ObjectSystem.AttributeParameterValue → GuidParameterValue

Constructors

GuidParameterValue() Constructor

Initializes a new instance of the GuidParameterValue class.

public GuidParameterValue();

GuidParameterValue(bool) Constructor

Initializes a new instance of the GuidParameterValue class with specified nullability.

public GuidParameterValue(bool nullable);

Parameters

nullable System.Boolean

A value indicating whether the parameter is nullable.

GuidParameterValue(GuidParameterValue) Constructor

Initializes a new instance of the GuidParameterValue class by copying an existing value.

public GuidParameterValue(DiGi.Core.Parameter.Classes.GuidParameterValue? guidParameterValue);

Parameters

guidParameterValue GuidParameterValue

The existing value to copy.

GuidParameterValue(JsonObject) Constructor

Initializes a new instance of the GuidParameterValue class from a JSON object.

public GuidParameterValue(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize from.

Properties

GuidParameterValue.ParameterType Property

Gets the type of the parameter, which is Integer.

public override DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Property Value

ParameterType

Methods

GuidParameterValue.Clone() Method

Creates a shallow copy of the current integer parameter value.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A shallow copy of the current object.

IntegerParameterValue Class

Represents an integer value for a parameter.

public class IntegerParameterValue : DiGi.Core.Parameter.Classes.ParameterValue

Inheritance System.ObjectSystem.AttributeParameterValue → IntegerParameterValue

Constructors

IntegerParameterValue() Constructor

Initializes a new instance of the IntegerParameterValue class.

public IntegerParameterValue();

IntegerParameterValue(bool) Constructor

Initializes a new instance of the IntegerParameterValue class with specified nullability.

public IntegerParameterValue(bool nullable);

Parameters

nullable System.Boolean

Indicates whether the value can be null.

IntegerParameterValue(bool, int, int) Constructor

Initializes a new instance of the IntegerParameterValue class with specified nullability and range.

public IntegerParameterValue(bool nullable, int min, int max);

Parameters

nullable System.Boolean

Indicates whether the value can be null.

min System.Int32

The minimum value for the parameter.

max System.Int32

The maximum value for the parameter.

IntegerParameterValue(IntegerParameterValue) Constructor

Initializes a new instance of the IntegerParameterValue class by copying an existing value.

public IntegerParameterValue(DiGi.Core.Parameter.Classes.IntegerParameterValue? integerParameterValue);

Parameters

integerParameterValue IntegerParameterValue

The existing integer parameter value to copy.

IntegerParameterValue(int) Constructor

Initializes a new instance of the IntegerParameterValue class with a minimum value.

public IntegerParameterValue(int min);

Parameters

min System.Int32

The minimum value for the parameter.

IntegerParameterValue(int, int) Constructor

Initializes a new instance of the IntegerParameterValue class with a specified range.

public IntegerParameterValue(int min, int max);

Parameters

min System.Int32

The minimum value for the parameter.

max System.Int32

The maximum value for the parameter.

IntegerParameterValue(JsonObject) Constructor

Initializes a new instance of the IntegerParameterValue class from a JSON object.

public IntegerParameterValue(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize the value from.

Properties

IntegerParameterValue.ParameterType Property

Gets the type of the parameter, which is Integer.

public override DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Property Value

ParameterType

Methods

IntegerParameterValue.Clone() Method

Creates a shallow copy of the current integer parameter value.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A shallow copy of the current object.

IntegerParameterValue.IsValid(object) Method

Determines whether the specified value is a valid integer parameter value.

public override bool IsValid(object? value);

Parameters

value System.Object

The value to validate.

Returns

System.Boolean
True if the value is valid; otherwise, false.

IntegerParameterValue.TryConvert(object, object) Method

Attempts to convert the specified input value to an integer parameter value.

public override bool TryConvert(object? value_In, out object? value_Out);

Parameters

value_In System.Object

The input value to convert.

value_Out System.Object

When this method returns, contains the converted value if successful; otherwise, null.

Returns

System.Boolean
True if the conversion was successful; otherwise, false.

ObjectParameterValue Class

Represents a parameter value that can hold an object of one or more specified types.

public class ObjectParameterValue : DiGi.Core.Parameter.Classes.ParameterValue

Inheritance System.ObjectSystem.AttributeParameterValue → ObjectParameterValue

Constructors

ObjectParameterValue() Constructor

Initializes a new instance of the ObjectParameterValue class.

public ObjectParameterValue();

ObjectParameterValue(bool, bool, Type[]) Constructor

Initializes a new instance of the ObjectParameterValue class with specified nullability, inheritance rules, and allowed types.

public ObjectParameterValue(bool nullable, bool inheritance, params System.Type[] types);

Parameters

nullable System.Boolean

Specifies whether the value can be null.

inheritance System.Boolean

Specifies whether inheritance is considered when validating types.

types System.Type[]

The collection of allowed types for this parameter value.

ObjectParameterValue(ObjectParameterValue) Constructor

Initializes a new instance of the ObjectParameterValue class by copying an existing instance.

public ObjectParameterValue(DiGi.Core.Parameter.Classes.ObjectParameterValue? objectParameterValue);

Parameters

objectParameterValue ObjectParameterValue

The existing instance to copy.

ObjectParameterValue(JsonObject) Constructor

Initializes a new instance of the ObjectParameterValue class from a JSON object.

public ObjectParameterValue(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize the current instance with.

Properties

ObjectParameterValue.ParameterType Property

Gets the parameter type associated with this string parameter value.

public override DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Property Value

ParameterType

Methods

ObjectParameterValue.Clone() Method

Creates a clone of the current string parameter value.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A new instance of DiGi.Core.Interfaces.ISerializableObject that is a copy of the current object.

ObjectParameterValue.IsValid(object) Method

Determines whether the specified value is valid for this parameter.

public override bool IsValid(object? value);

Parameters

value System.Object

The value to validate.

Returns

System.Boolean
True if the value is valid; otherwise, false.

ObjectParameterValue.TryConvert(object, object) Method

Attempts to convert the specified input value to a compatible output value.

public override bool TryConvert(object? value_In, out object? value_Out);

Parameters

value_In System.Object

The input value to be converted.

value_Out System.Object

When this method returns, contains the converted value if successful; otherwise, null.

Returns

System.Boolean
True if the conversion was successful; otherwise, false.

Parameter Class

Represents a parameter with a definition and a value.

public class Parameter : DiGi.Core.Classes.SerializableObject

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObject → Parameter

Constructors

Parameter(Parameter) Constructor

Creates a new instance of the Parameter class by copying another Parameter.

public Parameter(DiGi.Core.Parameter.Classes.Parameter? parameter);

Parameters

parameter Parameter

The Parameter to copy.

Parameter(IParameterDefinition) Constructor

Creates a new instance of the Parameter class with the specified parameter definition.

internal Parameter(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition);

Parameters

parameterDefinition IParameterDefinition

The parameter definition.

Parameter(IParameterDefinition, object) Constructor

Creates a new instance of the Parameter class with the specified parameter definition and value.

internal Parameter(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, object? value);

Parameters

parameterDefinition IParameterDefinition

The parameter definition.

value System.Object

The parameter value.

Parameter(JsonObject) Constructor

Creates a new instance of the Parameter class from a JSON object.

public Parameter(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object containing the parameter data.

Properties

Parameter.Name Property

Gets the name of the parameter.

public string? Name { get; }

Property Value

System.String

Parameter.ParameterDefinition Property

Gets the parameter definition.

public DiGi.Core.Parameter.Interfaces.IParameterDefinition? ParameterDefinition { get; }

Property Value

IParameterDefinition

Parameter.ParameterType Property

Gets the type of the parameter.

public DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Property Value

ParameterType

Parameter.UniqueId Property

Gets the unique identifier of the parameter.

public string? UniqueId { get; }

Property Value

System.String

Parameter.Value Property

Gets the value of the parameter.

public object? Value { get; }

Property Value

System.Object

Methods

Parameter.Clone() Method

Creates a deep copy of the Parameter.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A new cloned instance of the Parameter.

Parameter.GetValue<T>(GetValueSettings) Method

Gets the value of the parameter, converted to the specified type.

public T? GetValue<T>(DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type to convert the value to.

Parameters

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

T
The converted value, or default if conversion fails.

Parameter.SetValue(object, SetValueSettings) Method

Sets the value of the parameter.

public bool SetValue(object? value, DiGi.Core.Parameter.Classes.SetValueSettings? setValueSettings=null);

Parameters

value System.Object

The value to set.

setValueSettings SetValueSettings

Optional settings for setting the value.

Returns

System.Boolean
True if the value was successfully set, false otherwise.

Parameter.TryGetValue<T>(T, GetValueSettings) Method

Tries to get the value of the parameter, converted to the specified type.

public bool TryGetValue<T>(out T? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type to convert the value to.

Parameters

value T

The converted value, or default if conversion fails.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved, false otherwise.

ParameterDefinition Class

Provides a base class for defining parameters.

public abstract class ParameterDefinition : DiGi.Core.Classes.SerializableObject, DiGi.Core.Parameter.Interfaces.IParameterDefinition, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject, System.IEquatable<DiGi.Core.Parameter.Interfaces.IParameterDefinition>, DiGi.Core.Interfaces.INamedObject

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObject → ParameterDefinition

Derived
ComplexParameterDefinition
SimpleParameterDefinition

Implements IParameterDefinition, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject, System.IEquatable<IParameterDefinition>, DiGi.Core.Interfaces.INamedObject

Constructors

ParameterDefinition() Constructor

Initializes a new instance of the ParameterDefinition class.

public ParameterDefinition();

ParameterDefinition(ParameterDefinition) Constructor

Initializes a new instance of the ParameterDefinition class by copying an existing definition.

public ParameterDefinition(DiGi.Core.Parameter.Classes.ParameterDefinition? parameterDefinition);

Parameters

parameterDefinition ParameterDefinition

The parameter definition to copy from.

ParameterDefinition(JsonObject) Constructor

Initializes a new instance of the ParameterDefinition class from a JSON object.

public ParameterDefinition(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize the definition from.

Properties

ParameterDefinition.GroupName Property

Gets the group name to which the parameter belongs.

public abstract string? GroupName { get; }

Implements GroupName

Property Value

System.String

ParameterDefinition.Name Property

Gets or sets the name of the parameter.

public abstract string? Name { get; }

Implements Name

Property Value

System.String

ParameterDefinition.ParameterType Property

Gets the type of the parameter.

public abstract DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Implements ParameterType

Property Value

ParameterType

ParameterDefinition.UniqueId Property

Gets or sets the unique identifier for the parameter.

public abstract string? UniqueId { get; }

Implements UniqueId

Property Value

System.String

Methods

ParameterDefinition.Equals(IParameterDefinition) Method

Determines whether the specified parameter definition is equal to the current instance.

public bool Equals(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition);

Parameters

parameterDefinition IParameterDefinition

The parameter definition to compare with the current instance.

Returns

System.Boolean
True if the specified parameter definition is equal to the current instance; otherwise, false.

ParameterDefinition.IsValid(object) Method

Validates whether the provided value is valid for this parameter definition.

public virtual bool IsValid(object? value);

Parameters

value System.Object

The value to validate.

Implements IsValid(object)

Returns

System.Boolean
True if the value is valid; otherwise, false.

ParameterGroup Class

Represents a group of parameters.

public class ParameterGroup : DiGi.Core.Classes.SerializableObject, System.Collections.Generic.IEnumerable<DiGi.Core.Parameter.Classes.Parameter>, System.Collections.IEnumerable

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObject → ParameterGroup

Implements System.Collections.Generic.IEnumerable<Parameter>, System.Collections.IEnumerable

Constructors

ParameterGroup(ParameterGroup) Constructor

Initializes a new instance of the ParameterGroup class by copying another group.

public ParameterGroup(DiGi.Core.Parameter.Classes.ParameterGroup? parameterGroup);

Parameters

parameterGroup ParameterGroup

The parameter group to copy from.

ParameterGroup(string) Constructor

Initializes a new instance of the ParameterGroup class with a specified name.

public ParameterGroup(string? name);

Parameters

name System.String

The name of the parameter group.

ParameterGroup(string, IEnumerable<Parameter>) Constructor

Initializes a new instance of the ParameterGroup class with a specified name and a collection of parameters.

public ParameterGroup(string? name, System.Collections.Generic.IEnumerable<DiGi.Core.Parameter.Classes.Parameter>? parameters);

Parameters

name System.String

The name of the parameter group.

parameters System.Collections.Generic.IEnumerable<Parameter>

The collection of parameters to include in the group.

ParameterGroup(JsonObject) Constructor

Initializes a new instance of the ParameterGroup class from a JSON object.

public ParameterGroup(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize the group from.

Properties

ParameterGroup.Name Property

Gets or sets the display name of the parameter.

public string? Name { get; }

Property Value

System.String

Methods

ParameterGroup.Clone() Method

Creates a deep copy of the current parameter group.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A deep copy of the current parameter group.

ParameterGroup.Contains(IParameterDefinition) Method

Determines whether any group in the collection contains a parameter matching the specified definition.

public bool Contains(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition);

Parameters

parameterDefinition IParameterDefinition

The parameter definition to search for.

Returns

System.Boolean
True if the collection contains a parameter matching the specified definition; otherwise, false.

ParameterGroup.Contains(string) Method

Determines whether any group in the collection contains a parameter with the specified unique identifier.

public bool Contains(string? uniqueId);

Parameters

uniqueId System.String

The unique identifier of the parameter to search for.

Returns

System.Boolean
True if the collection contains a parameter with the specified unique identifier; otherwise, false.

ParameterGroup.GetEnumerator() Method

Returns an enumerator that iterates through the parameters in the group.

public System.Collections.Generic.IEnumerator<DiGi.Core.Parameter.Classes.Parameter> GetEnumerator();

Implements GetEnumerator(), GetEnumerator()

Returns

System.Collections.Generic.IEnumerator<Parameter>
An enumerator that iterates through the parameters in the group.

ParameterGroup.GetParameterDefinitions(string, TextComparisonType, bool) Method

Retrieves a list of parameter definitions that match the specified name and comparison criteria.

public System.Collections.Generic.List<DiGi.Core.Parameter.Interfaces.IParameterDefinition>? GetParameterDefinitions(string? name, DiGi.Core.Enums.TextComparisonType textComparisonType=DiGi.Core.Enums.TextComparisonType.Equals, bool caseSensitive=true);

Parameters

name System.String

The name of the parameters to search for.

textComparisonType DiGi.Core.Enums.TextComparisonType

The type of text comparison to use when matching the name.

caseSensitive System.Boolean

A value indicating whether the name comparison is case-sensitive.

Returns

System.Collections.Generic.List<IParameterDefinition>
A list of parameter definitions that match the specified criteria, or null if no matches are found.

ParameterGroup.GetParameterDefinitions<T>(string, TextComparisonType, bool) Method

Retrieves a list of parameter definitions of type T that match the specified name and comparison criteria.

public System.Collections.Generic.List<T>? GetParameterDefinitions<T>(string? name, DiGi.Core.Enums.TextComparisonType textComparisonType=DiGi.Core.Enums.TextComparisonType.Equals, bool caseSensitive=true)
    where T : DiGi.Core.Parameter.Interfaces.IParameterDefinition;

Type parameters

T

The type of parameter definitions to retrieve.

Parameters

name System.String

The name of the parameters to search for.

textComparisonType DiGi.Core.Enums.TextComparisonType

The type of text comparison to use when matching the name.

caseSensitive System.Boolean

A value indicating whether the name comparison is case-sensitive.

Returns

System.Collections.Generic.List<T>
A list of parameter definitions of type T that match the specified criteria, or null if no matches are found.

ParameterGroup.GetParameterDefinitions<TParameterDefinition>() Method

Retrieves a list of parameter definitions of the specified type within the group.

public System.Collections.Generic.List<TParameterDefinition>? GetParameterDefinitions<TParameterDefinition>()
    where TParameterDefinition : DiGi.Core.Parameter.Interfaces.IParameterDefinition;

Type parameters

TParameterDefinition

The type of parameter definition to retrieve.

Returns

System.Collections.Generic.List<TParameterDefinition>
A list of parameter definitions of the specified type, or null if none are found.

ParameterGroup.GetValue(IParameterDefinition, GetValueSettings) Method

Gets the value associated with the specified parameter definition from the collection.

public object? GetValue(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

parameterDefinition IParameterDefinition

The parameter definition to retrieve the value for.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

System.Object
The value associated with the specified parameter definition, or null if not found.

ParameterGroup.GetValue(string, GetValueSettings) Method

Gets the value associated with the specified unique identifier from the collection.

public object? GetValue(string? uniqueId, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

uniqueId System.String

The unique identifier of the value to get.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

System.Object
The value associated with the specified unique identifier, or null if not found.

ParameterGroup.GetValue<T>(IParameterDefinition, GetValueSettings) Method

Gets the value of type T associated with the specified parameter definition from the collection.

public T? GetValue<T>(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

parameterDefinition IParameterDefinition

The definition of the parameter whose value is to be retrieved.

getValueSettings GetValueSettings

Optional settings to control how the value is retrieved.

Returns

T
The value associated with the specified parameter definition, or the default value for type T if not found.

ParameterGroup.GetValue<T>(string, GetValueSettings) Method

Gets the value of type T associated with the specified unique identifier.

public T? GetValue<T>(string? uniqueId, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

uniqueId System.String

The unique identifier of the value to get.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

T
The value of type T associated with the specified unique identifier, or null if not found.

ParameterGroup.Remove(IParameterDefinition) Method

Removes the parameter matching the specified definition from the collection.

public bool Remove(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition);

Parameters

parameterDefinition IParameterDefinition

The definition of the parameter to remove.

Returns

System.Boolean
True if the parameter was successfully removed; otherwise, false.

ParameterGroup.Remove(string) Method

Removes the parameter with the specified unique identifier from the group.

public bool Remove(string uniqueId);

Parameters

uniqueId System.String

The unique identifier of the parameter to remove.

Returns

System.Boolean
True if the parameter was successfully removed; otherwise, false.

ParameterGroup.SetValue(Parameter) Method

Adds or updates a parameter in the collection.

public bool SetValue(DiGi.Core.Parameter.Classes.Parameter? parameter);

Parameters

parameter Parameter

The parameter to add or update.

Returns

System.Boolean
True if the operation was successful; otherwise, false.

ParameterGroup.SetValue(IParameterDefinition, object, SetValueSettings) Method

Sets the value for the parameter matching the specified definition within the collection.

public bool SetValue(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, object? value, DiGi.Core.Parameter.Classes.SetValueSettings? setValueSettings=null);

Parameters

parameterDefinition IParameterDefinition

The definition of the parameter to set.

value System.Object

The value to assign to the parameter.

setValueSettings SetValueSettings

Optional settings to control how the value is set.

Returns

System.Boolean
True if the value was successfully set; otherwise, false.

ParameterGroup.SetValue(string, object, SetValueSettings) Method

Sets the value for the parameter identified by the specified name within the collection.

public bool SetValue(string? name, object? value, DiGi.Core.Parameter.Classes.SetValueSettings? setValueSettings=null);

Parameters

name System.String

The name of the parameter to set.

value System.Object

The value to assign to the parameter.

setValueSettings SetValueSettings

Optional settings to control how the value is set.

Returns

System.Boolean
True if the value was successfully set; otherwise, false.

ParameterGroup.TryGetValue(IParameterDefinition, object, GetValueSettings) Method

Attempts to get the value associated with the specified parameter definition from the collection.

public bool TryGetValue(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, out object? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

parameterDefinition IParameterDefinition

The parameter definition for which to retrieve the value.

value System.Object

When this method returns, contains the retrieved value if found; otherwise, null.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParameterGroup.TryGetValue(string, object, GetValueSettings) Method

Attempts to get the value associated with the specified unique identifier from the collection.

public bool TryGetValue(string? uniqueId, out object? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

uniqueId System.String

The unique identifier of the parameter for which to retrieve the value.

value System.Object

When this method returns, contains the retrieved value if found; otherwise, null.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParameterGroup.TryGetValue<T>(IParameterDefinition, T, GetValueSettings) Method

Attempts to get the value of type T associated with the specified parameter definition from the collection.

public bool TryGetValue<T>(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, out T? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

parameterDefinition IParameterDefinition

The parameter definition for which to retrieve the value.

value T

When this method returns, contains the retrieved value of type T if found; otherwise, the default value of T.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParameterGroup.TryGetValue<T>(string, T, GetValueSettings) Method

Attempts to get the value of type T associated with the specified unique identifier from the collection.

public bool TryGetValue<T>(string? uniqueId, out T? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

uniqueId System.String

The unique identifier of the parameter for which to retrieve the value.

value T

When this method returns, contains the retrieved value of type T if found; otherwise, the default value of T.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParameterGroupCollection Class

Represents a collection of parameter groups.

public class ParameterGroupCollection : DiGi.Core.Classes.SerializableObject, System.Collections.Generic.IEnumerable<DiGi.Core.Parameter.Classes.ParameterGroup>, System.Collections.IEnumerable

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObject → ParameterGroupCollection

Implements System.Collections.Generic.IEnumerable<ParameterGroup>, System.Collections.IEnumerable

Constructors

ParameterGroupCollection() Constructor

Initializes a new instance of the ParameterGroupCollection class.

public ParameterGroupCollection();

ParameterGroupCollection(ParameterGroupCollection) Constructor

Initializes a new instance of the ParameterGroupCollection class by copying another collection.

public ParameterGroupCollection(DiGi.Core.Parameter.Classes.ParameterGroupCollection? parameterGroupCollection);

Parameters

parameterGroupCollection ParameterGroupCollection

The parameter group collection to copy from.

ParameterGroupCollection(IEnumerable<Parameter>) Constructor

Initializes a new instance of the ParameterGroupCollection class from a collection of parameters.

public ParameterGroupCollection(System.Collections.Generic.IEnumerable<DiGi.Core.Parameter.Classes.Parameter>? parameters);

Parameters

parameters System.Collections.Generic.IEnumerable<Parameter>

The collection of parameters to initialize the collection with.

ParameterGroupCollection(JsonObject) Constructor

Initializes a new instance of the ParameterGroupCollection class from a JSON object.

public ParameterGroupCollection(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize the collection from.

Properties

ParameterGroupCollection.this[string] Property

Gets the parameter group associated with the specified name.

public DiGi.Core.Parameter.Classes.ParameterGroup? this[string? name] { get; }

Parameters

name System.String

The name of the parameter group to retrieve.

Property Value

ParameterGroup

Methods

ParameterGroupCollection.Clone() Method

Creates a deep copy of the current parameter group collection.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A deep copy of the current parameter group collection.

ParameterGroupCollection.Contains(IParameterDefinition) Method

Determines whether any group in the collection contains a parameter matching the specified definition.

public bool Contains(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition);

Parameters

parameterDefinition IParameterDefinition

The parameter definition to search for.

Returns

System.Boolean
True if any group in the collection contains a parameter matching the specified definition; otherwise, false.

ParameterGroupCollection.Contains(string) Method

Determines whether any group in the collection contains a parameter with the specified unique identifier.

public bool Contains(string? uniqueId);

Parameters

uniqueId System.String

The unique identifier of the parameter to search for.

Returns

System.Boolean
True if any group in the collection contains a parameter with the specified unique identifier; otherwise, false.

ParameterGroupCollection.GetEnumerator() Method

Returns an enumerator that iterates through the parameter groups in the collection.

public System.Collections.Generic.IEnumerator<DiGi.Core.Parameter.Classes.ParameterGroup> GetEnumerator();

Implements GetEnumerator(), GetEnumerator()

Returns

System.Collections.Generic.IEnumerator<ParameterGroup>
An enumerator that iterates through the parameter groups in the collection.

ParameterGroupCollection.GetParameterDefinitions(string, TextComparisonType, bool) Method

Retrieves a list of parameter definitions that match the specified name and comparison criteria across all groups.

public System.Collections.Generic.List<DiGi.Core.Parameter.Interfaces.IParameterDefinition>? GetParameterDefinitions(string? parameterName, DiGi.Core.Enums.TextComparisonType textComparisonType=DiGi.Core.Enums.TextComparisonType.Equals, bool caseSensitive=true);

Parameters

parameterName System.String

The name of the parameters to search for.

textComparisonType DiGi.Core.Enums.TextComparisonType

The type of text comparison to use when matching the name.

caseSensitive System.Boolean

A value indicating whether the comparison should be case-sensitive.

Returns

System.Collections.Generic.List<IParameterDefinition>
A list of parameter definitions that match the criteria, or null if none are found.

ParameterGroupCollection.GetParameterDefinitions<TParameterDefinition>() Method

Retrieves a list of all parameter definitions of the specified type across all groups.

public System.Collections.Generic.List<TParameterDefinition> GetParameterDefinitions<TParameterDefinition>()
    where TParameterDefinition : DiGi.Core.Parameter.Interfaces.IParameterDefinition;

Type parameters

TParameterDefinition

The type of parameter definition to retrieve.

Returns

System.Collections.Generic.List<TParameterDefinition>
A list containing all parameter definitions of the specified type.

ParameterGroupCollection.GetParameterDefinitions<TParameterDefinition>(string, TextComparisonType, bool) Method

Retrieves a list of parameter definitions of type TParameterDefinition that match the specified name and comparison criteria across all groups.

public System.Collections.Generic.List<TParameterDefinition>? GetParameterDefinitions<TParameterDefinition>(string? parameterName, DiGi.Core.Enums.TextComparisonType textComparisonType=DiGi.Core.Enums.TextComparisonType.Equals, bool caseSensitive=true)
    where TParameterDefinition : DiGi.Core.Parameter.Interfaces.IParameterDefinition;

Type parameters

TParameterDefinition

The type of parameter definition to retrieve.

Parameters

parameterName System.String

The name of the parameters to search for.

textComparisonType DiGi.Core.Enums.TextComparisonType

The type of text comparison to use when matching the name.

caseSensitive System.Boolean

A value indicating whether the comparison should be case-sensitive.

Returns

System.Collections.Generic.List<TParameterDefinition>
A list of parameter definitions that match the criteria, or null if none are found.

ParameterGroupCollection.GetValue(IParameterDefinition, GetValueSettings) Method

Gets the value associated with the specified parameter definition from the collection.

public object? GetValue(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

parameterDefinition IParameterDefinition

The parameter definition used to retrieve the value.

getValueSettings GetValueSettings

Optional settings to customize how the value is retrieved.

Returns

System.Object
The value associated with the specified parameter definition, or null if not found.

ParameterGroupCollection.GetValue(string, GetValueSettings) Method

Gets the value associated with the specified unique identifier from the collection.

public object? GetValue(string? uniqueId, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

uniqueId System.String

The unique identifier of the value to retrieve.

getValueSettings GetValueSettings

Optional settings to customize how the value is retrieved.

Returns

System.Object
The value associated with the specified unique identifier, or null if not found.

ParameterGroupCollection.GetValue<T>(IParameterDefinition, GetValueSettings) Method

Gets the value of type T associated with the specified parameter definition from the collection.

public T? GetValue<T>(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

parameterDefinition IParameterDefinition

The definition of the parameter whose value is to be retrieved.

getValueSettings GetValueSettings

Optional settings to control how the value is retrieved.

Returns

T
The value associated with the specified parameter definition, cast to type T, or null if not found.

ParameterGroupCollection.Remove(IParameterDefinition) Method

Removes the parameter matching the specified definition from the collection.

public bool Remove(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition);

Parameters

parameterDefinition IParameterDefinition

The definition of the parameter to remove.

Returns

System.Boolean
True if the parameter was successfully removed; otherwise, false.

ParameterGroupCollection.Remove(string) Method

Removes the parameter with the specified unique identifier from the collection.

public bool Remove(string? uniqueId);

Parameters

uniqueId System.String

The unique identifier of the parameter to remove.

Returns

System.Boolean
True if the parameter was successfully removed; otherwise, false.

ParameterGroupCollection.SetValue(Parameter) Method

Adds or updates a parameter in the collection.

public bool SetValue(DiGi.Core.Parameter.Classes.Parameter? parameter);

Parameters

parameter Parameter

The parameter to add or update.

Returns

System.Boolean
true if the operation was successful; otherwise, false.

ParameterGroupCollection.SetValue(IParameterDefinition, object, SetValueSettings) Method

Sets the value for the parameter matching the specified definition within the collection.

public bool SetValue(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, object? value, DiGi.Core.Parameter.Classes.SetValueSettings? setValueSettings=null);

Parameters

parameterDefinition IParameterDefinition

The definition of the parameter to set.

value System.Object

The value to assign to the parameter.

setValueSettings SetValueSettings

Optional settings to control how the value is set.

Returns

System.Boolean
True if the value was successfully set; otherwise, false.

ParameterGroupCollection.SetValue(string, object, SetValueSettings) Method

Sets the value for the parameter identified by the specified name within the collection.

public bool SetValue(string? name, object? value, DiGi.Core.Parameter.Classes.SetValueSettings? setValueSettings=null);

Parameters

name System.String

The name of the parameter to set.

value System.Object

The value to assign to the parameter.

setValueSettings SetValueSettings

Optional settings to control how the value is set.

Returns

System.Boolean
True if the value was successfully set; otherwise, false.

ParameterGroupCollection.TryGetValue(IParameterDefinition, object, GetValueSettings) Method

Attempts to get the value associated with the specified parameter definition from the collection.

public bool TryGetValue(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, out object? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

parameterDefinition IParameterDefinition

The parameter definition associated with the value to get.

value System.Object

When this method returns, contains the value associated with the specified parameter definition, if found; otherwise, null.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
true if the value was found; otherwise, false.

ParameterGroupCollection.TryGetValue(string, object, GetValueSettings) Method

Attempts to get the value associated with the specified unique identifier from the collection.

public bool TryGetValue(string? uniqueId, out object? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

uniqueId System.String

The unique identifier of the value to get.

value System.Object

When this method returns, contains the value associated with the specified unique identifier, if found; otherwise, null.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
true if the value was found; otherwise, false.

ParameterGroupCollection.TryGetValue<T>(IParameterDefinition, T, GetValueSettings) Method

Attempts to get the value of type T associated with the specified parameter definition from the collection.

public bool TryGetValue<T>(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, out T? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

parameterDefinition IParameterDefinition

The parameter definition associated with the value to get.

value T

When this method returns, contains the value associated with the specified parameter definition, if found; otherwise, the default value of T.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
true if the value was found; otherwise, false.

ParameterGroupCollection.TryGetValue<T>(string, T, GetValueSettings) Method

Attempts to get the value of type T associated with the specified unique identifier from the collection.

public bool TryGetValue<T>(string? uniqueId, out T? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

uniqueId System.String

The unique identifier of the value to get.

value T

When this method returns, contains the value associated with the specified unique identifier, if found; otherwise, the default value of T.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
true if the value was found; otherwise, false.

ParameterProperties Class

Contains metadata and properties for a parameter definition.

public class ParameterProperties : System.Attribute

Inheritance System.ObjectSystem.Attribute → ParameterProperties

Constructors

ParameterProperties(string) Constructor

Initializes a new instance of the ParameterProperties class with a specified name.

public ParameterProperties(string? name);

Parameters

name System.String

The name of the parameter.

ParameterProperties(string, string) Constructor

Initializes a new instance of the ParameterProperties class with a unique identifier and name.

public ParameterProperties(string? uniqueId, string? name);

Parameters

uniqueId System.String

The unique identifier for the parameter.

name System.String

The name of the parameter.

ParameterProperties(string, string, AccessType) Constructor

Initializes a new instance of the ParameterProperties class with a name, description, and access type.

public ParameterProperties(string? name, string? description, DiGi.Core.Parameter.Enums.AccessType accessType);

Parameters

name System.String

The name of the parameter.

description System.String

The description of the parameter.

accessType AccessType

The access type of the parameter.

ParameterProperties(string, string, string) Constructor

Initializes a new instance of the ParameterProperties class with a unique identifier, name, and description.

public ParameterProperties(string? uniqueId, string? name, string? description);

Parameters

uniqueId System.String

The unique identifier for the parameter.

name System.String

The name of the parameter.

description System.String

The description of the parameter.

ParameterProperties(string, string, string, AccessType) Constructor

Initializes a new instance of the ParameterProperties class with a unique identifier, name, description, and access type.

public ParameterProperties(string? uniqueId, string? name, string? description, DiGi.Core.Parameter.Enums.AccessType accessType);

Parameters

uniqueId System.String

The unique identifier for the parameter.

name System.String

The name of the parameter.

description System.String

The description of the parameter.

accessType AccessType

The access type of the parameter.

ParameterProperties(string, string, string, AccessType, string) Constructor

Initializes a new instance of the ParameterProperties class with full metadata including group name.

public ParameterProperties(string? uniqueId, string? name, string? description, DiGi.Core.Parameter.Enums.AccessType accessType, string? groupName);

Parameters

uniqueId System.String

The unique identifier for the parameter.

name System.String

The name of the parameter.

description System.String

The description of the parameter.

accessType AccessType

The access type of the parameter.

groupName System.String

The name of the group to which the parameter belongs.

Properties

ParameterProperties.AccessType Property

Gets or sets the access level of the parameter.

public DiGi.Core.Parameter.Enums.AccessType AccessType { get; }

Property Value

AccessType

ParameterProperties.Description Property

Gets or sets the description of the parameter.

public string? Description { get; }

Property Value

System.String

ParameterProperties.GroupName Property

Gets or sets the name of the group this parameter belongs to.

public string? GroupName { get; }

Property Value

System.String

ParameterProperties.Name Property

Gets or sets the display name of the parameter.

public string? Name { get; }

Property Value

System.String

ParameterProperties.UniqueId Property

Gets or sets a unique string identifier for the object.

public string? UniqueId { get; }

Property Value

System.String

ParameterValue Class

Base class for all parameter value types.

public abstract class ParameterValue : System.Attribute, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject

Inheritance System.ObjectSystem.Attribute → ParameterValue

Derived
BooleanParameterValue
DoubleParameterValue
GuidParameterValue
IntegerParameterValue
ObjectParameterValue
StringParameterValue

Implements DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject

Constructors

ParameterValue() Constructor

Initializes a new instance of the ParameterValue class.

public ParameterValue();

ParameterValue(bool) Constructor

Initializes a new instance of the ParameterValue class with specified nullability.

public ParameterValue(bool nullable);

Parameters

nullable System.Boolean

A value indicating whether the parameter is nullable.

ParameterValue(ParameterValue) Constructor

Initializes a new instance of the ParameterValue class by copying an existing instance.

public ParameterValue(DiGi.Core.Parameter.Classes.ParameterValue? parameterValue);

Parameters

parameterValue ParameterValue

The existing ParameterValue instance to copy.

ParameterValue(JsonObject) Constructor

Initializes a new instance of the ParameterValue class from a JSON object.

public ParameterValue(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object used to initialize the parameter value.

Properties

ParameterValue.Nullable Property

Gets a value indicating whether the parameter is nullable.

public bool Nullable { get; }

Property Value

System.Boolean

ParameterValue.ParameterType Property

Gets the parameter type associated with this value.

public abstract DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Property Value

ParameterType

Methods

ParameterValue.Clone() Method

Creates a clone of the current parameter value.

public abstract DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A new instance of DiGi.Core.Interfaces.ISerializableObject that is a copy of the current object, or null.

ParameterValue.FromJsonObject(JsonObject) Method

Populates the parameter value from the provided JSON object.

public bool FromJsonObject(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to extract the value from.

Implements FromJsonObject(JsonObject)

Returns

System.Boolean
True if the population was successful; otherwise, false.

ParameterValue.IsValid(object) Method

Validates whether the given value is compatible with this parameter.

public virtual bool IsValid(object? value);

Parameters

value System.Object

The value to validate.

Returns

System.Boolean
True if the value is valid; otherwise, false.

ParameterValue.ToJsonObject() Method

Converts the current parameter value to a JSON object.

public System.Text.Json.Nodes.JsonObject? ToJsonObject();

Implements ToJsonObject()

Returns

System.Text.Json.Nodes.JsonObject
A System.Text.Json.Nodes.JsonObject representation of the parameter value, or null if conversion fails.

ParameterValue.TryConvert(object, object) Method

Attempts to convert an input value to the expected output type.

public virtual bool TryConvert(object? value_In, out object? value_Out);

Parameters

value_In System.Object

The value to be converted.

value_Out System.Object

When this method returns, contains the converted value if successful; otherwise, null.

Returns

System.Boolean
True if the conversion was successful; otherwise, false.

ParametrizedGuidObject Class

Base class for objects that possess a unique GUID and a set of parameters.

public abstract class ParametrizedGuidObject : DiGi.Core.Parameter.Classes.ParametrizedObject, DiGi.Core.Parameter.Interfaces.IParametrizedGuidObject, DiGi.Core.Parameter.Interfaces.IParametrizedUniqueObject, DiGi.Core.Parameter.Interfaces.IParametrizedObject, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject, DiGi.Core.Interfaces.IUniqueIdObject, DiGi.Core.Interfaces.IUniqueObject, DiGi.Core.Interfaces.IGuidObject

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObjectParametrizedObject → ParametrizedGuidObject

Implements IParametrizedGuidObject, IParametrizedUniqueObject, IParametrizedObject, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject, DiGi.Core.Interfaces.IUniqueIdObject, DiGi.Core.Interfaces.IUniqueObject, DiGi.Core.Interfaces.IGuidObject

Constructors

ParametrizedGuidObject() Constructor

Initializes a new instance of the ParametrizedGuidObject class.

public ParametrizedGuidObject();

ParametrizedGuidObject(ParameterGroupCollection) Constructor

Initializes a new instance of the ParametrizedGuidObject class with a specified group collection.

public ParametrizedGuidObject(DiGi.Core.Parameter.Classes.ParameterGroupCollection? parameterGroupCollection);

Parameters

parameterGroupCollection ParameterGroupCollection

The collection of parameter groups to initialize the object with.

ParametrizedGuidObject(ParametrizedGuidObject) Constructor

Initializes a new instance of the ParametrizedGuidObject class by copying another object.

public ParametrizedGuidObject(DiGi.Core.Parameter.Classes.ParametrizedGuidObject? parametrizedGuidObject);

Parameters

parametrizedGuidObject ParametrizedGuidObject

The source object to copy.

ParametrizedGuidObject(IEnumerable<Parameter>) Constructor

Initializes a new instance of the ParametrizedGuidObject class with a collection of parameters.

public ParametrizedGuidObject(System.Collections.Generic.IEnumerable<DiGi.Core.Parameter.Classes.Parameter>? parameters);

Parameters

parameters System.Collections.Generic.IEnumerable<Parameter>

The collection of parameters to initialize the object with.

ParametrizedGuidObject(Guid) Constructor

Initializes a new instance of the ParametrizedGuidObject class with a specified GUID.

public ParametrizedGuidObject(System.Guid guid);

Parameters

guid System.Guid

The GUID to assign to the new instance.

ParametrizedGuidObject(Guid, ParametrizedGuidObject) Constructor

Initializes a new instance of the ParametrizedGuidObject class with a specific GUID and data from another object.

public ParametrizedGuidObject(System.Guid guid, DiGi.Core.Parameter.Classes.ParametrizedGuidObject? parametrizedGuidObject);

Parameters

guid System.Guid

The GUID to assign to the new instance.

parametrizedGuidObject ParametrizedGuidObject

The source object from which to copy data.

ParametrizedGuidObject(JsonObject) Constructor

Initializes a new instance of the ParametrizedGuidObject class from a JSON object.

public ParametrizedGuidObject(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to deserialize into a new instance.

Properties

ParametrizedGuidObject.Guid Property

Gets the unique global identifier of the object.

public System.Guid Guid { get; }

Implements Guid

Property Value

System.Guid

ParametrizedGuidObject.UniqueId Property

Gets or sets a unique string identifier for the object.

public string? UniqueId { get; }

Implements UniqueId

Property Value

System.String

Methods

ParametrizedGuidObject.Duplicate(Nullable<Guid>) Method

Creates a duplicate of the current object, optionally with a new GUID.

public DiGi.Core.Interfaces.IGuidObject? Duplicate(System.Nullable<System.Guid> guid=null);

Parameters

guid System.Nullable<System.Guid>

The optional GUID to assign to the duplicated object.

Implements Duplicate(Nullable<Guid>)

Returns

DiGi.Core.Interfaces.IGuidObject
A duplicate of the current object as an DiGi.Core.Interfaces.IGuidObject, or null if duplication fails.

ParametrizedObject Class

Class ParametrizedObject.

public class ParametrizedObject : DiGi.Core.Classes.SerializableObject, DiGi.Core.Parameter.Interfaces.IParametrizedObject, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObject → ParametrizedObject

Derived
ParametrizedGuidObject
ParametrizedUniqueIdObject

Implements IParametrizedObject, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject

Constructors

ParametrizedObject() Constructor

Initializes a new instance of the ParametrizedObject class.

public ParametrizedObject();

ParametrizedObject(ParameterGroupCollection) Constructor

Initializes a new instance of the ParametrizedObject class using a parameter group collection.

public ParametrizedObject(DiGi.Core.Parameter.Classes.ParameterGroupCollection? parameterGroupCollection);

Parameters

parameterGroupCollection ParameterGroupCollection

The parameter group collection to use for initialization.

ParametrizedObject(ParametrizedObject) Constructor

Initializes a new instance of the ParametrizedObject class by copying another parametrized object.

public ParametrizedObject(DiGi.Core.Parameter.Classes.ParametrizedObject? parametrizedObject);

Parameters

parametrizedObject ParametrizedObject

The parametrized object to copy from.

ParametrizedObject(IEnumerable<Parameter>) Constructor

Initializes a new instance of the ParametrizedObject class using a collection of parameters.

public ParametrizedObject(System.Collections.Generic.IEnumerable<DiGi.Core.Parameter.Classes.Parameter>? parameters);

Parameters

parameters System.Collections.Generic.IEnumerable<Parameter>

The collection of parameters to initialize the object with.

ParametrizedObject(JsonObject) Constructor

Initializes a new instance of the ParametrizedObject class from a JSON object.

public ParametrizedObject(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize from.

Properties

ParametrizedObject.ParameterGroupCollection Property

Gets the parameter group collection.

public DiGi.Core.Parameter.Classes.ParameterGroupCollection ParameterGroupCollection { get; }

Property Value

ParameterGroupCollection

Methods

ParametrizedObject.Clone() Method

Creates a deep copy of the parametrized object.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A new cloned instance of the parametrized object.

ParametrizedObject.Contains(IParameterDefinition) Method

Determines whether the object contains a parameter associated with the specified definition.

public bool Contains(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition);

Parameters

parameterDefinition IParameterDefinition

The parameter definition to search for.

Returns

System.Boolean
True if the object contains a parameter associated with the specified definition; otherwise, false.

ParametrizedObject.Contains(string) Method

Determines whether the object contains a parameter with the specified unique identifier.

public bool Contains(string? uniqueId);

Parameters

uniqueId System.String

The unique identifier of the parameter to search for.

Returns

System.Boolean
True if the object contains a parameter with the specified unique identifier; otherwise, false.

ParametrizedObject.GetParameterDefinitions(string, TextComparisonType, bool) Method

Retrieves a list of parameter definitions that match the specified name and comparison criteria.

public System.Collections.Generic.List<DiGi.Core.Parameter.Interfaces.IParameterDefinition>? GetParameterDefinitions(string? parameterName, DiGi.Core.Enums.TextComparisonType textComparisonType=DiGi.Core.Enums.TextComparisonType.Equals, bool caseSensitive=true);

Parameters

parameterName System.String

The name of the parameters to search for.

textComparisonType DiGi.Core.Enums.TextComparisonType

The type of text comparison to use.

caseSensitive System.Boolean

A value indicating whether the comparison should be case-sensitive.

Returns

System.Collections.Generic.List<IParameterDefinition>
A list of parameter definitions that match the specified criteria, or null if none are found.

ParametrizedObject.GetParameterDefinitions<TParameterDefinition>() Method

Retrieves all parameter definitions of type TParameterDefinition.

public System.Collections.Generic.List<TParameterDefinition>? GetParameterDefinitions<TParameterDefinition>()
    where TParameterDefinition : DiGi.Core.Parameter.Interfaces.IParameterDefinition;

Type parameters

TParameterDefinition

The type of the parameter definitions to retrieve.

Implements GetParameterDefinitions<TParameterDefinition>()

Returns

System.Collections.Generic.List<TParameterDefinition>
A list of all parameter definitions of the specified type, or null if none are found.

ParametrizedObject.GetParameterDefinitions<TParameterDefinition>(string, TextComparisonType, bool) Method

Retrieves a list of parameter definitions of type TParameterDefinition that match the specified name and comparison criteria.

public System.Collections.Generic.List<TParameterDefinition>? GetParameterDefinitions<TParameterDefinition>(string? parameterName, DiGi.Core.Enums.TextComparisonType textComparisonType=DiGi.Core.Enums.TextComparisonType.Equals, bool caseSensitive=true)
    where TParameterDefinition : DiGi.Core.Parameter.Interfaces.IParameterDefinition;

Type parameters

TParameterDefinition

The type of the parameter definitions to retrieve.

Parameters

parameterName System.String

The name of the parameters to search for.

textComparisonType DiGi.Core.Enums.TextComparisonType

The type of text comparison to use.

caseSensitive System.Boolean

A value indicating whether the comparison should be case-sensitive.

Returns

System.Collections.Generic.List<TParameterDefinition>
A list of parameter definitions that match the specified criteria, or null if none are found.

ParametrizedObject.GetValue(IParameterDefinition, GetValueSettings) Method

Gets the value associated with the specified parameter definition.

public object? GetValue(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

parameterDefinition IParameterDefinition

The parameter definition for which to retrieve the value.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

System.Object
The value associated with the specified parameter definition, or null if not found.

ParametrizedObject.GetValue(string, GetValueSettings) Method

Gets the value associated with the specified unique identifier.

public object? GetValue(string? uniqueId, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

uniqueId System.String

The unique identifier of the value to retrieve.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

System.Object
The value associated with the specified unique identifier, or null if not found.

ParametrizedObject.GetValue(Enum, GetValueSettings) Method

Gets the value associated with the specified enumeration member.

public object? GetValue(System.Enum? @enum, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

enum System.Enum

The enumeration member associated with the value.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

System.Object
The value associated with the specified enumeration member, or null if not found.

ParametrizedObject.GetValue<T>(IParameterDefinition, GetValueSettings) Method

Gets the value of type T associated with the specified parameter definition.

public T? GetValue<T>(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

parameterDefinition IParameterDefinition

The definition of the parameter whose value is to be retrieved.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

T
The value associated with the specified parameter definition, or null if not found.

ParametrizedObject.GetValue<T>(Enum, GetValueSettings) Method

Gets the value of type T associated with the specified enumeration member.

public T? GetValue<T>(System.Enum? @enum, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

enum System.Enum

The enumeration member associated with the value.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

T
The value associated with the specified enumeration member, or null if not found.

ParametrizedObject.Remove(IParameterDefinition) Method

Removes the parameter associated with the specified definition.

public bool Remove(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition);

Parameters

parameterDefinition IParameterDefinition

The definition of the parameter to remove.

Implements Remove(IParameterDefinition)

Returns

System.Boolean
True if the parameter was successfully removed; otherwise, false.

ParametrizedObject.Remove(string) Method

Removes the parameter associated with the specified unique identifier.

public bool Remove(string? uniqueId);

Parameters

uniqueId System.String

The unique identifier of the parameter to remove.

Returns

System.Boolean
True if the parameter was successfully removed; otherwise, false.

ParametrizedObject.SetValue(Parameter) Method

Sets the value using the provided parameter object.

public bool SetValue(DiGi.Core.Parameter.Classes.Parameter? parameter);

Parameters

parameter Parameter

The parameter object containing the value to set.

Returns

System.Boolean
True if the value was successfully set; otherwise, false.

ParametrizedObject.SetValue(IParameterDefinition, object, SetValueSettings) Method

Sets the value for the specified parameter definition.

public bool SetValue(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, object? value, DiGi.Core.Parameter.Classes.SetValueSettings? setValueSettings=null);

Parameters

parameterDefinition IParameterDefinition

The parameter definition.

value System.Object

The value to set.

setValueSettings SetValueSettings

Optional settings for setting the value.

Implements SetValue(IParameterDefinition, object, SetValueSettings)

Returns

System.Boolean
True if the value was successfully set; otherwise, false.

ParametrizedObject.SetValue(string, object, SetValueSettings) Method

Sets the value for the parameter with the specified name.

public bool SetValue(string? name, object? value, DiGi.Core.Parameter.Classes.SetValueSettings? setValueSettings=null);

Parameters

name System.String

The name of the parameter.

value System.Object

The value to set.

setValueSettings SetValueSettings

Optional settings for setting the value.

Returns

System.Boolean
True if the value was successfully set; otherwise, false.

ParametrizedObject.SetValue(Enum, object, SetValueSettings) Method

Sets the value for the specified enumeration member.

public bool SetValue(System.Enum? @enum, object? value, DiGi.Core.Parameter.Classes.SetValueSettings? setValueSettings=null);

Parameters

enum System.Enum

The enumeration member.

value System.Object

The value to set.

setValueSettings SetValueSettings

Optional settings for setting the value.

Returns

System.Boolean
True if the value was successfully set; otherwise, false.

ParametrizedObject.TryGetValue(IParameterDefinition, object, GetValueSettings) Method

Attempts to retrieve the value associated with the specified parameter definition.

public bool TryGetValue(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, out object? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

parameterDefinition IParameterDefinition

The parameter definition associated with the value.

value System.Object

When this method returns, contains the retrieved value if successful; otherwise, null.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParametrizedObject.TryGetValue(string, object, GetValueSettings) Method

Attempts to retrieve the value associated with the specified unique identifier.

public bool TryGetValue(string? uniqueId, out object? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

uniqueId System.String

The unique identifier of the value to retrieve.

value System.Object

When this method returns, contains the retrieved value if successful; otherwise, null.

getValueSettings GetValueSettings

Optional settings for retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParametrizedObject.TryGetValue(Enum, object, GetValueSettings) Method

Attempts to retrieve the value associated with the specified enumeration member.

public bool TryGetValue(System.Enum? @enum, out object? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Parameters

enum System.Enum

The enumeration member associated with the value.

value System.Object

When this method returns, contains the retrieved value if successful; otherwise, null.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParametrizedObject.TryGetValue<T>(IParameterDefinition, T, GetValueSettings) Method

Attempts to retrieve the value of type T associated with the specified parameter definition.

public bool TryGetValue<T>(DiGi.Core.Parameter.Interfaces.IParameterDefinition? parameterDefinition, out T? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

parameterDefinition IParameterDefinition

The parameter definition associated with the value.

value T

When this method returns, contains the retrieved value of type T if successful; otherwise, the default value of T.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Implements TryGetValue<T>(IParameterDefinition, T, GetValueSettings)

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParametrizedObject.TryGetValue<T>(string, T, GetValueSettings) Method

Attempts to retrieve the value of type T associated with the specified unique identifier.

public bool TryGetValue<T>(string? uniqueId, out T? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

uniqueId System.String

The unique identifier for the value.

value T

When this method returns, contains the retrieved value of type T if successful; otherwise, the default value of T.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParametrizedObject.TryGetValue<T>(Enum, T, GetValueSettings) Method

Attempts to retrieve the value of type T associated with the specified enumeration member.

public bool TryGetValue<T>(System.Enum? @enum, out T? value, DiGi.Core.Parameter.Classes.GetValueSettings? getValueSettings=null);

Type parameters

T

The type of the value to retrieve.

Parameters

enum System.Enum

The enumeration member associated with the value.

value T

When this method returns, contains the retrieved value of type T if successful; otherwise, the default value of T.

getValueSettings GetValueSettings

Optional settings to use when retrieving the value.

Returns

System.Boolean
True if the value was successfully retrieved; otherwise, false.

ParametrizedUniqueIdObject Class

Represents an abstract base class for objects that possess both a set of parameters and a unique identifier.

public abstract class ParametrizedUniqueIdObject : DiGi.Core.Parameter.Classes.ParametrizedObject, DiGi.Core.Parameter.Interfaces.IParametrizedUniqueIdObject, DiGi.Core.Parameter.Interfaces.IParametrizedUniqueObject, DiGi.Core.Parameter.Interfaces.IParametrizedObject, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject, DiGi.Core.Interfaces.IUniqueIdObject, DiGi.Core.Interfaces.IUniqueObject

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObjectParametrizedObject → ParametrizedUniqueIdObject

Implements IParametrizedUniqueIdObject, IParametrizedUniqueObject, IParametrizedObject, DiGi.Core.Interfaces.ISerializableObject, DiGi.Core.Interfaces.ICloneableObject<DiGi.Core.Interfaces.ISerializableObject>, DiGi.Core.Interfaces.ICloneableObject, DiGi.Core.Interfaces.IObject, DiGi.Core.Interfaces.IUniqueIdObject, DiGi.Core.Interfaces.IUniqueObject

Constructors

ParametrizedUniqueIdObject() Constructor

Initializes a new instance of the ParametrizedUniqueIdObject class.

public ParametrizedUniqueIdObject();

ParametrizedUniqueIdObject(ParameterGroupCollection) Constructor

Initializes a new instance of the ParametrizedUniqueIdObject class using a parameter group collection.

public ParametrizedUniqueIdObject(DiGi.Core.Parameter.Classes.ParameterGroupCollection? parameterGroupCollection);

Parameters

parameterGroupCollection ParameterGroupCollection

The parameter group collection to use for initialization.

ParametrizedUniqueIdObject(ParametrizedUniqueIdObject) Constructor

Initializes a new instance of the ParametrizedUniqueIdObject class by copying another unique ID parametrized object.

public ParametrizedUniqueIdObject(DiGi.Core.Parameter.Classes.ParametrizedUniqueIdObject? parametrizedUniqueIdObject);

Parameters

parametrizedUniqueIdObject ParametrizedUniqueIdObject

The parametrized unique ID object to copy.

ParametrizedUniqueIdObject(string) Constructor

Initializes a new instance of the ParametrizedUniqueIdObject class with a specified unique identifier.

public ParametrizedUniqueIdObject(string? uniqueId);

Parameters

uniqueId System.String

The unique identifier.

ParametrizedUniqueIdObject(string, ParametrizedUniqueIdObject) Constructor

Initializes a new instance of the ParametrizedUniqueIdObject class with a specific ID and values from another object.

public ParametrizedUniqueIdObject(string? uniqueId, DiGi.Core.Parameter.Classes.ParametrizedUniqueIdObject? parametrizedUniqueIdObject);

Parameters

uniqueId System.String

The unique identifier.

parametrizedUniqueIdObject ParametrizedUniqueIdObject

The parametrized unique ID object to copy values from.

ParametrizedUniqueIdObject(IEnumerable<Parameter>) Constructor

Initializes a new instance of the ParametrizedUniqueIdObject class using a collection of parameters.

public ParametrizedUniqueIdObject(System.Collections.Generic.IEnumerable<DiGi.Core.Parameter.Classes.Parameter>? parameters);

Parameters

parameters System.Collections.Generic.IEnumerable<Parameter>

The collection of parameters to use for initialization.

ParametrizedUniqueIdObject(JsonObject) Constructor

Initializes a new instance of the ParametrizedUniqueIdObject class from a JSON object.

public ParametrizedUniqueIdObject(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize from.

Properties

ParametrizedUniqueIdObject.UniqueId Property

Gets or sets the unique identifier for this object.

public string? UniqueId { get; }

Implements UniqueId

Property Value

System.String

SetValueSettings Class

Contains settings for setting a parameter value.

public class SetValueSettings

Inheritance System.Object → SetValueSettings

Constructors

SetValueSettings() Constructor

Initializes a new instance of the SetValueSettings class.

public SetValueSettings();

SetValueSettings(bool, bool) Constructor

Initializes a new instance of the SetValueSettings class with specified options.

public SetValueSettings(bool tryConvert, bool checkAccessType);

Parameters

tryConvert System.Boolean

Whether to attempt conversion if types do not match.

checkAccessType System.Boolean

Whether to check for write access permissions.

Properties

SetValueSettings.CheckAccessType Property

Gets or sets a value indicating whether the access type should be checked during assignment.

public bool CheckAccessType { get; set; }

Property Value

System.Boolean

SetValueSettings.TryConvert Property

Gets or sets a value indicating whether to attempt conversion of the value during assignment.

public bool TryConvert { get; set; }

Property Value

System.Boolean

SimpleParameterDefinition Class

Represents a definition for a simple parameter.

public class SimpleParameterDefinition : DiGi.Core.Parameter.Classes.ParameterDefinition

Inheritance System.ObjectDiGi.Core.Classes.ObjectDiGi.Core.Classes.SerializableObjectParameterDefinition → SimpleParameterDefinition

Constructors

SimpleParameterDefinition(SimpleParameterDefinition) Constructor

Initializes a new instance of the SimpleParameterDefinition class by copying an existing definition.

public SimpleParameterDefinition(DiGi.Core.Parameter.Classes.SimpleParameterDefinition? simpleParameterDefinition);

Parameters

simpleParameterDefinition SimpleParameterDefinition

The parameter definition to copy from.

SimpleParameterDefinition(string) Constructor

Initializes a new instance of the SimpleParameterDefinition class with the specified name.

public SimpleParameterDefinition(string? name);

Parameters

name System.String

The name of the parameter.

SimpleParameterDefinition(JsonObject) Constructor

Initializes a new instance of the SimpleParameterDefinition class from a JSON object.

public SimpleParameterDefinition(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize the definition from.

Properties

SimpleParameterDefinition.GroupName Property

Gets the name of the group to which this parameter belongs.

public override string GroupName { get; }

Implements GroupName

Property Value

System.String

SimpleParameterDefinition.Name Property

Gets or sets the name of the parameter.

public override string? Name { get; }

Implements Name

Property Value

System.String

SimpleParameterDefinition.ParameterType Property

Gets the type of the parameter.

public override DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Implements ParameterType

Property Value

ParameterType

SimpleParameterDefinition.UniqueId Property

Gets or sets the unique identifier for the parameter.

public override string? UniqueId { get; }

Implements UniqueId

Property Value

System.String

Methods

SimpleParameterDefinition.IsValid(object) Method

Determines whether the specified value is a valid integer parameter value.

public override bool IsValid(object? value);

Parameters

value System.Object

The value to validate.

Implements IsValid(object)

Returns

System.Boolean
True if the value is a valid integer parameter value; otherwise, false.

StringParameterValue Class

Represents a parameter value that holds a string.

public class StringParameterValue : DiGi.Core.Parameter.Classes.ParameterValue

Inheritance System.ObjectSystem.AttributeParameterValue → StringParameterValue

Constructors

StringParameterValue() Constructor

Initializes a new instance of the StringParameterValue class.

public StringParameterValue();

StringParameterValue(bool) Constructor

Initializes a new instance of the StringParameterValue class with specified nullability.

public StringParameterValue(bool nullable);

Parameters

nullable System.Boolean

A value indicating whether the parameter is nullable.

StringParameterValue(StringParameterValue) Constructor

Initializes a new instance of the StringParameterValue class by copying an existing instance.

public StringParameterValue(DiGi.Core.Parameter.Classes.StringParameterValue? stringParameterValue);

Parameters

stringParameterValue StringParameterValue

The existing instance to copy.

StringParameterValue(JsonObject) Constructor

Initializes a new instance of the StringParameterValue class from a JSON object.

public StringParameterValue(System.Text.Json.Nodes.JsonObject? jsonObject);

Parameters

jsonObject System.Text.Json.Nodes.JsonObject

The JSON object to initialize from.

Properties

StringParameterValue.ParameterType Property

Gets the parameter type associated with this string parameter value.

public override DiGi.Core.Parameter.Enums.ParameterType ParameterType { get; }

Property Value

ParameterType

Methods

StringParameterValue.Clone() Method

Creates a clone of the current string parameter value.

public override DiGi.Core.Interfaces.ISerializableObject? Clone();

Implements Clone()

Returns

DiGi.Core.Interfaces.ISerializableObject
A clone of the current string parameter value.

Clone this wiki locally