Click here to Skip to main content
15,888,600 members
Articles / Programming Languages / C#
Article

Multiple Language Syntax Highlighting, Part 2: C# Control

Rate me:
Please Sign up or sign in to vote.
3.18/5 (16 votes)
12 Mar 20033 min read 247.7K   3K   69   37
Fast and furious colorizing library for source code (C, C++, VBScript, JScript, xml, etc.)

Introduction

This article is an upgrade of the code submitted in Multiple Language Syntax Highlighting, Part 1: JScript, where a syntax highlighting scheme was proposed.

The technique and ideas for parsing have not change and, therefore, I will not explain the parsing/rendering process in this article. The user who would need more detailled can refer the article cited above. I must also point out that this article is intended to replace entirely the Javascript code in a ( near ?) future. 

As the previous article was an exercice to learn JScript, XSL and regular expression, I used this one to get a first contact with C#.

In the rest of the article, I will refer to the Javascript version as v1.0 and the C# as v2.0.

Moving to C#

As a C++ developper, I can tell you I was glad to quit JavaScript and get started with C# who had a much better (C++) flavour.

Wrapping of the JScript methods in a single C# was quite straightforward and doesn't not deserve much comments.  

CodeColorizer Class

This class is the kernel of the parser. You can colorize code using CodeColorizer.ProcessAndHighlightCode( string ).

Having that job done and the ported code running after fairly small time, it was time to use the power of C# and get things better.

New features

Avoiding Regular Expression Object Construction

In the v1.0, regular expression objects were created each time the parser would change context, although the regular expression string was remaining the same. This was leading to a great number of allocation-compilation of Regex objects (although I have question about object pooling, see Open question below).

A first improvement of the library was to store the Regex objects into a HashTable when parsing the syntax. The class implementing this dictionary is Collections.RegexDictionary.

Hence, when parsing, regular expression object do not need to be built and can be retreived in constant time from the table.

Open Question: does .NET cache regular expression strings in a pool ?

Handling the Case

The case sensitivity of a language can be specified using the argument not-case-sensitive={"yes" or "no" (default)} with the node language.

Bencharkming

The parser contains a timer/counter ( see [1] for details ) to bench the transformation. At the end of the article, some benchmarking results are presented. 

Bencharkming quantities are:

  • CodeColorizer.BenchmarkPerChar who returns the number of second to parse a character.
  • CodeColorizer.BenchmarkAvgSec, the parsing time average,
  • CodeColorizer.BenchmarkSec, the last job parsing time

Easier Integration

The library comes with a custom web control that colorizes text.

The Project:

The projects shows the usage of the custom colorizer control. For further details, NDOC documentation has been generated.

You must modify web.config to specify where the xml, xsl files are. See ColorizerLibrary section.

TODO List

Reference

[1]High Performance timer in C#
[2]Multiple Language Syntax Highlighting, Part 1: JScript

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Engineer
United States United States
Jonathan de Halleux is Civil Engineer in Applied Mathematics. He finished his PhD in 2004 in the rainy country of Belgium. After 2 years in the Common Language Runtime (i.e. .net), he is now working at Microsoft Research on Pex (http://research.microsoft.com/pex).

Comments and Discussions

 
GeneralDistributing modified code Pin
Eric Woodruff15-Nov-06 20:12
professionalEric Woodruff15-Nov-06 20:12 
Hi Jonathan,

I've been trying out your C# code colorizer and it works really well. I'd like to use it in the Sandcastle help file builder that I've developed to colorize the example code blocks. In case you don't know, Sandcastle is the new tool from Microsoft used to document .NET assemblies. The help file builder that I developed acts as a front end for it to make it easier to use. It's open source and is hosted at http://www.codeplex.com/SHFB[^]. I've made several additions and changes to the code colorizer and was wondering if you'd mind my distributing the modified source code along with the source for the help file builder. I'll add a credit noting you as the original author in the About box and the help file and reference the original article on Code Project. If there's anything else you'd like me to do, just let me know. Below is a list of the changes I've made so far. Once I'm done, I can send you the modified version if you'd like it.

- Fixed bug in FindRule that caused it to return null if there was only one keyword set in a context.

- Modified XmlHelper to move trailing CR/LF's into their own code tag. This keeps all tags within a single line and we can more easily add line numbering and region folding to the end result.

Changes to highlight.css/.xml/.xsl:

- Reworked the keyword lists to share common keywords amongst similar languages.

- Added support for C# and VB.NET.

- Removed the preprocessor keyword list and added a generic handler for preprocessor directives in each language that needed it.

- Added include file handler for C and C++.

- Added number handler to each languages and the XSL transformation.

- Reworked the VB comment expression and moved the REM keyword into it as well.

- Modified the style names to be generic.

Thanks.

Eric
Generalrunning the demo Pin
Ori-2-Sep-06 3:38
Ori-2-Sep-06 3:38 
Generalsource code Pin
zikha14-Aug-06 0:33
zikha14-Aug-06 0:33 
QuestionHow to integrate into the IDE Pin
Anonymous17-Dec-04 8:05
Anonymous17-Dec-04 8:05 
GeneralC# Syntax Pin
Bassam Abdul-Baki27-Apr-04 3:24
professionalBassam Abdul-Baki27-Apr-04 3:24 
GeneralRe: C# Syntax Pin
Jonathan de Halleux27-Apr-04 3:40
Jonathan de Halleux27-Apr-04 3:40 
GeneralRe: C# Syntax Pin
Bassam Abdul-Baki27-Apr-04 7:20
professionalBassam Abdul-Baki27-Apr-04 7:20 
GeneralRe: C# Syntax Pin
Jonathan de Halleux28-Apr-04 22:19
Jonathan de Halleux28-Apr-04 22:19 
GeneralRe: C# Syntax Pin
Bassam Abdul-Baki29-Apr-04 2:09
professionalBassam Abdul-Baki29-Apr-04 2:09 
GeneralRe: C# Syntax Pin
Jonathan de Halleux29-Apr-04 2:14
Jonathan de Halleux29-Apr-04 2:14 
GeneralHay alguna api para controlar llmadas telefonicas con net2phone Pin
MarcelCH1-Apr-04 6:10
MarcelCH1-Apr-04 6:10 
GeneralRe: Calling C# functions from MFC/C++ Pin
Alex Evans16-Feb-04 9:27
Alex Evans16-Feb-04 9:27 
GeneralRe: Calling C# functions from MFC/C++ Pin
Dave Bacher3-Mar-06 9:01
Dave Bacher3-Mar-06 9:01 
GeneralCalling C# functions from MFC/C++ Pin
Alex Evans15-Feb-04 19:10
Alex Evans15-Feb-04 19:10 
GeneralRe: Calling C# functions from MFC/C++ Pin
Jonathan de Halleux15-Feb-04 21:54
Jonathan de Halleux15-Feb-04 21:54 
QuestionRTF? Pin
Beater23-Jun-03 18:58
Beater23-Jun-03 18:58 
AnswerRe: RTF? Pin
Jonathan de Halleux23-Jun-03 21:07
Jonathan de Halleux23-Jun-03 21:07 
GeneralRe: RTF? Pin
Ricardo Mendes6-Oct-03 8:01
Ricardo Mendes6-Oct-03 8:01 
GeneralRe: RTF? Pin
Jonathan de Halleux6-Oct-03 8:32
Jonathan de Halleux6-Oct-03 8:32 
GeneralOther langages supported Pin
DD le postier31-Mar-03 4:04
DD le postier31-Mar-03 4:04 
GeneralRe: Other langages supported Pin
Jonathan de Halleux28-Jul-03 13:30
Jonathan de Halleux28-Jul-03 13:30 
GeneralGood stuff Pin
Rudi Larno12-Mar-03 21:07
sussRudi Larno12-Mar-03 21:07 
GeneralWhen??? Pin
Jonathan de Halleux13-Mar-03 0:37
Jonathan de Halleux13-Mar-03 0:37 
GeneralIn answer to your open question... Pin
Ceiled12-Mar-03 5:56
Ceiled12-Mar-03 5:56 
GeneralThough! Pin
Jonathan de Halleux12-Mar-03 7:24
Jonathan de Halleux12-Mar-03 7:24 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.