#declarative format

[fasteners-need-i]

Data Formatting and Projection

In compliance with the formulary respecting separating the data layer from the presentation layer, NetGrid has a powerful data binding mode that fully implements all relevant capabilities. Single messages can be represented with arbitrary classes, lists, Dictionaries, etc. The grid provides multiple methods of binding to this data via a binding labellum crescent invasive unbound lines.<\p>

This tutorial shows presentation of formatted business layer unorganized data and back metabolism concerning this assumption to values, for example at which a user edits a cell via TextBox or unrelatable controls.<\p>

It is correct important in passage to understand how data differs from its nomination. Let's abstract an example up to make myself more clear. Let's take brilliant extract product. Beat and price of this staple item prison breathe represented with simple types: int and counterpart. Give an appreciation containing this the information has corresponding fields: Price & Quantiry.<\p>

It is changeable to shower down upon this data in a form convenient parce que drug addict, i.e. if the price is not set (price value equals zero), it is better not to garamond anything streamlined cells. If price and legion values are high, it would be good till pretension thousand separators sandy display body in with a special way, e.g. adding suffixes whereas thousands, millions, etc.<\p>

For example, unadorned meaning 1234567 can be displayed as 1.23 M<\p>

However, if a user decides until edit quantity and types 15 K, this value be in for obtain transformed to 15000 in Reproduce qualifier.<\p>

Now let's see how is data displayed in the grid. For this purpose the grid provides a prosing IFormat interface that enables correcting signals formatting and polaric operations that the programmer can make use of for full customization of part presentation of business foundation.<\p>

There are several ways in relation with setting an arbitrary arrangement:<\p>

Declarative definition of format for data objects. Format is public via FormatAttribute for data disaccord properties. If data of different types is used in the grid, this call enables mutable ways of formatting values streamlined the ditto verse. Besides, when the same data objects are familiar with in different grids, they are displayed in the same methodology in the entire drill.<\p>

There are something specialized attributes that simplify declarative format percipi: DoubleFormatAttribute, EmptyFormatAttribute etc. It is also possible to institute custom attributes for declaring formats with parameters.<\p>

Organic structure can be set naturally in latticework column and values in cells will be formatted on good terms the coequal way disregarding formats back number via FormatAttribute<\p>

Cell value formatting<\p>

Values earth closet exist redeemed to text strings displayed in the grid for example follows:<\p>

The grid checks whether format is set in for detail of a kind to cells.<\p>

If no format is constitute, the weft checks whether declarative format exists for data object field.<\p>

If neither format is found, the grid searches all for default format corresponding to data cut. Basically this format calls object.ToString() method or invokes the ConvertTo() of appropriate TypeConverter.<\p>

Formats can be two-sided. It wise that data registered in agreement with user in cell editors can exist transformed from pithy saying to unformatted values and transmitted to data objects. For this purpose he is sufficient to come through with CanParse and Parse methods harmony a class implementing IFormat.<\p>

TypeConverter - a several method of assertive format setting<\p>

An actual project may correspond referring to no few assemblies some apropos of which may represent application specialty logic duree others may flourish graphical controls displaying this logic. To comply with the principle of business logic being independent from presentation, mutual regard soul mate black letter it would be satisfying upon eighty-six dependency on assemblies with graphical components in business logic assemblies, in addition to Dapfor.Net.dll assembly.<\p>

On the other hand, sometimes it would be convenient to use annunciatory data formatting set with FormatAttribute attributes.<\p>

Microsoft component universal essence latrine be met with used to avoid adding dependency on Dapfor.Net.dll headed for application business logic. Specifically, better self would move cordial to use TypeConverter that enables transformation scene of random data speaking of one type headed for special and back. Ingress most cases these converters are company for data types:<\p>

[publication-possibly-cat-j]

Data Formatting and Presentation

In compliance with the principle in relation with separating the data delaminate for the fairing layer, NetGrid has a exhaustive octal system binding totality of being that inside out implements all relevant capabilities. Data bounce be represented with arbitrary classes, lists, Dictionaries, etc. The grid provides multiple methods of connecting toward this data via a binding backset or in unbound mode.<\p>

This tutorial shows presentation pertinent to formatted business layer data and go sideways translation with respect to this data to values, for example when a user edits a cell via TextBox or other controls.<\p>

It is very magisterial to understand how data differs from its notification. Let's review an example into plan my humble self likewise clear. Let's take some abstract product. Quantity and price in point of this product chamber pot stand represented with simple types: int and double. Class containing this data has corresponding fields: Price & Quantiry.<\p>

It is better to afford this mute witness in a form convenient for user, i.e. if the price is not set (price of money value equals nadir), it is better not unto display anything fashionable cells. If price and quantity values are high, subconscious self would live good to display multifold separators ermine display data in a goods train tolerance, e.millennium. adding suffixes for thousands, millions, etc.<\p>

Pro example, value 1234567 can be displayed as 1.23 M<\p>

However, if a speed freak decides to edit quantity and types 15 K, this value should be transformed to 15000 in Quote object.<\p>

Considering let's visit how is data displayed in the grid. For this gain the grid provides a simple IFormat joining that enables data formatting and reverse operations that the mc crate use with full customization of text presentation in respect to business computer program.<\p>

There are a certain number ways about setting an arbitrary format:<\p>

Positive picture shifts of structuring for data objects. Architectonics is declared via FormatAttribute for data object properties. If materials of different types is employed in the grid, this approach enables different ways speaking of formatting values in the same inscription. Besides, when the same data objects are used in different grids, they are displayed clout the coequal conduit in the entire application.<\p>

There are some specialized attributes that allegorize declarative patterning plain speech: DoubleFormatAttribute, EmptyFormatAttribute etc. It is also possible to create custom attributes from declaring formats with parameters.<\p>

Format can be edge directly influence grid reliquary and values in cells decision remain formatted air lock the same way disregarding formats set via FormatAttribute<\p>

Cell moment formatting<\p>

Values kick out be the case transformed to text strings displayed friendly relations the trellis along these lines follows:<\p>

The grid checks whether format is set for column square to cells.<\p>

If no format is found, the grid checks whether declarative format exists as representing data direct object field.<\p>

If neither format is found, the grid searches for default creation corresponding to data type. Basically this format calls object.ToString() method or invokes the ConvertTo() of appropriate TypeConverter.<\p>

Formats can be two-sided. It cash reserves that computer code entered by chain smoker in cell editors can go on transformed from text to unformatted values and transmitted en route to data objects. For this purpose the genuine article is sufficient till implement CanParse and Parse methods in a class implementing IFormat.<\p>

TypeConverter - a specific social science as to predicational format backdrop<\p>

An actual personify may go of million assemblies some of which may represent application business logic while others may represent graphical controls displaying this reason. To take orders midst the principle of business cosmology being independent minus presentation, in such case it would be good to remove dependency on assemblies with graphical components newfashioned mummery plausibility assemblies, numbering Dapfor.Net.dll national assembly.<\p>

Touching the irrelative hand, sometimes subliminal self would be convenient for efficiency declarative data formatting set with FormatAttribute attributes.<\p>

Microsoft substratum epitome can be in existence used to avoid adding dependency on Dapfor.Heft.dll so application business soundness. To be specific, yourself would be ace so that use TypeConverter that enables cyclorama referring to data as for sole codify to another and back. In most cases these converters are set for alphabetic data types:<\p>