C# Class Castle.MonoRail.Framework.Helpers.FormHelper

The FormHelper allows you to output html input elements using the conventions necessary to use the DataBinder on the server side. Ultimately it allows you do to a bi-directional binding -- if used properly.

Elements generation

Buttons Submit(string)
Button(string)
ButtonElement(string) Select Select(string,IEnumerable) Text area TextArea(string) Hidden field HiddenField(string) Checkbox field CheckboxField(string)
CreateCheckboxList(string,IEnumerable) Radio field RadioField(string,object) File upload FileField(string) Text field TextField(string)
TextFieldValue(string, object)
NumberField(string)
NumberFieldValue(string, object) Password field PasswordField(string)
PasswordNumberField(string) Labels LabelFor(string,string)
LabelFor(string,string,IDictionary)

FormValidation
The following operations are related to the Form Validation support:

FormTag(IDictionary) and EndFormTag Opens/close the form tag. They are required to use the form validation DisableValidation Disables validation altogether UseWebValidatorProvider Sets a custom Browser validator provider UsePrototypeValidation Configures the helper to use the prototype easy field validation. Must be invoked before FormTag UsefValidate Configures the helper to use the fValidate. Deprecated. UseZebdaValidation Configures the helper to use the Zebda. Must be invoked before FormTag

Mask support.
For most elements, you can use the entries mask and optionally mask_separator to define a mask for your inputs. Kudos to mordechai Sandhaus - 52action.com

For example: mask='2,5',mask_separator='/' will mask the content to '12/34/1234'

Inheritance: AbstractHelper, IServiceEnabledComponent

Afficher le fichier Open project: nats/castle-1.0.3-mono Class Usage Examples

Protected Properties

Свойство	Type	Description
FieldFlags	BindingFlags
PropertyFlags	BindingFlags
PropertyFlags2	BindingFlags
logger	ILogger

Private Properties

Свойство	Type	Description
AddChecked	void
ApplyFilterOptions	void
ApplyNumberOnlyOptions	void
AreEqual	bool
AssertIsValidArray	void
CheckForExistenceAndExtractIndex	bool
CheckboxItem	string
CollectValidators	IValidator[]
CreateHtmlId	string
GetArrayElement	object
ObtainRootType	System.Type
QueryPropertyInfoRecursive	System.Reflection.PropertyInfo
RemoveChecked	void
ResolveFlagsToUse	BindingFlags
SafeHtmlEncode	string

Méthodes publiques

Méthode	Description
AjaxFormTag ( IDictionary parameters ) : string	Generate Ajax form tag for ajax based form submission. Experimental.
Button ( string value ) : string	Generates an input button element.
Button ( string value, IDictionary attributes ) : string	Generates an input button element.
ButtonElement ( string innerText ) : string	Creates a basic button element of type submit.
ButtonElement ( string innerText, string type ) : string	Creates a basic button element of the specified type.
ButtonElement ( string innerText, string type, IDictionary attributes ) : string	Creates a basic button element of the specified type and with specified attributes.
CheckboxField ( string target ) : string	Generates a checkbox field. In fact it generates two as a way to send a value if the primary checkbox is not checked. This allow the process the be aware of the unchecked value and act accordingly.
CheckboxField ( string target, IDictionary attributes ) : string	Generates a checkbox field. In fact it generates two as a way to send a value if the primary checkbox is not checked. This allow the process the be aware of the unchecked value and act accordingly. The checked and unchecked values sent to the server defaults to true and false. You can override them using the parameters `trueValue` and `falseValue`, but the DataBinder is prepared only to treat boolean arrays.
CreateCheckboxList ( string target, IEnumerable dataSource ) : CheckboxList	Creates a CheckboxList instance which is enumerable. For each interaction you can invoke CheckboxList.Item() which will correctly render a checkbox input element for the current element on the supplied set (`dataSource`). The enumerable item will be an element of the `dataSource`. If the `dataSource` elements are complex objects (ie not string or primitives), supply the parameters `value` and `text` to the dictionary to make the helper use the specified properties to extract the `option` value and content respectively. Usually both the `target` and obviously the `dataSource` are sets with multiple items. The element types tend to be the same. If they are not, you might have to specify the `suffix` parameters on the `attributes` as it would not be inferred.
CreateCheckboxList ( string target, IEnumerable dataSource, IDictionary attributes ) : CheckboxList	Creates a CheckboxList instance which is enumerable. For each interaction you can invoke CheckboxList.Item() which will correctly render a checkbox input element for the current element on the supplied set (`dataSource`). The enumerable item will be an element of the `dataSource`. If the `dataSource` elements are complex objects (ie not string or primitives), supply the parameters `value` and `text` to the dictionary to make the helper use the specified properties to extract the `option` value and content respectively. Usually both the `target` and obviously the `dataSource` are sets with multiple items. The element types tend to be the same. If they are not, you might have to specify the `suffix` parameters on the `attributes` as it would not be inferred.
DisableValidation ( ) : void	Disables the validation.
EndFormTag ( ) : string	Renders an end form element. Should be used if you are using form validation. Some validation approaches uses the end form before or after appending a javascript snippet.
EnumToPairs ( Type enumType ) : string>[].Pair	Creates a list of pairs for the enum type.
FileField ( string target ) : string	Generates an input file element. Dirrently than other operations exposed by this helper, no value is extracted for this operation
FileField ( string target, IDictionary attributes ) : string	Generates an input file element. Dirrently than other operations exposed by this helper, no value is extracted for this operation
FilteredTextField ( string target, IDictionary attributes ) : string	Generates an input text element with a javascript that prevents the chars listed in the forbid attribute from being entered. You must invoke FormHelper.InstallScripts before using it.
FormTag ( IDictionary parameters ) : string	Creates a form tag based on the parameters. Javascript validation can also be bound to the form and\|or elements nested as long as the helper is able to reach the Type of the object used on your view code The action attribute generation will use UrlHelper The parameters are used to build a url and also to form the tag. For notes on the url see DefaultUrlBuilder.BuildUrl(UrlInfo,IDictionary). The other parameters supported follows noaction boolean. Disables the generation of an action method string. The http method to use. Defaults to `post` id string. The form id. More parameters can be accepted depending on the form validation strategy you are using (if any).
FormTag ( string url, IDictionary parameters ) : string	Creates a form tag based on the parameters. Javascript validation can also be bound to the form and\|or elements nested as long as the helper is able to reach the Type of the object used on your view code The action attribute generation will use UrlHelper The following parameters are accepted. method string. The http method to use. Defaults to `post` id string. The form id. More parameters can be accepted depending on the form validation strategy you are using (if any).
HiddenField ( string target ) : string	Generates a hidden form element. The value is extracted from the target (if available)
HiddenField ( string target, IDictionary attributes ) : string	Generates a hidden form element. The value is extracted from the target (if available)
HiddenField ( string target, object value ) : string	Generates a hidden form element with the specified value
HiddenField ( string target, object value, IDictionary attributes ) : string	Generates a hidden form element with the specified value
InstallScripts ( ) : string	Renders a Javascript library inside a single script tag.
LabelFor ( string target, string label ) : string	Generates a label element.
LabelFor ( string target, string label, IDictionary attributes ) : string	Generates a label element.
NumberField ( string target ) : string	Generates an input text element with a javascript that prevents chars other than numbers from being entered. The value is extracted from the target (if available) You must include the formhelper javascript functions to use the NumberField. See InstallScripts
NumberField ( string target, IDictionary attributes ) : string	Generates an input text element with a javascript that prevents chars other than numbers from being entered. The value is extracted from the target (if available) You must include the formhelper javascript functions to use the NumberField. See InstallScripts You can optionally pass an `exceptions` value through the dictionary. It must be a comma separated list of chars that can be accepted on the field. For example: `FormHelper.NumberField("product.price", {exceptions='13,10,11'})` In this case the key codes 13, 10 and 11 will be accepted on the field. You can aslo optionally pass an `forbid` value through the dictionary. It must be a comma separated list of chars that cannot be accepted on the field. For example: `FormHelper.NumberField("product.price", {forbid='46'})` In this case the key code 46 (period) will not be accepted on the field.
NumberFieldValue ( string target, object value ) : string	Generates an input text element with a javascript that prevents chars other than numbers from being entered. The value is not gathered from the context, instead you specify it on the second argument You must include the formhelper javascript functions to use the NumberField. See InstallScripts
NumberFieldValue ( string target, object value, IDictionary attributes ) : string	Generates an input text element with a javascript that prevents chars other than numbers from being entered. The value is not gathered from the context, instead you specify it on the second argument You must include the formhelper javascript functions to use the NumberField. See InstallScripts
PasswordField ( string target ) : string	Generates a password input field.
PasswordField ( string target, IDictionary attributes ) : string	Generates a password input field.
PasswordNumberField ( string target ) : string	Generates an input password element with a javascript that prevents chars other than numbers from being entered. The value is extracted from the target (if available) You must invoke FormHelper.InstallScripts before using it
PasswordNumberField ( string target, IDictionary attributes ) : string	Generates an input password element with a javascript that prevents chars other than numbers from being entered. The value is extracted from the target (if available) You can optionally pass an `exceptions` value through the dictionary. It must be a comma separated list of chars that can be accepted on the field. For example: `FormHelper.NumberField("product.price", {exceptions='13,10,11'})` In this case the key codes 13, 10 and 11 will be accepted on the field. You can aslo optionally pass an `forbid` value through the dictionary. It must be a comma separated list of chars that cannot be accepted on the field. For example: `FormHelper.NumberField("product.price", {forbid='46'})` In this case the key code 46 (period) will not be accepted on the field. You must invoke FormHelper.InstallScripts before using it
Pop ( ) : void	Pops this instance. Experimental.
Push ( string target ) : void	Pushes the specified target. Experimental.
Push ( string target, IDictionary parameters ) : void	Pushes the specified target. Experimental.
RadioField ( string target, object valueToSend ) : string	Generates a radio input type with the specified value to send to the served in case the element in checked. It will automatically check the radio if the target evaluated value is equal to the specified `valueToSend`.
RadioField ( string target, object valueToSend, IDictionary attributes ) : string	Generates a radio input type with the specified value to send to the served in case the element in checked. It will automatically check the radio if the target evaluated value is equal to the specified `valueToSend`.
Select ( string target, IEnumerable dataSource ) : string	Creates a `select` element and its `option`s based on the `dataSource`. If the `dataSource` elements are complex objects (ie not string or primitives), supply the parameters `value` and `text` to the dictionary to make the helper use the specified properties to extract the `option` value and content respectively. You can also specify the attribute `firstoption` to force the first option be something like 'please select'. You can set the value of `firstoption` by specifying the attribute `firstoptionvalue`. The default value is '0'. Usually the `target` is a single value and the `dataSource` is obviously a set with multiple items. The element types tend to be the same. If they are not, you might have to specify the `suffix` parameters on the `attributes` as it would not be inferred. The target can also be a set. In this case the intersection will be the initially selected elements.
Select ( string target, IEnumerable dataSource, IDictionary attributes ) : string	Creates a `select` element and its `option`s based on the `dataSource`. If the `dataSource` elements are complex objects (ie not string or primitives), supply the parameters `value` and `text` to the dictionary to make the helper use the specified properties to extract the `option` value and content respectively. You can also specify the attribute `firstoption` to force the first option be something like 'please select'. You can set the value of `firstoption` by specifying the attribute `firstoptionvalue`. The default value is '0'. Usually the `target` is a single value and the `dataSource` is obviously a set with multiple items. The element types tend to be the same. If they are not, you might have to specify the `suffix` parameters on the `attributes` as it would not be inferred. The target can also be a set. In this case the intersection will be the initially selected elements.
Select ( string target, object selectedValue, IEnumerable dataSource, IDictionary attributes ) : string	Creates a `select` element and its `option`s based on the `dataSource`. If the `dataSource` elements are complex objects (ie not string or primitives), supply the parameters `value` and `text` to the dictionary to make the helper use the specified properties to extract the `option` value and content respectively. You can also specify the attribute `firstoption` to force the first option be something like 'please select'. You can set the value of `firstoption` by specifying the attribute `firstoptionvalue`. The default value is '0'. Usually the `target` is a single value and the `dataSource` is obviously a set with multiple items. The element types tend to be the same. If they are not, you might have to specify the `suffix` parameters on the `attributes` as it would not be inferred. The target can also be a set. In this case the intersection will be the initially selected elements.
Service ( IServiceProvider provider ) : void	Invoked by the framework in order to give a chance to obtain other services
Submit ( string value ) : string	Generates an input submit element.
Submit ( string value, IDictionary attributes ) : string	Generates an input submit element.
TextArea ( string target ) : string	Generates a textarea element. The value is extracted from the target (if available)
TextArea ( string target, IDictionary attributes ) : string	Generates a textarea element. The value is extracted from the target (if available)
TextAreaValue ( string target, object value, IDictionary attributes ) : string	Generates a textarea element with a specified value.
TextField ( string target ) : string	Generates an input text element. The value is extracted from the target (if available)
TextField ( string target, IDictionary attributes ) : string	Generates an input text element. The value is extracted from the target (if available)
TextFieldValue ( string target, object value ) : string	Generates an input text form element with the supplied value
TextFieldValue ( string target, object value, IDictionary attributes ) : string	Generates an input text form element with the supplied value
UsePrototypeValidation ( ) : void	Configures this FormHelper instance to use Prototype for form fields validation
UseWebValidatorProvider ( IBrowserValidatorProvider provider ) : void	Configures this FormHelper instance to use the supplied web validator to generate field validation.
UseZebdaValidation ( ) : void	Configures this FormHelper instance to use Zebda for form fields validation
UsefValidate ( ) : void	Configures this FormHelper instance to use fValidate for form fields validation

Méthodes protégées

Méthode	Description
ApplyValidation ( InputElementType inputType, string target, IDictionary &attributes ) : void	Applies the validation.
CreateHtmlId ( IDictionary attributes, string target ) : string	Creates the HTML id.
CreateHtmlId ( IDictionary attributes, string target, bool removeEntry ) : string	Creates the HTML id.
CreateInputElement ( string type, string value, IDictionary attributes ) : string	Creates the input element.
CreateInputElement ( string type, string target, Object value, IDictionary attributes ) : string	Creates the specified input element using the specified parameters to supply the name, value, id and others html attributes.
CreateInputElement ( string type, string id, string target, string value, IDictionary attributes ) : string	Creates the specified input element using the specified parameters to supply the name, value, id and others html attributes.
FormatIfNecessary ( object value, IDictionary attributes ) : string	Formats if necessary.
GenerateSelect ( string target, object selectedValue, IEnumerable dataSource, IDictionary attributes ) : string	Generates the select.
IsPresent ( object value, object initialSetValue, ValueGetter propertyOnInitialSet, bool isMultiple ) : bool	Determines whether the present value matches the value on the initialSetValue (which can be a single value or a set)
ObtainRootInstance ( RequestContext context, string target ) : object	Obtains the root instance.
ObtainRootInstance ( RequestContext context, string target, string &pieces ) : object	Obtains the root instance.
ObtainTargetProperty ( RequestContext context, string target, Action action ) : PropertyInfo	Obtains the target property.
ObtainValue ( RequestContext context, string target ) : object	Queries the context for the target value
ObtainValue ( string target ) : object	Queries the context for the target value
QueryPropertyRecursive ( object rootInstance, string propertyPath, int piece ) : object
RewriteTargetIfWithinObjectScope ( string target ) : string	Rewrites the target if within object scope.

Private Methods

Méthode	Description
AddChecked ( IDictionary attributes ) : void
ApplyFilterOptions ( IDictionary attributes ) : void
ApplyNumberOnlyOptions ( IDictionary attributes ) : void
AreEqual ( object left, object right ) : bool
AssertIsValidArray ( object instance, string property, int index ) : void
CheckForExistenceAndExtractIndex ( string &property, int &index ) : bool
CheckboxItem ( int index, string target, string suffix, Castle.MonoRail.Framework.Helpers.SetItem item, IDictionary attributes ) : string	Outputs a checkbox element (for internal use)
CollectValidators ( RequestContext requestContext, string target ) : IValidator[]
CreateHtmlId ( string name ) : string
GetArrayElement ( object instance, int index ) : object
ObtainRootType ( RequestContext context, string target, string &pieces ) : Type	Obtains the type of the root.
QueryPropertyInfoRecursive ( Type type, string propertyPath, int piece, Action action ) : PropertyInfo
RemoveChecked ( IDictionary attributes ) : void
ResolveFlagsToUse ( Type type ) : BindingFlags
SafeHtmlEncode ( string content ) : string

Method Details

AjaxFormTag() public méthode

Generate Ajax form tag for ajax based form submission. Experimental.

public AjaxFormTag ( IDictionary parameters ) : string
parameters	IDictionary
Résultat	string

ApplyValidation() protected méthode

Applies the validation.

protected ApplyValidation ( InputElementType inputType, string target, IDictionary &attributes ) : void
inputType	InputElementType	Type of the input.
target	string	The target.
attributes	IDictionary	The attributes.
Résultat	void

Button() public méthode

Generates an input button element.

public Button ( string value ) : string
value	string	The value.
Résultat	string

Button() public méthode

Generates an input button element.

public Button ( string value, IDictionary attributes ) : string
value	string	The value.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

ButtonElement() public méthode

Creates a basic button element of type submit.

public ButtonElement ( string innerText ) : string
innerText	string	The inner text of the button element.
Résultat	string

ButtonElement() public méthode

Creates a basic button element of the specified type.

public ButtonElement ( string innerText, string type ) : string
innerText	string	The inner text of the button element.
type	string	The type of the button.
Résultat	string

ButtonElement() public méthode

Creates a basic button element of the specified type and with specified attributes.

public ButtonElement ( string innerText, string type, IDictionary attributes ) : string
innerText	string	The inner text of the button element.
type	string	The type of the button.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

CheckboxField() public méthode

Generates a checkbox field. In fact it generates two as a way to send a value if the primary checkbox is not checked. This allow the process the be aware of the unchecked value and act accordingly.

public CheckboxField ( string target ) : string
target	string	The object to get the value from and to be based on to create the element name.
Résultat	string

CheckboxField() public méthode

Generates a checkbox field. In fact it generates two as a way to send a value if the primary checkbox is not checked. This allow the process the be aware of the unchecked value and act accordingly.

The checked and unchecked values sent to the server defaults to true and false. You can override them using the parameters trueValue and falseValue, but the DataBinder is prepared only to treat boolean arrays.

public CheckboxField ( string target, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

CreateCheckboxList() public méthode

Creates a CheckboxList instance which is enumerable. For each interaction you can invoke CheckboxList.Item() which will correctly render a checkbox input element for the current element on the supplied set (dataSource).

The enumerable item will be an element of the dataSource.

If the dataSource elements are complex objects (ie not string or primitives), supply the parameters value and text to the dictionary to make the helper use the specified properties to extract the option value and content respectively.

Usually both the target and obviously the dataSource are sets with multiple items. The element types tend to be the same. If they are not, you might have to specify the suffix parameters on the attributes as it would not be inferred.

public CreateCheckboxList ( string target, IEnumerable dataSource ) : CheckboxList
target	string	The object to get the value from and to be based on to create the element name.
dataSource	IEnumerable	The set of available elements
Résultat	CheckboxList

CreateCheckboxList() public méthode

The enumerable item will be an element of the dataSource.

public CreateCheckboxList ( string target, IEnumerable dataSource, IDictionary attributes ) : CheckboxList
target	string	The object to get the value from and to be based on to create the element name.
dataSource	IEnumerable	The set of available elements
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	CheckboxList

CreateHtmlId() protected static méthode

Creates the HTML id.

protected static CreateHtmlId ( IDictionary attributes, string target ) : string
attributes	IDictionary	The attributes.
target	string	The target.
Résultat	string

CreateHtmlId() protected static méthode

Creates the HTML id.

protected static CreateHtmlId ( IDictionary attributes, string target, bool removeEntry ) : string
attributes	IDictionary	The attributes.
target	string	The target.
removeEntry	bool	if set to true [remove entry].
Résultat	string

CreateInputElement() protected méthode

Creates the input element.

protected CreateInputElement ( string type, string value, IDictionary attributes ) : string
type	string	The type.
value	string	The value.
attributes	IDictionary	The attributes.
Résultat	string

CreateInputElement() protected méthode

Creates the specified input element using the specified parameters to supply the name, value, id and others html attributes.

protected CreateInputElement ( string type, string target, Object value, IDictionary attributes ) : string
type	string
target	string	The object to get the value from and to be based on to create the element name.
value	Object
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

CreateInputElement() protected méthode

Creates the specified input element using the specified parameters to supply the name, value, id and others html attributes.

protected CreateInputElement ( string type, string id, string target, string value, IDictionary attributes ) : string
type	string
id	string
target	string	The object to get the value from and to be based on to create the element name.
value	string
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

DisableValidation() public méthode

Disables the validation.

public DisableValidation ( ) : void
Résultat	void

EndFormTag() public méthode

Renders an end form element.

Should be used if you are using form validation. Some validation approaches uses the end form before or after appending a javascript snippet.

public EndFormTag ( ) : string
Résultat	string

EnumToPairs() public static méthode

Creates a list of pairs for the enum type.

public static EnumToPairs ( Type enumType ) : string>[].Pair
enumType	System.Type	enum type.
Résultat	string>[].Pair

FileField() public méthode

Generates an input file element.

Dirrently than other operations exposed by this helper, no value is extracted for this operation

public FileField ( string target ) : string
target	string	The object to be based on when creating the element name.
Résultat	string

FileField() public méthode

Generates an input file element.

Dirrently than other operations exposed by this helper, no value is extracted for this operation

public FileField ( string target, IDictionary attributes ) : string
target	string	The object to be based on when creating the element name.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

FilteredTextField() public méthode

Generates an input text element with a javascript that prevents the chars listed in the forbid attribute from being entered.

You must invoke FormHelper.InstallScripts before using it.

public FilteredTextField ( string target, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

FormTag() public méthode

Creates a form tag based on the parameters.

Javascript validation can also be bound to the form and|or elements nested as long as the helper is able to reach the Type of the object used on your view code

The action attribute generation will use UrlHelper

The parameters are used to build a url and also to form the tag. For notes on the url see DefaultUrlBuilder.BuildUrl(UrlInfo,IDictionary). The other parameters supported follows noaction boolean. Disables the generation of an action method string. The http method to use. Defaults to post id string. The form id. More parameters can be accepted depending on the form validation strategy you are using (if any).

public FormTag ( IDictionary parameters ) : string
parameters	IDictionary	The parameters for the tag or for action and form validation generation.
Résultat	string

FormTag() public méthode

Creates a form tag based on the parameters.

Javascript validation can also be bound to the form and|or elements nested as long as the helper is able to reach the Type of the object used on your view code

The action attribute generation will use UrlHelper

The following parameters are accepted. method string. The http method to use. Defaults to post id string. The form id. More parameters can be accepted depending on the form validation strategy you are using (if any).

public FormTag ( string url, IDictionary parameters ) : string
url	string	The hardcoded url.
parameters	IDictionary	The parameters for the tag or for action and form validation generation.
Résultat	string

FormatIfNecessary() protected static méthode

Formats if necessary.

protected static FormatIfNecessary ( object value, IDictionary attributes ) : string
value	object	The value.
attributes	IDictionary	The attributes.
Résultat	string

GenerateSelect() protected méthode

Generates the select.

protected GenerateSelect ( string target, object selectedValue, IEnumerable dataSource, IDictionary attributes ) : string
target	string	The target.
selectedValue	object	The selected value.
dataSource	IEnumerable	The data source.
attributes	IDictionary	The attributes.
Résultat	string

HiddenField() public méthode

Generates a hidden form element.

The value is extracted from the target (if available)

public HiddenField ( string target ) : string
target	string	The object to get the value from and to be based on to create the element name.
Résultat	string

HiddenField() public méthode

Generates a hidden form element.

The value is extracted from the target (if available)

public HiddenField ( string target, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

HiddenField() public méthode

Generates a hidden form element with the specified value

public HiddenField ( string target, object value ) : string
target	string	The object to get the value from and to be based on to create the element name.
value	object	The value for the hidden field
Résultat	string

HiddenField() public méthode

Generates a hidden form element with the specified value

public HiddenField ( string target, object value, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
value	object	The value for the hidden field
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

InstallScripts() public méthode

Renders a Javascript library inside a single script tag.

public InstallScripts ( ) : string
Résultat	string

IsPresent() protected static méthode

Determines whether the present value matches the value on the initialSetValue (which can be a single value or a set)

protected static IsPresent ( object value, object initialSetValue, ValueGetter propertyOnInitialSet, bool isMultiple ) : bool
value	object	Value from the datasource
initialSetValue	object	Value from the initial selection set
propertyOnInitialSet	ValueGetter	Optional. Property to obtain the value from
isMultiple	bool	true if the initial selection is a set
Résultat	bool

LabelFor() public méthode

Generates a label element.

public LabelFor ( string target, string label ) : string
target	string	The object to get the value from and to be based on to create the element name.
label	string	Legend
Résultat	string

LabelFor() public méthode

Generates a label element.

public LabelFor ( string target, string label, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
label	string	Legend
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

NumberField() public méthode

Generates an input text element with a javascript that prevents chars other than numbers from being entered.

The value is extracted from the target (if available)

You must include the formhelper javascript functions to use the NumberField. See InstallScripts

public NumberField ( string target ) : string
target	string	The object to get the value from and to be based on to create the element name.
Résultat	string

NumberField() public méthode

Generates an input text element with a javascript that prevents chars other than numbers from being entered.

The value is extracted from the target (if available)

You must include the formhelper javascript functions to use the NumberField. See InstallScripts

You can optionally pass an exceptions value through the dictionary. It must be a comma separated list of chars that can be accepted on the field. For example:

FormHelper.NumberField("product.price", {exceptions='13,10,11'}) In this case the key codes 13, 10 and 11 will be accepted on the field.

You can aslo optionally pass an forbid value through the dictionary. It must be a comma separated list of chars that cannot be accepted on the field. For example:

FormHelper.NumberField("product.price", {forbid='46'}) In this case the key code 46 (period) will not be accepted on the field.

public NumberField ( string target, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

NumberFieldValue() public méthode

Generates an input text element with a javascript that prevents chars other than numbers from being entered. The value is not gathered from the context, instead you specify it on the second argument

You must include the formhelper javascript functions to use the NumberField. See InstallScripts

public NumberFieldValue ( string target, object value ) : string
target	string	The object to get the value from and to be based on to create the element name.
value	object	The current value to output.
Résultat	string

NumberFieldValue() public méthode

Generates an input text element with a javascript that prevents chars other than numbers from being entered. The value is not gathered from the context, instead you specify it on the second argument

You must include the formhelper javascript functions to use the NumberField. See InstallScripts

public NumberFieldValue ( string target, object value, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
value	object	The current value to output.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

ObtainRootInstance() protected méthode

Obtains the root instance.

protected ObtainRootInstance ( RequestContext context, string target ) : object
context	RequestContext	The context.
target	string	The object to get the value from and to be based on to create the element name.
Résultat	object

ObtainRootInstance() protected méthode

Obtains the root instance.

protected ObtainRootInstance ( RequestContext context, string target, string &pieces ) : object
context	RequestContext	The context.
target	string	The target.
pieces	string	The pieces.
Résultat	object

ObtainTargetProperty() protected méthode

Obtains the target property.

protected ObtainTargetProperty ( RequestContext context, string target, Action action ) : PropertyInfo
context	RequestContext	The context.
target	string	The target.
action	Action	The action.
Résultat	System.Reflection.PropertyInfo

ObtainValue() protected méthode

Queries the context for the target value

protected ObtainValue ( RequestContext context, string target ) : object
context	RequestContext
target	string	The object to get the value from and to be based on to create the element name.
Résultat	object

ObtainValue() protected méthode

Queries the context for the target value

protected ObtainValue ( string target ) : object
target	string	The object to get the value from and to be based on to create the element name.
Résultat	object

PasswordField() public méthode

Generates a password input field.

public PasswordField ( string target ) : string
target	string	The object to get the value from and to be based on to create the element name.
Résultat	string

PasswordField() public méthode

Generates a password input field.

public PasswordField ( string target, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

PasswordNumberField() public méthode

Generates an input password element with a javascript that prevents chars other than numbers from being entered.

The value is extracted from the target (if available)

You must invoke FormHelper.InstallScripts before using it

public PasswordNumberField ( string target ) : string
target	string	The object to get the value from and to be based on to create the element name.
Résultat	string

PasswordNumberField() public méthode

Generates an input password element with a javascript that prevents chars other than numbers from being entered.

The value is extracted from the target (if available)

You can optionally pass an exceptions value through the dictionary. It must be a comma separated list of chars that can be accepted on the field. For example:

FormHelper.NumberField("product.price", {exceptions='13,10,11'}) In this case the key codes 13, 10 and 11 will be accepted on the field.

You can aslo optionally pass an forbid value through the dictionary. It must be a comma separated list of chars that cannot be accepted on the field. For example:

FormHelper.NumberField("product.price", {forbid='46'}) In this case the key code 46 (period) will not be accepted on the field.

You must invoke FormHelper.InstallScripts before using it

public PasswordNumberField ( string target, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

Pop() public méthode

Pops this instance. Experimental.

public Pop ( ) : void
Résultat	void

Push() public méthode

Pushes the specified target. Experimental.

public Push ( string target ) : void
target	string	The target.
Résultat	void

Push() public méthode

Pushes the specified target. Experimental.

public Push ( string target, IDictionary parameters ) : void
target	string	The target.
parameters	IDictionary	The parameters.
Résultat	void

QueryPropertyRecursive() protected méthode

protected QueryPropertyRecursive ( object rootInstance, string propertyPath, int piece ) : object
rootInstance	object
propertyPath	string
piece	int
Résultat	object

RadioField() public méthode

Generates a radio input type with the specified value to send to the served in case the element in checked. It will automatically check the radio if the target evaluated value is equal to the specified valueToSend.

public RadioField ( string target, object valueToSend ) : string
target	string	The object to get the value from and to be based on to create the element name.
valueToSend	object
Résultat	string

RadioField() public méthode

public RadioField ( string target, object valueToSend, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
valueToSend	object
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

RewriteTargetIfWithinObjectScope() protected méthode

Rewrites the target if within object scope.

protected RewriteTargetIfWithinObjectScope ( string target ) : string
target	string	The target.
Résultat	string

Select() public méthode

Creates a select element and its options based on the dataSource. If the dataSource elements are complex objects (ie not string or primitives), supply the parameters value and text to the dictionary to make the helper use the specified properties to extract the option value and content respectively.

You can also specify the attribute firstoption to force the first option be something like 'please select'. You can set the value of firstoption by specifying the attribute firstoptionvalue. The default value is '0'.

Usually the target is a single value and the dataSource is obviously a set with multiple items. The element types tend to be the same. If they are not, you might have to specify the suffix parameters on the attributes as it would not be inferred.

The target can also be a set. In this case the intersection will be the initially selected elements.

public Select ( string target, IEnumerable dataSource ) : string
target	string	The object to get the value from and to be based on to create the element name.
dataSource	IEnumerable	The set of available elements
Résultat	string

Select() public méthode

The target can also be a set. In this case the intersection will be the initially selected elements.

public Select ( string target, IEnumerable dataSource, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
dataSource	IEnumerable	The set of available elements
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

Select() public méthode

The target can also be a set. In this case the intersection will be the initially selected elements.

public Select ( string target, object selectedValue, IEnumerable dataSource, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
selectedValue	object
dataSource	IEnumerable	The set of available elements
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

Service() public méthode

Invoked by the framework in order to give a chance to obtain other services

public Service ( IServiceProvider provider ) : void
provider	IServiceProvider	The service proviver
Résultat	void

Submit() public méthode

Generates an input submit element.

public Submit ( string value ) : string
value	string	The value/caption for the button.
Résultat	string

Submit() public méthode

Generates an input submit element.

public Submit ( string value, IDictionary attributes ) : string
value	string	The value/caption for the button.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

TextArea() public méthode

Generates a textarea element.

The value is extracted from the target (if available)

public TextArea ( string target ) : string
target	string	The object to get the value from and to be based on to create the element name.
Résultat	string

TextArea() public méthode

Generates a textarea element.

The value is extracted from the target (if available)

public TextArea ( string target, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

TextAreaValue() public méthode

Generates a textarea element with a specified value.

public TextAreaValue ( string target, object value, IDictionary attributes ) : string
target	string	The target to base the element name on.
value	object	The value to apply to the field.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

TextField() public méthode

Generates an input text element.

The value is extracted from the target (if available)

public TextField ( string target ) : string
target	string	The object to get the value from and to be based on to create the element name.
Résultat	string

TextField() public méthode

Generates an input text element.

The value is extracted from the target (if available)

public TextField ( string target, IDictionary attributes ) : string
target	string	The object to get the value from and to be based on to create the element name.
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

TextFieldValue() public méthode

Generates an input text form element with the supplied value

public TextFieldValue ( string target, object value ) : string
target	string	The string to be used to create the element name.
value	object	Value to supply to the element (instead of querying the target)
Résultat	string

TextFieldValue() public méthode

Generates an input text form element with the supplied value

public TextFieldValue ( string target, object value, IDictionary attributes ) : string
target	string	The string to be used to create the element name.
value	object	Value to supply to the element (instead of querying the target)
attributes	IDictionary	Attributes for the FormHelper method and for the html element it generates
Résultat	string

UsePrototypeValidation() public méthode

Configures this FormHelper instance to use Prototype for form fields validation

public UsePrototypeValidation ( ) : void
Résultat	void

UseWebValidatorProvider() public méthode

Configures this FormHelper instance to use the supplied web validator to generate field validation.

public UseWebValidatorProvider ( IBrowserValidatorProvider provider ) : void
provider	IBrowserValidatorProvider	The validation provider.
Résultat	void

UseZebdaValidation() public méthode

Configures this FormHelper instance to use Zebda for form fields validation

public UseZebdaValidation ( ) : void
Résultat	void

UsefValidate() public méthode

Configures this FormHelper instance to use fValidate for form fields validation

public UsefValidate ( ) : void
Résultat	void

Property Details

FieldFlags protected_oe static_oe property

Common field flags for reflection

protected static BindingFlags FieldFlags
Résultat	BindingFlags

PropertyFlags protected_oe static_oe property

Common property flags for reflection

protected static BindingFlags PropertyFlags
Résultat	BindingFlags

PropertyFlags2 protected_oe static_oe property

Common property flags for reflection (with declared only)

protected static BindingFlags PropertyFlags2
Résultat	BindingFlags

logger protected_oe property

Logger instance

protected ILogger logger
Résultat	ILogger