| 1 |
|
|---|
| 2 | Upgrading Instructions for PRADO Framework v3.0.2
|
|---|
| 3 | =================================================
|
|---|
| 4 |
|
|---|
| 5 | !!!IMPORTANT!!!
|
|---|
| 6 |
|
|---|
| 7 | After installing the framework, remember to delete everything under
|
|---|
| 8 | your PRADO application's assets and runtime directories.
|
|---|
| 9 |
|
|---|
| 10 |
|
|---|
| 11 | The following upgrading instructions are cumulative. That is,
|
|---|
| 12 | if you want to upgrade from version A to version C and there is
|
|---|
| 13 | version B between A and C, you need to following the instructions
|
|---|
| 14 | for both A and B.
|
|---|
| 15 |
|
|---|
| 16 |
|
|---|
| 17 | Upgrading from v3.0.1
|
|---|
| 18 | ---------------------
|
|---|
| 19 | - Postback enabled control will always disable default client-side browser action.
|
|---|
| 20 | This is due to google toolbar's interference of event stopping scheme.
|
|---|
| 21 | This modification should only affect user-derived postback javascripts.
|
|---|
| 22 |
|
|---|
| 23 | Upgrading from v3.0.0
|
|---|
| 24 | ---------------------
|
|---|
| 25 | - URL format is modified when THttpRequest.UrlFormat=='Path'.
|
|---|
| 26 | This modification affects both the URLs generated by calling constructUrl()
|
|---|
| 27 | and the URLs understood by PRADO. In particular, PRADO now understands
|
|---|
| 28 | the following URL format:
|
|---|
| 29 | /index.php/ServiceID,ServiceParam/Name1,Value1/Name2,Value2/...
|
|---|
| 30 | In v3.0.0, the above URL is written as:
|
|---|
| 31 | /index.php/ServiceID/ServiceParam/Name1/Value1/Name2/Value2/...
|
|---|
| 32 | - TControl::onBubbleEvent() has been changed to TControl::bubbleEvent().
|
|---|
| 33 | This change only affects user controls that override this method.
|
|---|
| 34 |
|
|---|
| 35 | Upgrading from v3.0.0 RC2
|
|---|
| 36 | -------------------------
|
|---|
| 37 | - Template comment tag is changed from <! ... !> to <!-- ... --!>
|
|---|
| 38 | - Remember to clean up 'assets' directory of your PRADO application
|
|---|
| 39 | as Javascript libraries were updated and client-side validators rewritten.
|
|---|
| 40 |
|
|---|
| 41 |
|
|---|
| 42 | Upgrading from v3.0.0 RC1
|
|---|
| 43 | -------------------------
|
|---|
| 44 | - !!! Expressions appeared in a template are now evaluated in PreRender
|
|---|
| 45 | stage. Previously, for template expressions, they are evaluated during
|
|---|
| 46 | rendering stage, while for property expressions, they are done right
|
|---|
| 47 | after the controls are constructed.
|
|---|
| 48 | - !!! The context of the expressions appeared in a template is changed
|
|---|
| 49 | to the template control. Previously, it is the component/control
|
|---|
| 50 | associated with the expression.
|
|---|
| 51 | - !!! List controls databound with integer-indexed arrays will have
|
|---|
| 52 | the integers as their list item values. Previously, it used the array
|
|---|
| 53 | values as the list item values.
|
|---|
| 54 |
|
|---|
| 55 |
|
|---|
| 56 | Upgrading from v3.0.0 beta
|
|---|
| 57 | --------------------------
|
|---|
| 58 | - THttpSession.UseCustomStorage replaces the previous Storage.
|
|---|
| 59 | - Pagers in TDataGrid are now enclosed within panels. The event indicating
|
|---|
| 60 | their creation is changed to OnPagerCreated instead of OnItemCreated.
|
|---|
| 61 | - TTextHighlighter.EnableCopyCode defaults to false now.
|
|---|
| 62 | - THtmlArea default toolbar and size are modified.
|
|---|
| 63 | - TTarFileExtrator is moved to System.IO
|
|---|
| 64 | Cache classes are moved to System.Caching
|
|---|
| 65 | TXmlDocument is moved to System.Xml
|
|---|
| 66 | TLogger, TLogRouter, TDataFieldAccessor, TSimpleDateFormatter are moved to System.Util
|
|---|
| 67 |
|
|---|
| 68 |
|
|---|
| 69 | Upgrading from v3.0.0 alpha
|
|---|
| 70 | ---------------------------
|
|---|
| 71 | All event names must start with 'On'.
|
|---|
| 72 |
|
|---|
| 73 |
|
|---|
| 74 | Upgrading from v2.x and v1.x
|
|---|
| 75 | ----------------------------
|
|---|
| 76 | PRADO v3.x is not backward compatible with v2.x and v1.x. |
|---|
