Class FileRender

Inheritance
object
Control
FileRender
Inherited Members
Namespace: DataWeb.Data.Controls
Assembly: DataWeb.Core.dll
Syntax
public class FileRender : Control

Constructors

FileRender(Form, IServiceProvider)

Declaration
public FileRender(Form form, IServiceProvider serviceProvider)
Parameters
Type Name Description
Form form
IServiceProvider serviceProvider

Methods

IsUpdateDataAsync(object, List<ProvidedValue>, Dictionary<string, object>, IUser, string, NavigationContext, CancellationToken)

Determines whether the submitted value for this control should be persisted. Returns true by default; override to conditionally skip persistence (e.g. for read-only or computed controls).

Declaration
public override Task<bool> IsUpdateDataAsync(object value, List<Form.ProvidedValue> providedValues, Dictionary<string, object> sectionData, IUser user, string itemId = null, NavigationContext navigationContext = null, CancellationToken cancellationToken = default)
Parameters
Type Name Description
object value

The submitted value of the control.
List<Form.ProvidedValue> providedValues

All values provided for the form submission.
Dictionary<string, object> sectionData

The section data associated with the current item.
IUser user

The IUser saving the form.
string itemId

The Id of the item being edited, or null when adding a new item.
NavigationContext navigationContext

The NavigationContext of the form, if applicable.
CancellationToken cancellationToken

A token to monitor for cancellation requests.
Returns
Type Description
Task<bool>

A task that returns true if the value should be persisted; otherwise false.
Overrides

ProcessOnGetValueAsync(object, Dictionary<string, object>, IUser, string, NavigationContext, CancellationToken)

Processes the raw stored value before it is returned to the client. Override to apply transformations such as parsing, formatting, or enrichment. The base implementation returns the value unchanged.

Declaration
public override Task<object> ProcessOnGetValueAsync(object value, Dictionary<string, object> sectionData, IUser user, string itemId = null, NavigationContext navigationContext = null, CancellationToken cancellationToken = default)
Parameters
Type Name Description
object value

The raw value retrieved from the data store.
Dictionary<string, object> sectionData

The section data associated with the current item.
IUser user

The IUser requesting the value.
string itemId

The Id of the item to which the value belongs, if applicable.
NavigationContext navigationContext

The NavigationContext, if applicable.
CancellationToken cancellationToken

A token to monitor for cancellation requests.
Returns
Type Description
Task<object>

A task that represents the asynchronous operation and returns the processed value.
Overrides

ValidateAsync(object, List<ProvidedValue>, Dictionary<string, object>, IUser, string, NavigationContext, CancellationToken)

Validates the control value asynchronously. The base implementation checks whether the control is required (via ValidateControlIsRequired(object)) and whether the value matches the declared DataType (via ValidateControlDataType(object)).

Declaration
public override Task<List<ValidationError>> ValidateAsync(object value, List<Form.ProvidedValue> providedValues, Dictionary<string, object> sectionData, IUser user, string itemId = null, NavigationContext navigationContext = null, CancellationToken cancellationToken = default)
Parameters
Type Name Description
object value

The value of the control to validate.
List<Form.ProvidedValue> providedValues

All values provided for the form submission.
Dictionary<string, object> sectionData

The section data associated with the current item.
IUser user

The IUser submitting the form.
string itemId

The Id of the item being edited, or null when adding a new item.
NavigationContext navigationContext

The NavigationContext of the form, if applicable.
CancellationToken cancellationToken

A token to monitor for cancellation requests.
Returns
Type Description
Task<List<ValidationError>>

A task that represents the asynchronous operation and returns the list of validation errors, if any.
Overrides

Extension Methods