Skip to content

Latest commit

 

History

History
64 lines (37 loc) · 3.83 KB

README.md

File metadata and controls

64 lines (37 loc) · 3.83 KB

The Anti-#region Legion

The Anti-#region Legion is a community for people that believe that the C# #region is a unfortunate part of the language.

If you just love your regions The Anti-#region Legion is probably not for you. But it is suggested that you read Richard Banks post on some of the issues with regions.

How do I join the Legion?

You can join by starring this repository (if you have a github account), or join in the conversation on social media such as Twitter using hashtag #endregions. You are also encouraged to suggest your own ideas to this site on the issues page.

What does an upstanding member of the Legion do?

Join us in practicing and preaching good code practices, such as using the following ways to deal with grouping and organization of expanding code (rather than regions):

  1. Partial class - a useful methodology of moving dependency items (such as properties or methods) without refactoring a code-base with a rippling change
  2. Extract methods - improve the JIT's ability to optimize performance by allowing it to not load sections of code if the branch hasn't been or can never be exercised by extracting methods out of the contents of large block statements (if/else,for/while,anonymous delegates,etc)
  3. Single responsibility - reduce complexity of classes by encapsulating the responsibility for aspects of functionality to designated layers and objects

I Just Want to Get Rid of All Regions in My Code Now!

Ok, here are a couple of quite simple ways to do that. One command line and one from within Visual Studio.

Command line - run this PowerShell command in your toplevel source folder(s) (c# class files only):

dir -recurse -filter *.cs $src | foreach ($_) {
    $file = $_.fullname
    echo $file
    (get-content $file) | where {$_ -notmatch "^.*\#(end)?region.*$" } | out-file $file
}

You can read more on Richard Dingwall's blog.

Visual Studio: Press ctrl + shift + H to "Replace in Files" and as "Find options" "Use Regular Expressions". Then search for ^[ \t]*\#(region|endregion).*\n and replace it with nothing/empty string.

See more details in this stackoverflow answer.

My Team Won't let me Delete the Regions!?

Poor you. If you just want to see the code within collapsed regions you can use ctrl + M, ctrl + L to toggles between expand and collapse all sections.

There is even a Visual Studio extension that does this and more automatically.

History

The idea for the anti-#region legion started from a twitter conversation which again was started from Microsoft declining to remove #regions from c#.

How can I show my anti-#region legion membership?

Be creative! Make a sticker, tag your computer with #endregions or buy a t-shirt.

Join the anti-#region Legion today!