Powerbuilder® 11.5 DOCUMENT ID: DC00586-01-1150-01

Deploying Applications and Components to .NET PowerBuilder® 11.5 DOCUMENT ID: DC00586-01-1150-01 LAST REVISED: September 2008 Copyright © 2008 by Sybase, Inc. All rights reserved. This publication pertains to Sybase software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement. To order additional documents, U.S. and Canadian customers should call Customer Fulfillment at (800) 685-8225, fax (617) 229-9845. Customers in other countries with a U.S. license agreement may contact Customer Fulfillment via the above fax number. All other international customers should contact their Sybase subsidiary or local distributor. Upgrades are provided only at regularly scheduled software release dates. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Sybase, Inc. Sybase trademarks can be viewed at the Sybase trademarks page at http://www.sybase.com/detail?id=1011207. Sybase and the marks listed are trademarks of Sybase, Inc. ® indicates registration in the United States of America. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Unicode and the Unicode Logo are registered trademarks of Unicode, Inc. All other company and product names used herein may be trademarks or registered trademarks of their respective companies. Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies. Sybase, Inc., One Sybase Drive, Dublin, CA 94568. Contents About This Book ........................................................................................................................... xi PART 1 CHOOSING A .NET TARGET CHAPTER 1 Overview and Configuration of .NET Targets............................... 3 Choosing a .NET application target ................................................. 3 How .NET deployment works........................................................... 5 Security settings............................................................................... 7 Strong-named assemblies......................................................... 9 Configuring ASP.NET for a .NET project ....................................... 11 Installing IIS............................................................................. 11 Selecting the default ASP.NET version................................... 12 Viewing and modifying global properties in IIS Manager ........ 13 Directory structure on the server ............................................. 14 Setting up a SQL Anywhere database connection.................. 15 Telerik RadControls................................................................. 17 Installing AJAX extensions ...................................................... 17 Windows Vista and Windows 2008 configuration requirements 18 Checklist for deployment................................................................ 21 PART 2 WEB FORMS TARGETS CHAPTER 2 Moving PowerBuilder Applications to the Web ......................... 29 About PowerBuilder Web Forms applications................................ 29 Creating a PowerBuilder .NET Web Forms target ......................... 30 Deploying and running a .NET Web Forms project........................ 34 Sharing data across sessions ........................................................ 38 CHAPTER 3 Client-Side Events and Default Event Handlers......................... 41 About client-side programming....................................................... 41 Default event handlers ................................................................... 43 Deploying Applications and Components to .NET iii Contents Client-side support for the Web DataWindow control .................... 45 Alphabetical list of Web DataWindow client-side events................ 47 ButtonClicked ................................................................................. 48 ButtonClicking ................................................................................ 49 Clicked ........................................................................................... 50 DoubleClicked ................................................................................ 51 ItemChanged.................................................................................. 52 ItemError ........................................................................................ 53 ItemFocusChanged........................................................................ 54 RButtonDown ................................................................................. 55 RowFocusChanged........................................................................ 56 RowFocusChanging....................................................................... 57 CHAPTER 4 User Management and Registry Operations in Web Forms ...... 59 Creating permanent user accounts ................................................ 59 Managing permanent user accounts.............................................. 64 Using the registry functions............................................................ 66 CHAPTER 5 Print, File, Mail Profile, and Theme Managers ............................ 69 Using the Web Forms Print Manager............................................. 69 Print Manager icon display ...................................................... 70 Where printed output is saved................................................. 71 Requirements for saving files in PDF or XSL format............... 72 Installing GPL Ghostscript....................................................... 74 Where PDF and XSL-FO output is saved ............................... 75 Using the Web Forms File Manager .............................................. 75 Using the Web Forms Mail Profile Manager .................................. 82 Using the Web Forms Theme Manager ......................................... 85 CHAPTER 6 Properties for .NET Web Forms ................................................... 87 About Web Forms properties ......................................................... 87 Global Web configuration properties.............................................. 88 Creating custom global properties ................................................. 94 AutoPostBack.......................................................................... 95 Embedded............................................................................... 95 HasFileManager ...................................................................... 96 HasMailManager ..................................................................... 97 HasPrintManager .................................................................... 97 HasThemeManager................................................................. 98 CHAPTER 7 Functions for .NET Web Forms .................................................. 101 About system functions for Web Forms applications ................... 101 iv PowerBuilder Contents DownloadFile ............................................................................... 102 GetConfigSetting.......................................................................... 104 GetDownloadFileURL .................................................................. 104 MapVirtualPath............................................................................. 105 OpenFileManager ........................................................................ 106 OpenMailManager........................................................................ 106 OpenPrintManager....................................................................... 106 OpenThemeManager ................................................................... 107 UploadFiles .................................................................................. 107 CHAPTER 8 Modified and Unsupported Features in Web Forms Projects. 111 About unsupported features......................................................... 111 Unsupported objects .................................................................... 113 Unsupported system functions..................................................... 114 Restrictions on supported controls............................................... 116 Modified display and behavior of visual controls.......................... 127 Unsupported functions for controls in Web Forms ....................... 130 Unsupported events for controls in Web Forms........................... 134 Unsupported properties for controls in Web Forms ..................... 136 PART 3 WINDOWS FORMS TARGETS CHAPTER 9 Deploying PowerBuilder Applications as .NET Windows Forms.. 143 About PowerBuilder .NET Windows Forms applications ............. 143 Creating a .NET Windows Forms target ...................................... 146 Creating a .NET Windows Forms project..................................... 148 Setting properties for a .NET Windows Forms project .......... 148 Intelligent update pages ........................................................ 151 Resource and other required files ........................................

Load more