Professional Documents
Culture Documents
Getting Started With VWG
Getting Started With VWG
Guide
This documentation and any related computer software help programs (hereinafter referred to as the
Documentation) is for the end users informational purposes only and is subject to change or withdrawal by
GIZMOX at any time.
This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in
part, without the prior written consent of GIZMOX. This Documentation is confidential and proprietary information
of GIZMOX and protected by the copyright laws of the United States and international treaties.
Notwithstanding the foregoing, licensed users may print a reasonable number of copies of the Documentation for
their own internal use, and may make one copy of the related software as reasonably required for back-up and
disaster recovery purposes, provided that all GIZMOX copyright notices and legends are affixed to each reproduced
copy. Only authorized employees, consultants, or agents of the user who are bound by the provisions of the license
for the Product are permitted to have access to such copies.
The right to print copies of the Documentation and to make a copy of the related software is limited to the period
during which the applicable license for the Product remains in full force and effect. Should the license terminate for
any reason, it shall be the users responsibility to certify in writing to GIZMOX that all copies and partial copies of
the Documentation have been returned to GIZMOX or destroyed.
EXCEPT AS OTHERWISE STATED IN THE APPLICABLE LICENSE AGREEMENT, TO THE EXTENT PERMITTED BY
APPLICABLE LAW, GIZMOX PROVIDES THIS DOCUMENTATION AS IS WITHOUT WARRANTY OF ANY KIND,
INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL GIZMOX BE LIABLE TO THE END USER OR ANY
THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION,
INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN
IF GIZMOX IS EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE.
The use of any product referenced in the Documentation is governed by the end users applicable license
agreement.
The manufacturer of this Documentation is Gizmox.
Provided with Restricted Rights. Use, duplication or disclosure by the United States Government is subject to the
restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.2277014(b)(3), as applicable, or their successors.
All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
Copyright 2012 Gizmox. All rights reserved.
Contents
Chapter 1: Introduction ..................................................................................................... 6
About this Guide ..................................................................................................................... 6
Requirements ......................................................................................................................... 6
What is Visual WebGui? ........................................................................................................... 7
VWG Integration with Visual Studio ......................................................................................... 10
Integration Tabs .............................................................................................................. 10
Project Templates ............................................................................................................ 12
Item Templates ............................................................................................................... 14
Designer Support ............................................................................................................ 15
Help Resources ..................................................................................................................... 16
The Developers Companion Kit .......................................................................................... 16
The Knowledge Base ........................................................................................................ 20
The Developer Forum ....................................................................................................... 21
Documentation ................................................................................................................ 22
Support .......................................................................................................................... 22
Table of Contents
Table of Contents
Introduction
Chapter 1: Introduction
Requirements
To develop VWG applications, you need to have some theoretical and
practical knowledge of .NET Framework and Visual Studio.
Introduction
Introduction
Visual Development
ASP.NET Infrastructure
Web Server
IIS
VWG
Web Browser
The end result of VWG development process is a pure and rich Web
application, which is efficient, fast, scalable, and secured. The
architecture of the VWG application ensures that no data, business
logic or Web services are either running or exposed on the client side,
since all the data processing is done on the server side.
For more information about VWG you can refer to the following white
papers:
Introduction
Introduction
Integration Tabs
The Integration tabs General, Registration, and Deployment appear in the Property pages of VWG project, as follows:
VWG
Integration
tabs
10
Notes:
Introduction
11
Introduction
Project Templates
Project templates are designed for the various types of VWG C# and
VB.NET projects you can create.
There are two VWG project templates:
Note: Starting with Visual WebGui version 6.3, the project templates
are only available in the Professional Studio.
VWG project templates contain VWG infrastructures, such as compiler
management, and XML protocol structure.
12
Introduction
13
Introduction
Item Templates
Item templates are intended to enable you to extend your VWG
project, by adding to it additional forms, Custom and User controls,
and Themes.
VWG Skinable
Controls
14
Designer Support
The VWG Designer provides a Windows Forms like GUI for the editing
of Forms and other types of controls.
Note: Starting with VWG version 6.3, the Designer is available in
Professional Studio and Express Studio, but not in the SDK version.
Introduction
15
Introduction
Help Resources
VWG provides you with several resources that can help you to easily
and efficiently create VWG applications. These Help resources include:
16
Help Resources
2. Select from the Control list on the left the control you want to use
in your project,
- or
Use the Search box
control.
Introduction
17
Introduction
18
Help Resources
7. To add the example into a form, open the form in Designer View.
Then, from the Toolbox, locate the added component and drag it
onto the form:
Introduction
19
Introduction
20
Help Resources
Introduction
21
Introduction
Documentation
VWG documentation provides you with a set of Guides that describes
and explains how to use VWG. You can download the Guide from the
Downloads page:
http://visualwebgui.com/tabid/515/default.aspx
Support
If you have information that you do not want to share with other users
in the Developer Forum, or if you want to send further material, such
as code samples, docs, images, and apps, you can contact Gizmox
Support at: support@gizmox.com
22
23
- or
On the Start Page of Visual Studio, click the New Project link.
The New Project dialog box appears:
24
For Visual Studio 2008 - you can select any Framework version
between 2.0 and 3.5.
For Visual Studio 2010 - you can only use Framework version
4.0 while working with VWG applications.
25
26
27
To enable VWG:
1. To enable VWG, on the Solution Explorer, right-click the project
and select Enable Visual WebGui from the context menu:
2. To integrate your project into Visual Studio and to work with VWG
Integration options, click the Reload button.
28
VB.NET:
29
30
button.
Note: In VB.NET the files that are included in the Form1 folder are
not displayed by default. To display the files on the Solution
Explorer, click the Show All Files
button.
31
32
2. Verify that the Visual WebGui Form item is selected in the middle
pane, and click the Add button.
A new VWG form is added to the project:
33
The form you defined as a Start Form will be the form that will
appear once you start your application from within Visual Studio.
34
Notes:
All the forms you define as Start Forms using the Set As Start
Form option, will be entry points to your application, unless
you later remove them. The last form you define as a Start
Form, will be the form Visual Studio IDE loads when running
your application from within the IDE.
If you rename a form that you previously defined as a Start
Form, you need to define it again as a Start Form after the
renaming. Alternatively, after the renaming you can change the
name of the Start Form in the Property pages or Web.config
file.
35
36
37
Alternatively, you can select the control in the Toolbox, and then
draw it on the form:
38
39
If the Properties window is not already opened, you can manually open
it.
40
Select the desired property on the Property window, and change its
value:
Note: You can select multiple controls and change their common
properties all at once.
The new property value you entered is applied to the selected
control.
41
42
43
44
45
VB.NET
46
- or
On the Start Page of Visual Studio, click the New Project link.
The New Project dialog box opens:
47
48
You can now start creating the content of the new VWG library.
Note: It is recommended not to store resources, such as images
and other external files, in a library. It is best to store resources
directly in the application. If needed, you can store resources in a
library, but this requires a more advanced setting.
49
50
3. Locate the library you want to add to the solution, and click the
Open button.
The library is added to the solution:
Before you can start using the library, you need to reference it to
the solution, as described in the following section.
51
52
2. On the Add Reference dialog box, open the Projects tab, select
the library you want to add as a reference to the project, and click
OK.
The selected library is added to the References folder of the
project:
53
54
3. On the Add Reference dialog box, open the Browse tab, and
locate the library you want to add as a reference to the project.
Then, open the bin folder of the library, select the library dll file,
and click OK:
55
56
Gizmox.WebGUI.Client
Gizmox.WebGUI.Common
Gizmox.WebGUI.Forms
Gizmox.WebGUI.Server
Gizmox.WebGUI.Forms.Themes
Gizmox.WebGUI.Common.Design
Gizmox.WebGUI.Forms.Design
Gizmox.WebGUI.Forms.Professional
Gizmox.WebGUI.Forms.Office
Gizmox.WebGUI.Forms.Extended
When using "with sources" installation, to work with new features and
functionalities in the Designer, you also need to add as references the
following assemblies:
Gizmox.WebGUI.Forms.Professional.Design
Gizmox.WebGUI.Forms.Office.Design
All of the design-time assemblies are already in the GAC and therefore
you do not need to manually add them as references.
57
2. From the .NET tab or Browse tab of the Add Reference dialog
box, select the assemblies you want to add to your project, and
click OK.
The selected assemblies are added to your project.
Note: Make sure that the Copy Local property of all Gizmox
assemblies is set to True.
58
59
Notes:
60
When using VWG Express Studio for Visual Studio Express and
Visual Web Developer Express, VWG Integration tabs are not
available on the Property pages. For these versions, you
should manually register the controls using the Web.config
file, as described on page 64.
2. Click the Registration tab on the left to open it, and on the
Controls section, click the Add button:
61
62
63
64
65
Note: For the list of available versions, see the Note in the
above section.
66
67
button on
Verify that one of the forms is set as a Start Form (see page 34).
To stop debugging:
Open the Debug menu, and select the Stop Debugging option.
- or
Click the Stop Debugging
68
Note: VWG does not create a new form with the wgx extension.
When the application starts, the wgx extension is automatically added
to the form that was defined as a Start Form.
69
70
71
72
9. Each project needs to have at least one form that is set as the
entry point for the application. To set an entry point, on the
Solution Explorer, right-click the Form1.cs/ Form1.vb, and select
the Set As Start Form option from the context menu:
Note: For more information about the Start Form, see page 34.
10. Open the Designer View by right-clicking the Start Form file, and
selecting View Designer from the context menu.
The form appears in the Designer View.
73
74
12. Design your form by dragging and dropping the appropriate VWG
controls to it:
13. Configure the controls you added by setting their properties using
the Properties window.
14. Add events to the controls, by clicking the Events
button on
the Properties pane, and attaching the required event handlers:
75
15. Add additional events, actions, and functions using the Code
Editor:
16. Save your application, by clicking the Save button on the Standard
toolbar.
17. Start your application by opening the Debug menu and selecting
either the Start Debugging or Start Without Debugging option:
76
77
Notes:
78
79
80
81
11. Open the Designer View by right-clicking the Login.cs file, and
selecting the View Designer option from the context menu.
12. Open the Toolbox, and expand the All Visual WebGui section.
13. Create the following form by dragging and dropping the
appropriate VWG controls to the form:
82
Property
Value
Label
Name
Label1
Text
First Name
Font
Tahoma,Bold
Name
txtFirst
TextBox
Text
Label
TextBox
Name
Label2
Text
Last Name
Font
Tahoma,Bold
Name
txtLast
Text
Button
Label
Name
btnSubmit
Text
Login
Name
lblName
BackColor
White
BorderColor
Black
BorderStyle
Insert
Padding
Text
83
15. Select the form, and on the Properties window of the form, change
the value of the BackColor to LightBlue:
16. At this point, you can run the application and see VWG Login form
appears in your browser. Although this page does not have any
functionality yet, this exercise is a good test to make sure
everything is running up to this point.
To run this sample application, press F5 in your keyboard.
84
You should now see the VWG form you created displayed in your
default browser:
At this stage, you can already enter data into the two text boxes.
However, if you click the Login button, nothing will happen
because you have not set the button to do anything yet. You will
next learn how to make this Login button do something.
Now you should add some code to the button. The code you add
will cause the button to post the data you entered in the text
boxes, and fill in the appropriate data in the label below the button
control.
17. End the application by closing down the browser.
Note: If your default browser is not Internet Explorer, closing the
browser may not stop the application. If the application stays
running after closing the browser, click the Stop button in the
Standard toolbar of Visual Studio.
18. While looking at the Login page in Design View, double-click the
Login button control. The Code Editor is opened with a Click event
for the btnSubmit control.
Note: Double-clicking a control on the Design View registers the
default event of the control, and opens the Code Editor. Since the
default event of a button is a Click event, double-clicking a button
registers this event.
85
19. Now you will add code that retrieves the text property from both
the txtLast and txtFirst text boxes, and places the data into the
label control below the Login button.
20. Fill in the Click event procedure so it looks like the following code:
C#
private void btnSubmit_Click(object sender, EventArgs e)
{
this.lblName.Text = this.txtFirst.Text + " " + this.txtLast.Text;
VB.NET
Private Sub Button1_Click(sender As System.Object, e As System.EventArgs)
Handles btnSubmit.Click
Me.lblName.Text = Me.txtFirst.Text & " " & Me.txtLast.Text
End Sub
86
87
However, when you want to add static images that are located on your
production server to your VWG application, you do not need to enter
their actual URLs. To simplify the referencing of resources located on
the server, VWG has a ResourceHandle class, which converts the
addresses of images that are stored in your project to URLs.
There are different types of ResourceHandles, such as
ImageResourceHandle, IconResourceHandle,
AssemblyResourceHandle, and more. Each of them handles a
specific type of resource, but they all convert a resource reference to a
URL.
Each VWG project has a default location for storing images, and the
ResourceHandle creates URL references to images that are stored
there. All you need to do is to save your images in the default image
location of your project, and to add them to your forms using the
appropriate controls. For each image that is added to a form, an
instance of the ImageResourceHandle is automatically created in
the code, converting the image address to a URL.
You are not, however, required to place images in your project file.
The images can be in any place that can be accessed through the
internet, meaning all they need to have is a valid URL. When adding
images that are located in external locations, you need to use the
UrlResourceHandle, as described on page 101.
88
To create custom folders for other types of resources, see page 96.
89
90
When using VWG Express Studio for Visual Studio Express and
Visual Web Developer Express, Visual WebGui Integration tabs
are not available on the Property pages. For these versions,
you should manually change the default image location using
the Web.config file, in the Directories section.
91
3. On the Property pages, select the General tab on the left to open
it:
92
93
You return to the General tab, where the new folder you defined
appears in the Directories section:
94
95
The images you want to add to your VWG application are now
physically located in the new default folder you created. When you
add them to controls using the Image property, they are located in
the Images sub-folder under the Directories folder:
96
VB.NET
Dim Path As String = Context.Server.MapPath("~/Resources/Documents/Sample.rtf")
' or
Dim Path2 as string = VWGContext.Current.Config.GetDirectory("Documents") +
"Sample.rtf"
97
To add images from the default storage folder in your project, see
the section below.
98
The Images sub-folder displays the images you can add to your
control.
99
3. Select the image you want to add to your control, and click OK.
The image is added to your form:
100
101
VB.NET
Private Sub Form1_Load(sender As System.Object, e As System.EventArgs) Handles
MyBase.Load
Add an image from an external location to the PictureBox control.
Me.PictureBox1.Image = New
Gizmox.WebGUI.Common.Resources.UrlResourceHandle("http://address_of_my_imag
e.jpg");
End Sub
102
4. Save your project and run it. The image you added appears in your
application:
103
104
Notes:
105
106
107
108
The Choose Data Source dialog box allows you to select the data
source and provider you want to use for this connection.
9. Select the Data source and Data provider:
109
11. On the Add Connection dialog box, to add your database file,
click the Browse button to open a File dialog box:
110
14. To save your setting, on the Add Connection dialog box, click OK.
You return to the Choose Your Data Connection page:
Note: If the new data connection does not appear the Choose
Your Data Connection page, select it from the drop-down list.
15. Click Next. The Save the Connection String to the Application
Configuration File page appears:
The name that appears here is the connection name that is added
to the Web.config file.
111
16. Click Next. The Choose Your Database Objects page appears:
112
18. Click Finish to save your selection and close the wizard.
You can now view the data that you added to your project:
113
114
After you build your solution, TableAdapters for the tables and
views you selected are added to the Toolbox:
19. Now you need to add one of the tables to the control.
On the Properties window of the control, click the arrow next to the
DataSource property. Then, from the NORTHWNDDataSet that
appears in the DataSource property, select the table you want to
present:
115
20. Now you need to add a Table Adapter to fill in the table with data.
On the Designer View, select the form. Then, on the Properties
window of the form, click the Events
Load event to the form:
116
21. On the Code Editor, call the Fill method to fill with values the
relevant DataTables in the DataSet using Table Adapters, as
follows:
C#
private void Form1_Load(object sender, EventArgs e)
{
this.customersTableAdapter.Fill(this.nORTHWNDDataSet.Customers);
}
VB.NET
Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
Me.customersTableAdapter.Fill(Me.northWindDataSet.Customers)
End Sub
22. Save the changes you made, and compile and run the application.
The table you added now appears in your VWG application:
117
118
ComboBox control
119
120
121
122
123
13. [Optional] To test the data connection you added, on the Add
Connection dialog box, click the Test Connection button.
14. To save your setting, on the Add Connection dialog box, click OK.
You return to the Choose Your Data Connection page:
15. Click Next. The Save the Connection String to the Application
Configuration File page appears:
The name that appears here is the connection name that is added
to the Web.config file.
124
16. Click Next. The Choose Your Database Objects page appears:
125
18. Click Finish to save your selection and close the wizard.
A bindingSource component is automatically created for the table
you attached to the DataSource, and the value of the
DataSource is bindingSource1:
126
20. Now you need to add a Table Adapter to fill in the list with data.
Open the Properties window of the form. Then, click the Events
button, and register a Load event to the form:
127
21. On the Code Editor, call the Fill method to fill with values the
DataTable in the DataSet using a Table Adapter, as follows:
C#
private void Form1_Load(object sender, EventArgs e)
{
this.customersTableAdapter.Fill(this.nORTHWNDDataSet.Customers);
}
VB.NET
Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
Me.customersTableAdapter.Fill(Me.northWindDataSet.Customers)
End Sub
22. Return to the Design View, and open the Properties window of the
first TextBox control. Then, open the (DataBindings) property,
click the arrow next to its Text property, and select
bindingSource1 CompanyName:
128
23. Open the Properties window of the second TextBox control. Then,
open the (DataBindings) property, click the arrow next to its
Text property, and select bindingSource1 Country:
129
130
131
132
133
134
135
136
12. Build your solution, by opening the Build menu and selecting the
Build Solution option.
The NorthWind DataSet and TableAdapters are added to the
Toolbox:
NorthWind DataSet
OrdersTableAdapter
Order_DetailsTableAdapter
137
138
VB.NET
Private Sub Form1_Load(sender As System.Object, e As System.EventArgs) Handles
MyBase.Load
' Call the Fill method to fill with values the relevant DataTables
' in the DataSet using Table Adapters.
OrdersTableAdapter1.Fill(NorthWind1.Orders)
Order_DetailsTableAdapter1.Fill(NorthWind1.Order_Details)
End Sub
139
140
141
142
143
24. On the Properties window of the DataGridView, set the value of the
IsSelectionChangeCritical property to True:
Note: The IsSelectionChangeCritical property informs the client
whether it should treat some subset of its events as critical or not.
If event is considered as not critical, it will enter into the event
queue, and will not be delivered immediately to the server when it
fires.
144
25. From the Toolbox, drag a second DataGridView control and drop it
onto the form:
145
27. [Optional] Add Label controls above the two DataGridView controls
as headings:
When the user selects an item or a row on the Orders table, its
details appear in the Order Details table.
146
147
To install IIS 6:
Notes:
For both of these platforms, you most likely have to change the
defaults for what will be installed.
148
For Visual Studio 2005 (which requires VWG .NET 2.0) and
Visual Studio 2008 (which requires VWG .NET 3.5) - use
ASP.NET 2.0 framework.
Notes:
For Visual Studio 2010 (which requires VWG .NET 4.0) - use
ASP.NET 4.0.
Notes:
149
Deployment Method
Visual Studio offers an automatic deployment capability. This
automatic deployment procedure copies certain folders and files from
your project folder to the application virtual folder in IIS directory.
However, this automatic deployment operation may leave out files or
folders that are required for your application, and their lack will
prevent you from successfully run your VWG application. Therefore, it
is recommended to perform the deployment steps manually as
described in this Guide, at least when you deploy your VWG
application for the first time.
To create a new folder on IIS for your VWG application, see page
156.
To convert your VWG folder into a Web application, see page 173.
The name you give to your Web application will determine the URL you
will use when accessing it. The URL for your VWG application,
assuming you are using localhost, will be
http://localhost/yourapplication/yourform.wgx
150
Deployment Contents
To deploy your VWG application, you need to copy some of its
contents to the root folder of your application on IIS. This folder will be
c:\inetpub\wwwroot\yourApplication.
Depending on the contents of your VWG application, you need to copy
to IIS the following:
[Mandatory for all VWG applications] bin folder (without the *.pdb
and *.xml files) and Web.config file
Resources folder
Notes:
151
152
3. On the Roles pane, select the Web Server (IIS) check box, and
click Next.
153
4. On the Web Server (IIS) page, click the Role Services link on
the left pane.
The Select Role Services page appears:
154
9. Click the Install button to start installing IIS 7.5, and follow the
wizard steps until the end of the installation.
After the installation is completed, you can start the VWG
deployment procedure, as described in the following sections.
155
156
2. Locate your VWG project folder, and copy the bin and Resources
folders, as well as the Web.config file to
c:\inetpub\wwwroot\VWGApp folder:
157
158
2. Now you can start creating a new application pool for your VWG
application.
On the Connections pane on the left, expand the server node and
select the Application Pools node. Then, on the Actions pane on
the right, click the Add Application Pool link:
159
Note: You can also right-click the Application Pool node on the
Connections pane, and select Add Application Pool from the
context menu.
The Add Application Pool dialog box appears:
Name - You can give the application pool any legal name you
choose. In this case, call the new application pool:
VWGAppPool.
.NET Framework version Select the appropriate .NET
Framework version:
160
Your Add Application Pool dialog box should look similar to the
following:
161
For 32bit Web server a handler mapping for the .NET framework
version you selected for your application pool only.
For 64bit Web server - handler mappings for both 32bit and 64bit,
for the .NET framework version you selected for your application
pool. Although you do not need both 32bit and 64bit for every
application, it is recommended to add handler mappings for both of
them.
The Executables you need for each .NET framework version are as
follows:
162
VisualWebGui_x86_.NET2.0 C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet
_isapi.dll
VisualWebGui_x86_.NET4.0 C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet
_isapi.dll
VisualWebGui_x64_.NET2.0 C:\Windows\Microsoft.NET\Framework64\v2.0.50727\asp
net_isapi.dll
VisualWebGui_x64_.NET4.0 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\asp
net_isapi.dll
163
164
3. To set a handler mapping for VWG .NET 4.0 32bit, right-click the
SimpleHandlerRFactory-ISAPI-4.0_32bit handler, and select
Edit from the context menu:
165
4. On the Edit Script Map dialog box, copy the content of the
Executable box to the clipboard. Then, click OK to close the dialog
box.
You return to the IIS Manager.
5. On the Actions pane on the right, click the Add Script Map
option:
166
Your Add Script Map dialog box should look similar to the
following:
167
10. On the Access Tab, verify that the Script option is selected:
168
13. On the Add Script Map message box, click Yes to add the new
handler mapping.
Your new handler mapping appears in the Handler Mappings
pane:
169
14. Repeat steps 3-12 to set other handler mappings for each .NET
framework version and bit version that you want to support:
The handler mappings for IIS 7.5 are ready, and you can now
proceed to the next step of the deployment procedure.
170
171
172
You now need to convert your VWG folder into a Web application, and
to set the proper application pool for the application.
To convert your VWG Folder into a Web application:
1. On the Connections pane, right-click the VWG folder, and select
Convert to Application from the context menu:
173
2. To set the application pool of the VWG Web application, on the Add
Application dialog box, click the Select button next to the
Application pool box.
The Select Application Pool dialog box appears:
174
175
176
177
Troubleshooting
Chapter 7: Troubleshooting
This chapter describes common problems and provides solutions for
them.
Go to:
178
Troubleshooting
179
Troubleshooting
</switches>
</system.diagnostics>
180
Note: You can also increase the number of the Private Version in
the Web.config file:
<WebGUI>
<PrivateVersion Value="1" />
</WebGUI>
Troubleshooting
181
Troubleshooting
C:\Users\<YourUserName>\AppData\Local\Microsoft\VisualStu
dio\10.0\ProjectAssemblies
C:\Users\<YourUserName>\AppData\Local\Microsoft\WebsiteC
ache
C:\Users\<YourUserName>\AppData\Local\Temp
Notes:
182
IE:
1. Open the Tools menu, and select the Delete browsing
history option.
The Delete Browsing History dialog box appears:
Troubleshooting
183
Troubleshooting
FireFox:
1. Open the Tools menu, and select the Options option.
The Options dialog box opens.
2. On the Options dialog box, click the Privacy option on the
Ribbon bar.
The Privacy pane opens:
184
4. Use the Time range to clear drop-down list at the top of the
dialog box, to select the amount of data you want to delete.
Select the Everything option to delete everything.
5. Select the check box of the Cache option, and click the Clear
Now button.
Note: You do not have to select other items for clearing.
Your cache is cleared, and the Clear Recent History dialog
box is closed.
6. On the Options dialog box, click OK to close it.
Troubleshooting
185
Troubleshooting
Chrome:
1. Click the Customize and control Google Chrome button on
the browser toolbar.
2. Select Tools Clear browsing data.
The Clear Browsing Data dialog box appears:
3. Use the drop-down list at the top of the dialog box, to select
the amount of data you want to delete. Select the beginning
of time option to delete everything.
4. Select the Empty the cache check box.
Note: You do not have to select other items for clearing.
5. Click the Clear browsing data button to clear the cache.
Your cache is cleared, and the Clear Browsing Data dialog
box is closed.
186
If you are running your application from IIS server, you can also get
an Access Denied error.
Possible Cause
No form in the application was set as a Start Form, and therefore there
is no URL entry point to the application.
Solution
Troubleshooting
187
Troubleshooting
Possible Causes
There can be many reasons for this error. The most common ones are:
188
Missing assembly
Caching issues
Solution
To troubleshoot, perform one or all of the following steps:
1. Verify you have referenced Gizmox.WebGUI.Forms.Themes
assembly to your project. Then, verify that the assembly exists in
the bin folder of your application virtual folder (either under your
project folder in Visual Studio, or on IIS virtual folder).
2. Remove the existing references to Gizmox assemblies.
3. Add again references to the required Gizmox assemblies.
Note: These steps are designed to verify that the correct version
of assemblies is referenced, and that the assemblies are referenced
from the correct location.
4. Verify that the Copy Local property of all Gizmox assemblies is set
to True.
5. Verify that every Gizmox assembly (.DLL file) that is referenced in
your project does exist on your application bin folder, and that it is
the correct version of the file.
6. Clear the cache by increasing by one the value of the Private
Version number, as described on step 11, page 180 .
Troubleshooting
189
Troubleshooting
Possible Cause
The form that serves as the entry point to the application is not
registered.
Solution
Every entry point (MainForm) to your VWG application needs to be
registered in the Web.config file, within the Applications section:
<Applications>
<Application Code="Form1" Type="VWG_Application.Form1, 'VWG_Application'"
Authentication="Default" Stateless="False" ForceSSL="False" />
<Application Code="Form2" Type="VWG_Application.Form2, VWG_Application"
Authentication="Default" Stateless="False" ForceSSL="False" />
</Applications>
190
Possible Cause
Your application contains an unregistered control, either a custom
control or VWG control that requires registration (such as Extended or
Office controls). The name of the unregistered control appears in the
error message.
Solution
Register the control whose name appears in the error message, as
described on Registering New Controls, page 59.
Troubleshooting
191
Troubleshooting
Error: The resource you are looking for has been removed, had its name
changed, or is temporarily unavailable
Problem
When you run VWG application from IIS, an error message appears
stating - The resource you are looking for has been removed,
had its name changed, or is temporarily unavailable:
Possible Causes
The form that serves as the entry point to the application is not
registered.
There is no handler mapping for the extension, or the .NET and bit
(32bit/64bit) versions you are using.
Solution
192
Register the form that serves as the entry point to the application
in the Web.config file, as described on page 190.
Troubleshooting
193