PRB: JScript .NET Compiler Generates Unexpected Errors for Comments in an .aspx Page

Article translations Article translations
Article ID: 323487 - View products that this article applies to.
This article was previously published under Q323487
This article has been archived. It is offered "as is" and will no longer be updated.
Expand all | Collapse all

On This Page

SYMPTOMS

When server-side code in an .aspx page contains an at sign (@) immediately after a comment statement, the JScript .NET compiler may generate unexpected errors.

The following code demonstrates this scenario:
  Response.Write("working comment"); // comment
  Response.Write("causes error"); //@ comment2
  Response.Write("causes another error"); //@@@comment3
				
  • The first line represents a typical comment, which functions as expected.
  • The JScript .NET compiler generates the following error message for the second line (which contains comment2):
    0x800a046f: Variable 'comment2' has not been declared
  • The JScript .NET compiler generates the following error message for the third line (which contains comment3):
    0x800a03f6: Invalid character

CAUSE

This problem occurs in both scenarios because of the way that JScript .NET implements preprocessor directives. The .aspx page is transformed into a JScript class file with the preprocessor set to on so that JScript can remap line numbers. This means that the "//@" characters are significant.

RESOLUTION

To resolve this problem, make sure that you are aware of how JScript .NET implements preprocessor directives when you write code in an .aspx page.

To work around this problem, you can vary the commenting style a little. However, Microsoft recommends that you not start comment statements with the "//@" characters. Only use this format for preprocessor statements.

The code that follows demonstrates how to use a version of the code from the "Symptoms" section that does not cause any errors. Also, this code includes two forms of JScript .NET conditional compilation to illustrate how JScript .NET preprocessor statements can appear with different comment statement types.
<%
	//Modified version of one of the previous comment statement
        //sample. This variation does not cause the compiler error.
	// @comment2
		


	//Example that uses conditional compilation to illustrate 
	//preprocessor statements in JScript .NET.  
	//@cc_on							
	//@ var thisWorks : boolean = true;
	//@ if(thisWorks){
	//@ Response.Write("<br>This works!<br>");
	//@ }
			
	//Another variation
	/*@if(@_jscript_version >= 5){
		Response.Write("JScript Version: " + @_jscript_version);
	}
	  @end 
	@*/ 
%>
				

STATUS

This behavior is by design.

MORE INFORMATION

Steps to Reproduce the Behavior

  1. Follow these steps to add a new Web Form to your ASP.NET Web Application:
    1. Right-click the project node in Solution Explorer, point to Add, and then click Add Web Form.
    2. In the Name box, type JScriptTest.aspx.
    3. Click Open.
  2. In the Properties window, set the language property for the page to JScript.
  3. Make sure that the HTML tab is selected in the editor, and then add the following server-side code render block to the .aspx page:
    <%
      Response.Write("working comment");      // comment
      Response.Write("causes error");         //@ comment2
      Response.Write("causes another error"); //@@@comment3
    %>
    					
  4. On the File menu, click Save All to save the Web Form and other files that are associated with the project.
  5. On the Build menu, click Build Solution.
  6. Right-click the Web Form page, and then click View in Browser. Notice that you receive error messages in your browser.

REFERENCES

For more information about JScript .NET preprocessor directives, visit the following Microsoft Web site:
Comment Statements
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/jscript7/html/jsstmcomment.asp

Properties

Article ID: 323487 - Last Review: February 27, 2014 - Revision: 2.6
APPLIES TO
  • Microsoft ASP.NET 1.1
  • Microsoft ASP.NET 1.0
  • Microsoft JScript .NET
Keywords: 
kbnosurvey kbarchive kbcompiler kbprb KB323487

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