Click here to Skip to main content
15,868,080 members
Articles / Programming Languages / C#

Standard Regular Expression Searcher Addin For VS.NET 2003

Rate me:
Please Sign up or sign in to vote.
4.88/5 (42 votes)
11 Jan 2005CPOL3 min read 106.7K   930   52   15
Standard Regular Expression Searcher add-in for VS.NET 2003.

Introduction

The "Search and Replace" and "Search in files" in VS.NET support Regular Expression, but the kind of Regular Expression is weak and wired. For instance, it uses some strange symbols like :z, :Lu, and doesn't support position-match like ?!>, ?=. Standard Regular Expression Searcher Add-in has the same functions with "Search and Replace" and "Search in files", and support standard Regular Expression, so by using it, you can take advantage of the power of standard Regular Expression and the convenient usability of VS.NET, and it provides some functions that VS.NET has not, for example, show the context of matched content.

Background

In The Code Project, there are a lot of articles involving how to write VS.NET add-ins, so we don't repeat it. We just use _DTE, TextDocument, TextSelection, EditPoint, and OutputWindowPane.

Using the Add-in

After installing the add-in, You can find a menu item in Tools that is named SearcherAddin, and click it, and then write Regular Expression into the text box for Search.

Sample Image

Click "Replace" button, you can write Regular Expression for replacing to the textbox for Replace.

Sample Image

In "Search Scope", if you select "Active Document" or "All of opened files", the add-in works like "Find and Replace" of VS.NET; if you select "Current project" or "Whole solution" or click Browse button, it works like "Find in files", and executes the command once and closes, and then shows the results into OutputWindowPane and double f on the corresponding line, then opens the relating file and goes to the right position.

Sample Image

If you input "Font Lines" and "Back Lines", the add-in will show the context front and back lines of the matched text in OutputWindowPane.

Sample Image

Sample Image

How to show the results to WindowPane

The "Find in Files" of VS.NET uses FindResult1 and FindResult2 Window to show searching or replacing results, but the DTE component model doesn't expose FindResult1 and FindResult2, so we used OutputWindowPane to do the same thing. We implement OutputWindowPaneWrapper to wrap OutputWindowPane, and encapsulate more functions in it.

C#
public class OutputWindowPaneWrapper
{
    private OutputWindowPane pane;
    private DTE dte;
    ...

We named the OutputWindowPane "Regex Searcher" windowName, and uses this code to initialize it:

C#
private void getWindowPane (string title) {
    Window winItem = this.dte.Windows.Item (Constants.vsWindowKindOutput);
    OutputWindow window = (OutputWindow) winItem.Object;

    try {
        this.pane = window.OutputWindowPanes.Item (title);
    }
    catch(System.ArgumentException) {
        this.pane = window.OutputWindowPanes.Add (title);
    }
}

In order to show OutputWindowPane, first of all, we should activate Output Window of IDE, and activate our specific pane.

C#
public void Activate ()
{
    dte.Windows.Item(Constants.vsWindowKindOutput).Activate();
    this.pane.Activate();
}

Use State Pattern to implement different FindNext in TextWindow

In TextWindow, we use FindNext command to search next matched text, but FindNext will be fairly complicated by virtue of different position and showing different information by all kinds of results, if all of the logic is concentrated in FindNext. If we use enum type to define different states for FindNext, there will be too much switch-case in FindNext and it will be hard to understand and maintain. We chose State Pattern of GOF to tackle it, then all of it becomes clear and easy.

We defined IFindState that includes two methods: FindNext and ShowMessage.

C#
public interface IFindState
{
    void ShowMessage();
    void FindNext(WindowSearcher windowSearcher);
}

We implemented concrete States by deriving from IFindState, it involves FirstFindState, FirstFindSucceededState, FirstFindFailedState, FirstSearchSucceededAndBackToStartPointState and FirstSearchFailedAndSecondSucceededState. In concrete State, we did three things. First, we once search in TextWindow; second, according to the result of searching, we set the new State for State Context -- WindowSearcher; third, according to the result of searching, we show the corresponding message or do another FindNext. For example:

C#
public class FirstFindState : IFindState {
    public void ShowMessage(){
    }

    public void FindNext(WindowSearcher windowSearcher){
        windowSearcher.SetSearchStartPoint();
        if(windowSearcher.SearchInTextWindowOnce()) {
            windowSearcher.SelectMatchedText();
            windowSearcher.SetState(new FirstFindSucceededState());
        }
        else{
            windowSearcher.MoveToStartInTextWindow();
            windowSearcher.SetState(new FirstFindFailedState());
            windowSearcher.SetLatestFindStartPosToStartOfDoc();
            windowSearcher.FindNext();
        }
    }
}

public class FirstFindFailedState: IFindState {
    public void ShowMessage() {
        UIHelper.ShowInfo("Didn't find");
    }

    public void FindNext(WindowSearcher windowSearcher) {
        if(windowSearcher.SearchInTextWindowOnce()){
            windowSearcher.SelectMatchedText();
            windowSearcher.SetState(new FirstSearchFailedAndSecondSucceededState());
        }
        else{
            windowSearcher.ResetLatestFindStartPos();
            windowSearcher.SetState(new FirstFindState());
            ShowMessage();
        }
    }
}

WindowSearcher is State Context that has _state to keep State information, and realizes FindNext by different State.

C#
public class WindowSearcher : Searcher {
    private IFindState _state;
    public void SetState(IFindState newState) {
        _state = newState;
    }

    public void FindNext() {
        setLatestFindStartPos();
        _state.FindNext(this);
    }
    ...

How to replace Text in TextWindow

The DTE component model provides three methods to replace text in TextWindow. First, TextSelection has ReplaceText function, but it doesn't support standard Regular Expression; second, EditPoint has ReplaceText function, it can replace the text between two points with expected text; third, TextSelection has Text property, it can set an expected text by replacing selected text. The third one is in line with our need and convenience.

C#
private void tryToReplaceSelectedText(string replacePattern) {
    TextSelection objSel = getTextSelection();
    if(_matchedStartPoint == objSel.AnchorPoint.AbsoluteCharOffset 
           && _matchedEndPoint == objSel.ActivePoint.AbsoluteCharOffset){
        objSel.Text = 
          getReplaceText(_searchLatestEditPoint.GetText(getTextDocument().EndPoint), 
          replacePattern);
    }
    setLatestFindStartPos();
}

How to use Regular Expression in searching and replacing

The FCL of .NET Framework provides support for Regular Expressions, and it's pretty good. The namespace is System.Text.RegularExpressions, we just use Match(), Matchs(), Replace(), Match, MatchCollection of the Regex object to do Regular Expression searching and replacing.

C#
public MatchInfo GetMatch() {
    Regex rg = new Regex(_pattern, GetRegexOptions());
    Match match = rg.IsMatch(_windowSource, _nextSearchStartPos);
    if(!match.Success){
        return null;
    }

    int startLine = 
        StringHandleHelp.GetLineCount(ref _windowSource, match.Index); 
    int startLineOffset = 
        StringHandleHelp.GetPosInLine(ref _windowSource, match.Index);
    int endLine = 
        StringHandleHelp.GetLineCount(ref _windowSource, 
        match.Index + match.Length - 1); 
    int endLineOffset = StringHandleHelp.GetPosInLine(ref _windowSource, 
                        match.Index + match.Length - 1);
    return new MatchInfo(startLine, endLine, match.Value, 
           startLineOffset, match.Index, match.Length, endLineOffset);
}
C#
public string Replace(string source, string replacePattern){
    Regex rg = new Regex(_pattern, GetRegexOptions());
    return rg.Replace(source, replacePattern);
}

public string Replace(string source, string replacePattern, int startPos){
    Regex rg = new Regex(_pattern, GetRegexOptions());
    return rg.Replace(source, replacePattern, 1, startPos);
}

protected string replaceAll(string source, 
          string replacePattern, out int repeatCount)
{
    Regex rg = new Regex(_pattern, GetRegexOptions());
    repeatCount = rg.Matches(source).Count;
    return repeatCount > 0?rg.Replace(source, 
           replacePattern):string.Empty;
}

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
China China
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralThere's a new version of the RegEx Tester Tool ! Pin
Pablo Osés1-Mar-08 23:19
Pablo Osés1-Mar-08 23:19 
GeneralVisual Studio 2005 Pin
MrDoomMaster16-Oct-07 6:57
MrDoomMaster16-Oct-07 6:57 
QuestionNot quite working Pin
mgibian7-Sep-06 11:31
mgibian7-Sep-06 11:31 
AnswerRe: Not quite working Pin
mgibian7-Sep-06 11:58
mgibian7-Sep-06 11:58 
GeneralEnhanced the tool ;-) Pin
steven112-Jul-06 9:35
steven112-Jul-06 9:35 
GeneralRe: Enhanced the tool ;-) Pin
jhillman14-Jul-06 8:10
jhillman14-Jul-06 8:10 
GeneralCouly you kindly post the source code somewhere? Re: Enhanced the tool ;-) Pin
zwu_ca27-Jul-07 5:50
zwu_ca27-Jul-07 5:50 
QuestionThe copyright thing.. Pin
Alexandru Stanciu18-Dec-05 22:51
Alexandru Stanciu18-Dec-05 22:51 
GeneralAwesome idea, but still some problems Pin
yogbert4228-Jul-05 7:27
yogbert4228-Jul-05 7:27 
GeneralBrilliant, but..... Pin
Christian Graus23-Dec-04 11:38
protectorChristian Graus23-Dec-04 11:38 
GeneralRe: Brilliant, but..... Pin
niugang23-Dec-04 14:33
niugang23-Dec-04 14:33 
QuestionHow it register in VS.NET 2003 Pin
deniskd23-Dec-04 4:14
deniskd23-Dec-04 4:14 
AnswerRe: How it register in VS.NET 2003 Pin
niugang23-Dec-04 14:25
niugang23-Dec-04 14:25 
GeneralLong overdue! Pin
wumpus122-Dec-04 6:26
wumpus122-Dec-04 6:26 
Very well done, you have my 5. I never understood why MS used non-standard crazy regex support in their IDE search function!

Will VS.NET 2005 have standard regex search and replace??
GeneralRe: Long overdue! Pin
niugang22-Dec-04 18:01
niugang22-Dec-04 18:01 

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.