.NET Coding Guidelines

.NET Coding Guidlines - Section 3.7 Namespace Naming Guidlines

BobSmith — Fri, 19 Sep 2008 09:07:48 GMT

Section 3.7 Namespace Naming Guidlines - this has just been copied from the MSDN library with Iridium copyright added. Right?

Control Naming Guidelines

Michael Mae — Tue, 19 Dec 2006 16:42:39 GMT

Control Naming Guidelines look fairly VB6 old...

remove VB reference ?

NicholsF — Fri, 09 May 2008 16:32:35 GMT

Great set of guidelines. Thanks for sharing. I have a couple of questions:

In section 3.1 - it states:

Remove the Visual Basic reference from your project. Making use of the original Visual Basic functions has been proven to be up to 1000 times slower than the .NET counterparts; you have been warned.

Are you saying to remove this from code: Imports Microsoft.VisualBasic

Or something else?

Also, could you provide examples of what is slower and what in .NET that can be used that is 1000 faster?

Thanks,

Frankie

Commercial Use

Hellracer — Fri, 27 Apr 2007 09:40:11 GMT

Hello,

we currently writing our Naming Guidelines for use within our company. Then I found your document and ..wow..pretty nice work and nearly perfect for our use. I´m a programmer, and as programmers are pretty lazy at all I want to mainly copy & paste your work into our document. Is it allowed to use your document for our commercial company ? Do I need to include a reference to your company ? Maybe even to have the source document (Word,OOffice,Latex?) ? We are will to pay for this of course.

Kind Regards,

Klaus

PS: Next update was planned for Feb 2007, any delay ?

Capitalization questions

Alex Dresko — Tue, 19 Dec 2006 19:19:18 GMT

Section 3.2.3 states:

All letters in the identifier are capitalized. Use this convention only for identifiers that consist of two or fewer letters. For example:
System.IO
System.Web.IO

The section then proceeds to show examples of the various capitalization techniques. My first complete is the "two or fewer letters" clause.. IMO, you should capitalize every letter of an abbreviated word.. For example, instead of:

Dim table As New HtmlTable()

I see nothing wrong with:

Dim table As New HTMLTable()

If the first letter of every word in an object's name is capitalized, then it is still easy to read even if the abbreviation falls in the middle of the name. For example:

Dim crazyObject As New SuperFUBARThing()

My second issue is that there are no capitalization examples just below this section.

Anyway, I look forward to hearing your feedback on these issues.

Inquiries

Glenn S — Wed, 20 Dec 2006 01:44:43 GMT

I've downloaded the .NET Coding Guidelines, reading the post here says that this whitepaper will be updated somtime Jan - Feb 2007.

Would it be possible to know the following:
a.) Are their additional guidelines to be added in this whitepare?
b.) Will this be forever free? I hope so :-)

More examples..

Alex Dresko — Tue, 19 Dec 2006 22:10:26 GMT

All 3.* sections should contain examples..3.12 in particular needs further clarification.. perhaps a table of typical hungarian prefixes.