Gemstone.Expressions

Represents a runtime C# expression evaluator.

Creates a new . C# expression to compile.

Represents a runtime C# expression evaluator.

Creates a new . C# expression to compile.

Represents a runtime C# expression evaluator, strongly typed for a specific return value .

Return value for function based expressions.

Creates a new .

C# expression to compile.

Gets delegate for compiled expression.

Calling this property will automatically compile , if not already compiled.

Gets delegate for compiled expression.

Calling this property will automatically compile , if not already compiled.

Executes compiled based expression.

Calling this method will automatically compile , if not already compiled.

Executes compiled based expression.

Evaluated expression result. Calling this method will automatically compile , if not already compiled.

Represents a runtime C# expression evaluator, strongly typed for a specific return value and instance parameter values .

Return value for function based expressions. Instance parameter used to define expression accessible field values.

Creates a new .

C# expression to compile.

Gets or sets the instance parameter used for defining expression accessible field values, defaults to .

Gets the C# code expression to compile.

Gets the compiled Linq Expression after C# Code Expression is compiled.

Gets or sets the used for compilation.

Gets or sets the instance to use for context variables.

Gets delegate for compiled expression.

Calling this property will automatically compile , if not already compiled.

Gets delegate for compiled expression.

Calling this property will automatically compile , if not already compiled.

Compiles C# .

true for based expressions; otherwise, false for based expressions.

Executes compiled based expression.

Instance parameter with current field values as needed by expression. Calling this method will automatically compile , if not already compiled.

Executes compiled based expression.

Instance parameter with current field values as needed by expression. Evaluated expression result. Calling this method will automatically compile , if not already compiled.

Returns a string that represents the , i.e., the value.

The value.

Represents a dynamic expression context for evaluating expressions with variables and imports.

All variables that can be used in an expression should be defined before the expression is compiled. For compilation, variable values can simply be initialized with default values and then updated later before the expression is evaluated.

Gets the type registry used to resolve imported types for an expression.

Gets the dictionary of variables that can be accessed in an expression.

Gets or sets the default value to use for undefined variables.

Represents a runtime C# expression evaluator, for any return value types and a general purpose .

Creates a new .

C# expression to compile. Expression context used to define expression accessible field values.

Represents a runtime C# expression evaluator, strongly typed for a specific return value and a general purpose .

Return value for function based expressions.

Creates a new .

C# expression to compile. Expression context used to define expression accessible field values.

Represents a runtime C# expression evaluator, strongly typed for a specific return value and an with variables.

Return value for function based expressions. Expression context for variables.

Creates a new .

C# expression to compile. Expression context used to define expression accessible field values.

Gets or sets the instance to use for context variables.

Executes compiled based expression.

Calling this method will automatically compile , if not already compiled. Method automatically applies variables for execution.

Executes compiled based expression.

Evaluated expression result. Calling this method will automatically compile , if not already compiled. Function automatically applies variables for execution.

Defines an interface for types that support context variables.

Gets the dictionary of variable values that can be accessed in an expression.

Gets the dictionary of variable types that can be accessed in an expression.

The namespace organizes all Gemstone library functionality related to runtime expression evaluation.

Defines an attribute that will mark a property or field in an instance type used as context to an as not visible to expressions.

Represents a symbol consisting of a name, and value to be accessible for expressions used with the .

A symbol is used define a local class field whose value is accessible to a compiled expression.

Creates a new .

Name of symbol. of symbol.

Creates a new .

Name of symbol. of symbol. Initial value for symbol.

Gets the symbol name.

Gets the symbol .

Gets or sets the symbol value.

Defines a registry of types and symbols needed for an .

Creates a new .

Gets registered types including explicitly registered types and types for registered symbols.

Gets registered symbols.

Gets value for registered symbol with specified .

Symbol name. Symbol value or null if symbol does not exist.

Sets value for registered symbol with specified , new symbol will be registered if symbol does not exist.

Symbol name. Symbol type.

Gets distinct assemblies for all .

Gets distinct namespaces for all .

Gets distinct static types for all types registered with .

Creates a cloned instance of this .

Cloned instance of this .

Registers a new .

to register. true if the was registered successfully; otherwise, false if the was already registered.

Registers a new .

to register. true if was registered successfully; otherwise, false if was already registered.

Registers a new static , i.e., for access in expressions with static using.

Type to register as a static type. true if the was registered successfully; otherwise, false if the was already registered. Registering a static type will allow the type to be used in expressions without prefixing the type with its name, i.e., referenceable in code via a static using. This is useful for types that are used frequently e.g., Math or Enumerable. Note that adding a static using for a type will automatically register the type via .

Registers a new static , i.e., for access in expressions with static using.

Registers a new or updates an existing .

to register.

Registers a new or updates an existing with specified and .

of . name. value.

Gets a new context instance.

Return value used for generated context type functions. Instance parameter for generated context type functions. Optional instance to use for context variables. New context instance. This method may generate a new runtime type based on registered types and symbols that is compiled into its own assembly and loaded into memory. The same cached type will be returned unless the registered types or symbols change. Since prior compiled assemblies cannot be unloaded, this property should only be called after all the desired types and symbols have been registered.

Gets a new context instance.

Optional instance to use for context variables. Return value used for generated context type functions. Instance parameter for generated context type functions. New context instance. This method may generate a new runtime type based on registered types and symbols that is compiled into its own assembly and loaded into memory. The same cached type will be returned unless the registered types or symbols change. Since prior compiled assemblies cannot be unloaded, this property should only be called after all the desired types and symbols have been registered.

Gets a compiled context type based on registered types and symbols.

Return value used for generated context type functions. Instance parameter for generated context type functions. Optional instance to use for context variables. Compiled context type based on registered types and symbols. This method may generate a new runtime type based on registered types and symbols that is compiled into its own assembly and loaded into memory. The same cached type will be returned unless the registered types or symbols change. Since prior compiled assemblies cannot be unloaded, this property should only be called after all the desired types and symbols have been registered.

Gets a compiled context type based on registered types and symbols.

Optional instance to use for context variables. Return value used for generated context type functions. Instance parameter for generated context type functions. Compiled context type based on registered types and symbols. This method may generate a new runtime type based on registered types and symbols that is compiled into its own assembly and loaded into memory. The same cached type will be returned unless the registered types or symbols change. Since prior compiled assemblies cannot be unloaded, this property should only be called after all the desired types and symbols have been registered.

Gets total count of generated context types.

Defines a C# expression attribute that when evaluated will specify the default value for a property.

Creates a new

C# expression that will evaluate to the desired default value.

Represents an exception related to values.

Creates a new .

Exception message.

Defines an interface for value expression attributes.

Gets C# expression that will evaluate to the desired value.

Use the method to get a per-property based value for use with the . Use to automatically replace any this keywords with Instance to properly reference the modeled .

Gets or sets value that determines if value should be cached after first evaluation. Defaults to false.

Gets or sets the numeric evaluation order for this expression. Defaults to zero.

This is useful for providing an order of operations to evaluations of attributes where one expression may be dependent on another. Note that properties are normally evaluated in the order in which they are defined in the class, but this is not guaranteed, using this attribute allows the order of evaluation to be changed. When no is specified, the sort order for a property will be zero. Properties will be ordered numerically based on this value. For any value that references the this keyword, a positive evaluation order will be required. See .

Gets or sets any to use if the attribute needs to be pre-parsed.

Gets the based value used to update a modeled property.

Property from which attribute was derived. Expression based on source property. This function allows derived attribute implementations to adjust the expression based on property information, e.g., property type. The property update value is typically used to assign expression values to a modeled type. Default implementation should return Expression.

Gets the modeled property based value used to update the .

Property from which attribute was derived. Assignment expression based on source property. This function allows derived attribute implementations to adjust the update value based on property information, e.g., property type. The expression update value is typically used to assign modeled property values back to expressions allowing synchronization of a model with an external source, e.g., a user interface element. Default implementation should return $"Instance.{property.Name}".

Defines an interface used for providing contextual scope when evaluating instances of the .

Type of associated model.

Gets or sets the current instance.

By using the function, expressions can reference the current instance using the this keyword. See .

Contains classes and attributes used for expression modeling.

Defines a C# expression attribute that when evaluated will type convert its value for a property.

This attribute is typically used when synchronizing modeled values to an external sources, e.g., user interface elements.

Gets the return for this .

When value is null, the will be pre-parsed in an attempt to auto-derive the return type. Note that when using this attribute, it often will be necessary to assign the current so that the parser will have access to needed symbols. If the expression's return type is known in advance, it is optimal to provide it in the attribute constructor.

Creates a new

C# expression that will evaluate to the type converted property value. Return type for specified C# ; defaults to null to auto-derive the return type by pre-parsing expression. When the is known in advance, it is optimal to provide it.

Gets the based value used to update a modeled property.

Property from which attribute was derived. Expression based on source property. The property update value is typically used to assign expression values to a modeled type. For example:


            [TypeConvertedValueExpression("Form.maskedTextBoxMessageInterval.Text", typeof(string))]
            public int MessageInterval { get; set; }

Would generate an expression of "Common.TypeConvertFromString(Form.maskedTextBoxMessageInterval.Text, typeof(int))" which would be executed as part of an overall expression that looked like Instance.MessageInterval = Common.TypeConvertFromString(Form.maskedTextBoxMessageInterval.Text, typeof(int)) when called from .

Gets the modeled property based value used to update the .

Property from which attribute was derived. Expression based on source property. The expression update value is typically used to assign modeled property values back to expressions allowing synchronization of a model with an external source, e.g., a user interface element. For example:


            [TypeConvertedValueExpression("Form.maskedTextBoxMessageInterval.Text", typeof(string))]
            public int MessageInterval { get; set; }

Would generate an update expression of "Common.TypeConvertToString(Instance.MessageInterval)" which would be executed as part of an overall expression that looked like Form.maskedTextBoxMessageInterval.Text = Common.TypeConvertToString(Instance.MessageInterval) when called from .

Defines a C# expression attribute that when evaluated will specify an updated value for a property.

Creates a new

C# expression that will evaluate to the desired default value.

Represents a base attribute class for C# expressions that when evaluated will specify a new value for a property.

Creates a new

C# expression that will evaluate to the desired value. Parameter cannot be null.

Represents a parser for instances.

Creates a new .

C# expression to be parsed.

Creates a new from the specified and parameters deriving the base expression value from .

Source instance. Source instance.

Gets the default instance used for evaluating instances.

Returns a flag that determines if the "this" keyword exists with the specified .

Expression to search. true if "this" keyword exists in expression; otherwise, false.

Replaces references to "this" keyword with a specified .

Expression to search. Replacement value for "this" keyword usages. An expression with "this" keywords replaced with specified .

Derives an expression based on info with any this keywords properly referencing value.

Expression to derive, typically from or . Associated instance. Associated instance, typically target property for . Modeled type name, e.g., typeof<T>.FullName. Derived expression with any this keywords properly referencing value. Specified references the this keyword and must specify a positive . Parameter cannot be null.

Represents a typed parser for instances.

Type of associated model.

Creates a new .

C# expression to be parsed.

Creates a new from the specified and parameters deriving the base expression value from .

Source instance. Source instance.

Parses the expression with the provided parameter expression and optional .

Parameter expression used to provide context to parsed instances. Type registry to use when parsing instances, or null to use . true if parsing an action; otherwise, false for a function.

Validates that any static type functionality is initialized.

As long as type defines a parameterless constructor, this method will create an instance of the modeled class so that any defined static functionality will be initialized. Calling this method in advance of the static create or update delegate generation functions will allow modeled types to self-register any custom symbols and types that may be used during evaluation of value expressions attributes, e.g.:


            static MyModel()
            {
                TableOperations<MyModel>.TypeRegistry.RegisterType<MyType>();
            }

true if type supports a parameterless constructor and was successfully initialized; otherwise, false.

Generates a delegate that will create new instance of type applying any specified or instances that are declared on the type properties.

Generates a delegate that will update an instance of type applying any specified or instances that are declared on the type properties. Target instance is accepted as the parameter to the returned delegate .

Generates a delegate that will update an instance of type applying any specified instances that are declared on the type properties. Target instance is accepted as the parameter to the returned delegate .

Generates a delegate that will execute expression assignments on an instance of type where expressions are instances that are declared on the type properties. Target instance is accepted as the parameter to the returned delegate .

Generates a delegate that will update an instance of type assigning values from instances that are declared on the type properties to the property values. Target instance is accepted as the parameter to the returned delegate .

Generates a delegate that will create new instance of type accepting a contextual object parameter applying any specified or instances that are declared on the type properties.

Specific properties to target, or null to target all properties. Type registry to use when parsing instances, or null to use . This function is useful for generating a delegate to a compiled function that will create new objects of type where properties of the type of have been decorated with or attributes. The newly created object will automatically have applied any defined default values as specified by the encountered attributes. The generated delegate takes a parameter to a contextual object useful for providing extra runtime data to attributes; the parameter must be derived from . Any public fields, methods or properties defined in the derived class will be automatically accessible from the expressions declared in the attributes. By default, the expressions will have access to the current instance by referencing the this keyword, which is an alias to . This function will assign evaluated expression values to properties in a newly created model. Generated delegate that will create new instances with default values applied. parameter type.

Generates a delegate that will create new instance of type accepting a contextual object parameter applying any specified or instances that are declared on the type properties.

Generates a delegate that will update an instance of type accepting a contextual object parameter applying any specified or instances that are declared on the type properties. Target instance needs to be assigned to the property prior to call.

Specific properties to target, or null to target all properties. Type registry to use when parsing instances, or null to use . This function is useful for generating a delegate to a compiled function that will update objects of type where properties of the type of have been decorated with or attributes. The updated object will automatically have applied any defined default values as specified by the encountered attributes. The generated delegate takes a parameter to a contextual object useful for providing extra runtime data to attributes; the parameter must be derived from . Any public fields, methods or properties defined in the derived class will be automatically accessible from the expressions declared in the attributes. By default, the expressions will have access to the current instance by referencing the this keyword, which is an alias to . This function will assign evaluated expression values to properties in an existing model. Generated delegate that will update instances with expression values applied. parameter type.

Specific properties to target, or null to target all properties. Type registry to use when parsing instances, or null to use . This function is useful for generating a delegate to a compiled function that will update objects of type where properties of the type of have been decorated with or attributes. The updated object will automatically have applied any defined default values as specified by the encountered attributes. The generated delegate takes a parameter to a contextual object useful for providing extra runtime data to attributes; the parameter must be derived from . Any public fields, methods or properties defined in the derived class will be automatically accessible from the expressions declared in the attributes. By default, the expressions will have access to the current instance by referencing the this keyword, which is an alias to . This function will assign evaluated expression values to properties in an existing model. Generated delegate that will update instances with expression values applied. parameter type. parameter type.

Generates a delegate that will update an instance of type accepting a contextual object parameter applying any specified instances that are declared on the type properties. Target instance needs to be assigned to the property prior to call.

Specific properties to target, or null to target all properties. Type registry to use when parsing instances, or null to use . This function is useful for generating a delegate to a compiled function that will update objects of type where properties of the type of have been decorated with attributes. The updated object will automatically have applied any defined update values as specified by the encountered attributes. The generated delegate takes a parameter to a contextual object useful for providing extra runtime data to attributes; the parameter must be derived from . Any public fields, methods or properties defined in the derived class will be automatically accessible from the expressions declared in the attributes. By default, the expressions will have access to the current instance by referencing the this keyword, which is an alias to . This function will assign evaluated expression values to properties in an existing model. Generated delegate that will update instances with update expression values applied. parameter type.

Specific properties to target, or null to target all properties. Type registry to use when parsing instances, or null to use . This function is useful for generating a delegate to a compiled function that will update objects of type where properties of the type of have been decorated with attributes. The updated object will automatically have applied any defined update values as specified by the encountered attributes. The generated delegate takes a parameter to a contextual object useful for providing extra runtime data to attributes; the parameter must be derived from . Any public fields, methods or properties defined in the derived class will be automatically accessible from the expressions declared in the attributes. By default, the expressions will have access to the current instance by referencing the this keyword, which is an alias to . This function will assign evaluated expression values to properties in an existing model. Generated delegate that will update instances with expression values applied. parameter type. parameter type.

Generates a delegate that will execute expression assignments on an instance of type accepting a contextual object parameter where expressions are instances that are declared on the type properties. Target instance needs to be assigned to the property prior to call.

Specific properties to target, or null to target all properties. Type registry to use when parsing instances, or null to use . This function is useful for generating a delegate to a compiled function that will execute expression assignments on objects of type where properties of the type of have been decorated with attributes. The generated delegate takes a parameter to a contextual object useful for providing extra runtime data to the expressions defined in attributes of type ; the contextual parameter must be derived from . Any public fields, methods or properties defined in the derived class will be automatically accessible from the expressions declared in the attributes. By default, the expressions will have access to the current instance by referencing the this keyword, which is an alias to . Note that the expression in the attribute is expected to evaluate to a property such that it can be assigned the target type property value. This function will assign current modeled property values back to expressions, this is often useful when a model is being synchronized to an external source, e.g., user interface elements. Generated delegate that will execute expression assignments on instances. parameter type.

Specific properties to target, or null to target all properties. Type registry to use when parsing instances, or null to use . This function is useful for generating a delegate to a compiled function that will execute expression assignments on objects of type where properties of the type of have been decorated with attributes. The generated delegate takes a parameter to a contextual object useful for providing extra runtime data to the expressions defined in attributes of type ; the contextual parameter must be derived from . Any public fields, methods or properties defined in the derived class will be automatically accessible from the expressions declared in the attributes. By default, the expressions will have access to the current instance by referencing the this keyword, which is an alias to . Note that the expression in the attribute is expected to evaluate to a property such that it can be assigned the target type property value. This function will assign current modeled property values back to expressions, this is often useful when a model is being synchronized to an external source, e.g., user interface elements. Generated delegate that will execute expression assignments on instances. parameter type. parameter type.

Represent a base class used for providing contextual scope when evaluating instances of the .

This class should be extended with public instance fields that will be automatically exposed to expressions. Type of associated model. The attribute can be used to hide fields and properties from the expression that may be for internal use only.

The namespace organizes all Gemstone library functionality related to expressions. The root expressions namespace also includes common expressions classes, e.g., and .

Runtime C# code compiler.

Compiles C# to a raw .

C# code to compile. References to use for compilation. Compilation options. Assembly name to use. Raw array representing compiled .

Defines a wrapper for static elements and classes.

Creates a new .

Class with static elements.

Provides the implementation for operations that get member values. Classes derived from the class can override this method to specify dynamic behavior for operations such as getting a value for a property.

Provides information about the object that called the dynamic operation. The binder.Name property provides the name of the member on which the dynamic operation is performed. For example, for the Console.WriteLine(sampleObject.SampleProperty) statement, where sampleObject is an instance of the class derived from the class, binder.Name returns "SampleProperty". The binder.IgnoreCase property specifies whether the member name is case-sensitive. The result of the get operation. For example, if the method is called for a property, you can assign the property value to result. true if the operation is successful; otherwise, false. If this method returns false, the run-time binder of the language determines the behavior. (In most cases, a run-time exception is thrown.)

Provides the implementation for operations that invoke a member. Classes derived from the class can override this method to specify dynamic behavior for operations such as calling a method.

Provides information about the dynamic operation. The binder.Name property provides the name of the member on which the dynamic operation is performed. For example, for the statement sampleObject.SampleMethod(100), where sampleObject is an instance of the class derived from the class, binder.Name returns "SampleMethod". The binder.IgnoreCase property specifies whether the member name is case-sensitive. The arguments that are passed to the object member during the invoke operation. For example, for the statement sampleObject.SampleMethod(100), where sampleObject is derived from the class, args[0] is equal to 100. The result of the member invocation. true if the operation is successful; otherwise, false. If this method returns false, the run-time binder of the language determines the behavior. (In most cases, a language-specific run-time exception is thrown.)