How to host ActiveX controls in a Web form

Article translations Article translations
Article ID: 317392 - View products that this article applies to.
This article was previously published under Q317392
Expand all | Collapse all

On This Page

SUMMARY

This step-by-step article describes how you can host ActiveX controls in a Web Form of an ASP.NET page.

You can use the drag-and-drop feature of the Microsoft Visual Studio .NET toolbox in an ActiveX control. By using the drag-and-drop feature, you can add the OBJECT tag with the ClassID of the control to the underlying Hypertext Markup Language (HTML) code of the Web Form.

NOTE: ActiveX controls that you host in a Web Form are still downloaded, installed, and run on the client side. These controls cannot run on the server side, as do Web controls.

Requirements

The following list outlines the hardware, software, network infrastructure, and service packs that are required:
  • Microsoft Visual Studio .NET
This article assumes that you are familiar with the following topics:
  • ASP.NET
  • ActiveX controls

Hosting an ActiveX control in ASP.NET

If you add a reference to the ActiveX control by using the Add Reference option, you can create an object of the control type in the code by using the Create Object method. That object runs on the server side, and you can invoke methods of the object. For example, if the return type of the method is binary data, you can write the binary data to the client. Use the BinaryWrite method of the Response objects.

NOTE: The BinaryWrite method calls cannot be made from the client-side script.

If you host an ActiveX control, and you want to access the properties and methods of the ActiveX control on the client side, you must manually modify the HTML code. The HTML code resides behind the ASPX page.

By default, you are working in the Design mode of the ASPX page in the Visual Studio .NET integrated development environment (IDE). To see the HTML version of the page, click the HTML button in the lower left of the Design window.

When you place an ActiveX control on the Web Form, an OBJECT tag is created in the HTML code. A client-side ActiveX control is created when the page is loaded. Because the preceding example is a pure client-side control, the server-side code cannot access this control. Server-side code can access only server controls, which are the controls that are listed on the Web Form tab in the toolbox.

To determine whether a control is a server-side control or a client-side control, see the upper-left corner of the control. By default, a small green arrow in the upper-left corner of the control indicates that the control is located on the server side.

Complete code for hosting a sample ActiveX control in an ASP.NET page

The following example shows how to use the MSChart control on a Web Form in Microsoft Visual Basic .NET. This example changes the width of the chart when the page is loaded. You can view the HTML version of the ASPX page and then copy and paste the following code into the page. This action replaces the original code. To do this, follow these steps:
  1. Create a new ASP.NET Web Application project in Visual Basic .NET. To do this, follow these steps:
    1. On the File menu, click New, and then click Project.
    2. Under Project Types, click Visual Basic Projects.
    3. Under Templates, click ASP.NET Web Application.
  2. You now have an empty Web Form. To see the HTML version of the page, click the HTML button in the lower left of the Design window.
  3. Replace the existing code with the following code:
    <%@ Page SmartNavigation="true"  Language="vb" AutoEventWireup="false" 
    Codebehind="WebForm1.aspx.vb" Inherits="VBWebApp.WebForm1"%>
    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
    <HTML>
    	<HEAD>
    		<title>WebForm1</title>
    		<script language="javascript">
    		function changeWidth(x)
    	         { 
                        x.width = 300
                      }
    		</script>
    	</HEAD>
    	<body MS_POSITIONING="GridLayout">
    	<form id="Form1" method="post" runat="server">
    	        <OBJECT id="chart1" style="
                     Z-INDEX: 102; LEFT: 125px; WIDTH: 484px; 
                     POSITION: absolute; TOP: 85px; HEIGHT: 200px" 
                     onReadyStateChange = "changeWidth(this)"
                     classid="clsid:3A2B370C-BA0A-11D1-B137-0000F8753F5D" VIEWASTEXT>
    	        </OBJECT>
    	</form>
    	</body>
    </HTML>
Alternatively, you can insert the control through the integrated development environment (IDE) by following these steps:
  1. Open the toolbox, and then click the Components tab.
  2. Right-click in any area on the tab, and then click Customize toolbox.
  3. On the COM Components tab, scroll down, and then click to select the Microsoft Chart Control 6.0 (SP4) (OLEDB) check box or a similar entry.
  4. When you finish, a new component called MSChart appears on the Components tab. Drag this control onto the Web Form.
When you finish the preceding steps, you see that the control does not have a green arrow in the upper-left corner. A green arrow means that the control resides on the server side and that the control is accessible from the server-side code.

REFERENCES

For more information about ASP.NET server controls, click the following article number to view the article in the Microsoft Knowledge Base:
306459 ASP.NET server controls overview
For more information about developing Web-based solutions for Microsoft Internet Explorer, visit the following Microsoft Web sites:
http://msdn.microsoft.com/ie/

http://support.microsoft.com/iep

Properties

Article ID: 317392 - Last Review: April 21, 2006 - Revision: 5.1
APPLIES TO
  • Microsoft ASP.NET 1.0
  • Microsoft Internet Explorer 5.01
  • Microsoft Internet Explorer 5.5
  • Microsoft Internet Explorer (Programming) 6.0
Keywords: 
kbctrl kbhowtomaster kbinterop kbwebforms KB317392
Retired KB Content Disclaimer
This article was written about products for which Microsoft no longer offers support. Therefore, this article is offered "as is" and will no longer be updated.

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com