home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 February / CHIP_2_98.iso / software / pelne / optionp / iis4_07.cab / ReadMe.txt17 < prev    next >
Text File  |  1997-10-25  |  6KB  |  173 lines
  1.                 Multilingual Simple and Power Samples
  2.                 =====================================
  3.  
  4.  
  5. Table of Contents
  6. =================
  7.  
  8.     Overview
  9.     Developing Components
  10.     Visual Basic 5
  11.     Installation
  12.     Directory List
  13.     Usage
  14.     Sample ASP scripts
  15.     Support
  16.     Change Notes
  17.  
  18.  
  19. Overview
  20. ========
  21.  
  22. Here, for your edification, are two Active Server Pages components,
  23. each implemented in two different environments: C++/ATL (Microsoft
  24. ActiveX Template Library) and Microsoft Visual Basic 5.
  25.  
  26. The implementations are functionally equivalent.  Each implementation
  27. should behave in exactly the same way.  Each implementation is written
  28. in an idiomatic style to demonstrate the best way to implement the
  29. component in that environment.
  30.  
  31. The Simple component has one method (myMethod) and one property
  32. (myProperty), which can be both retrieved (get) and modified (set).
  33. MyMethod converts a string to uppercase; myProperty is a string in the
  34. object that can be get or set.  There is nothing ASP-specific about
  35. the Simple component and, if desired, it could be used from any OLE
  36. container.
  37.  
  38. The Power component (located in the \intermediate directory) is a 
  39. superset of the Simple component.  In addition to myMethod and 
  40. myProperty, it has myPowerMethod and myPowerProperty (gettable but not 
  41. settable), which demonstrate some ASP-specific features.  Two other 
  42. standard but optional ASP methods are also provided: OnStartPage and 
  43. OnEndPage.  These methods bracket the lifetime of a page.  OnStartPage 
  44. is needed to gain access to the intrinsic ASP objects: Request, 
  45. Response, Server, Application, and Session.
  46.  
  47. MyPowerMethod and myPowerProperty make use of the Request and Response
  48. objects: Request to gain access to the ServerVariables collection and
  49. thereby the ScriptName and the HttpUserAgent (user's browser)
  50. variables; Response to write directly back to the user's browser.
  51. MyPowerProperty returns the name of the ASP script from which it was
  52. called.  MyPowerMethod writes a browser-dependent message back to the
  53. user's browser; one for Microsoft Internet Explorer, a different one
  54. for anything else.
  55.  
  56.  
  57. Developing Components
  58. =====================
  59.  
  60. You can develop ASP components in Visual C++, Visual J++, Visual
  61. Basic, or any other language that builds ActiveX COM objects.
  62.  
  63. These samples are written for IIS 4.0.  You must have the latest
  64. version of IIS to compile and use these components.  You must
  65. also have installed Microsoft Transaction Server (part of Windows NT
  66. 4.0 Option Pack).
  67.  
  68.  
  69. Visual Basic 5
  70. ==============
  71.  
  72. These samples requires Visual Basic 5.0.
  73. Follow these steps to build a project:
  74.  
  75. 1) Open the .vbp file in Visual Basic.
  76. 2) From the File menu, select 'Make XXX dll...' and provide a dll name.
  77.  
  78. This procedure will build and register the sample component.
  79.  
  80.  
  81. Installation
  82. ============
  83.  
  84. To install these sample components, you must first compile them with
  85. Microsoft Visual Basic.  No binaries are supplied as these components 
  86. are of interest only to developers.  If you intend to run these 
  87. components on a machine other than the one on which they are compiled, 
  88. you will need to copy the DLLs to the target machine and
  89.     regsvr32 /s /c SAMPLE.dll
  90. (the samples will be registered automatically on the machine they're
  91. built on).
  92.  
  93. If you have trouble registering components, you may be using the
  94. wrong version of RegSvr32.exe.  Please use the version installed by
  95. default in the directory <winnt-dir>\system32\inetsrv.
  96.  
  97.  
  98. Directory List
  99. ==============
  100.  
  101. Directory        Description
  102. ---------        -----------
  103.  
  104.  Simple          Visual Basic 5 Simple Sample
  105.  Intermediate    Visual Basic 5 Power Sample
  106.  
  107.  
  108. Usage
  109. =====
  110.  
  111. To use the samples, simply call Server.CreateObject("IISSample.XXX")
  112. to create the object, where "XXX" is one of
  113.     VB5Simple        VB5Power
  114. Then you may access the object's methods and properties from your ASP
  115. script.  Read any of the sample ASP scripts to discover how to use the
  116. objects.
  117.  
  118.  
  119. Sample ASP scripts
  120. ==================
  121.  
  122. You must copy the sample ASP scripts to a virtual directory (it need
  123. not be a virtual root) on the IIS Server where you have installed the
  124. sample components before they will work.
  125.  
  126.  
  127. Support
  128. =======
  129.  
  130. This component is not officially supported by Microsoft Corporation.
  131. Peer support is available on the Active Server Pages mailing list or on
  132. the microsoft.public.inetserver.iis.activeserverpages newsgroup.
  133.  
  134. To subscribe to the Active Server Pages mailing list, send mail to
  135. listserv@listserv.msn.com with
  136.  
  137. subscribe ActiveServerPages [firstname lastname]
  138.  
  139. in the body of the message, and then follow the directions carefully.
  140. (firstname and lastname are optional.)
  141.  
  142. You can reach the newsgroup through msnews.microsoft.com and other NNTP
  143. servers.
  144.  
  145.  
  146. Change Notes
  147. ============
  148.  
  149. Version 1.0 Beta 1: February 1997
  150. ---------------------------------
  151.  
  152. First release.
  153.  
  154.  
  155. Version 1.0 Beta 2: March 1997
  156. ------------------------------
  157.  
  158. * Fixed Developer Studio makefile problems in C++ components.
  159. * Upgraded to build cleanly with ATL 2.0 (Visual C++ 4.2b) and ATL 2.0 (VC5).
  160. * Better comments in Power components.
  161.  
  162.  
  163. Version 2.0 Beta 3: September 1997
  164. ----------------------------------
  165.  
  166. * Updated for IIS4.0
  167. * Using IObjectContext instead of IScriptingContext.
  168.  
  169.  
  170. Version 2.1: October 1997
  171. -------------------------
  172.  
  173. * Modified for the IIS4.0 SDK release