UPGRADE


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56


         Upgrading Instructions for PRADO Framework v3.0.0
         =================================================

!!!IMPORTANT!!!

After upgrading, remember to delete everything under
your PRADO application's assets and runtime directories.


The following upgrading instructions are cumulative. That is,
if you want to upgrade from version A to version C and there is
version B between A and C, you need to following the instructions
for both A and B.


Upgrading from v3.0.0 RC2
-------------------------
There should be no compatibility issues.


Upgrading from v3.0.0 RC1
-------------------------
- !!! Expressions appeared in a template are now evaluated in PreRender
  stage. Previously, for template expressions, they are evaluated during
  rendering stage, while for property expressions, they are done right
  after the controls are constructed.
- !!! The context of the expressions appeared in a template is changed
  to the template control. Previously, it is the component/control
  associated with the expression.
- !!! List controls databound with integer-indexed arrays will have
  the integers as their list item values. Previously, it used the array
  values as the list item values.


Upgrading from v3.0.0 beta
--------------------------
- THttpSession.UseCustomStorage replaces the previous Storage.
- Pagers in TDataGrid are now enclosed within panels. The event indicating
  their creation is changed to OnPagerCreated instead of OnItemCreated.
- TTextHighlighter.EnableCopyCode defaults to false now.
- THtmlArea default toolbar and size are modified.
- TTarFileExtrator is moved to System.IO
  Cache classes are moved to System.Caching
  TXmlDocument is moved to System.Xml
  TLogger, TLogRouter, TDataFieldAccessor, TSimpleDateFormatter are moved to System.Util


Upgrading from v3.0.0 alpha
---------------------------
All event names must start with 'On'.


Upgrading from v2.x and v1.x
----------------------------
PRADO v3.x is not backward compatible with v2.x and v1.x.