Browse by Tags

All Tags » New Guideline   (RSS)
Framework Design Guidelines: LINQ
Wow, it feels like old times ...  I am happy that we are posting a new proposal for additions to the framework design guidelines.  Mitch has worked hard on these, and we have reviewed them internally and now it is time for your comments.   Read More...
Posted 13 March 08 07:53 by BradA | 6 Comments   
Filed under , ,
Design Guideline Update: handling nulls in public APIs
We had a recent thread internally that resulted in me updating the guidelines below… Please let me know if you have any questions or comments. Do provide overloads for methods with optional arguments. If a method takes some arguments that are not required Read More...
Posted 16 December 04 10:27 by BradA | 12 Comments   
Filed under ,
Design Guideline update: put cleanup code in finally blocks
Another new guideline.. this one sparked a lot of discussion during our internal review, lets see if I cleaned it up well enough or not ;-) Do put cleanup code in finally blocks. Even code that immediately follows a catch() can be interrupted by an asynchronous Read More...
Posted 03 December 04 02:35 by BradA | 14 Comments   
Filed under ,
New Design Guideline: Parameter validation
More guideline updates from the Security push (as Soma said earlier this year , the push is now upon us!) Do be aware that mutable values may have changed after they were validated. If the operation is security sensitive you are encouraged to make a copy, Read More...
Posted 01 December 04 11:27 by BradA | 8 Comments   
Filed under ,
New Design Guideline: Null Paramarrays
Based on some security reviews we are doing on the system in general I added this implementation note to the Design Guidelines. Do be aware that null could be passed in for the paramarray. You should validate that that paramarray is not null before processing Read More...
Posted 30 November 04 10:52 by BradA | 6 Comments   
Filed under ,
New Design Guideline: Be consistent in naming parameters when overloading, overriding and implementing interfaces
We have seen this come up a more than a few times in WinFX API reviews so I thought it was worth adding a quick guideline… As always, please let me know if you have any questions or comments. You can check out the base design guidelines and my incremental Read More...
Posted 04 October 04 03:24 by BradA | 2 Comments   
Filed under
New Design Guideline: Avoid Protected Static
Here is a minor update to the design guidelines around subclassing. It is based on this quiz I did a last week . Please let me know if you have any questions or comments. As always, you can check out the base design guidelines and my incremental updates. Read More...
Posted 09 September 04 06:49 by BradA | 18 Comments   
Filed under
New Design Guideline: Virtual Members
As you might guess from my last few posts , I have been doing some thinking about virtual members. Here are the updated guidelines. Please let me know if you have any questions or comments. As always, you can check out the base design guidelines and my Read More...
Posted 12 August 04 10:26 by BradA | 13 Comments   
Filed under
New API Design Guideline: Enums
There are a few topics that are likely to generate a long thread of discussion whenever they come up Exceptions, finalization, and Enums are among them Kit George spent a fair amount of time working with folks across WinFX on how to “correctly” Read More...
Posted 18 May 04 10:32 by BradA | 4 Comments   
Filed under ,
New Design Guidelines Posted: Resources and Xml
If you have not been tracking Kris’s blog , you might have missed that we recently posted two new design guidelines for Framework developers. As always comments are very welcome, even encouraged. Exposing XML Data Resources Please see the design Read More...
Posted 04 May 04 01:35 by BradA | 0 Comments   
Filed under ,
New Design Guideline: Generics
Please check out the new generics design guidelines and as always, let me know if there any any questions or comments. Read More...
Posted 15 March 04 12:07 by BradA | 1 Comments   
Filed under
Minor update to Enum size guideline
Here is a minor clarification on the enum size guidelines. Please let me know if you have any questions or comments. As always, you can check out the base design guidelines and my incremental updates. Do use Int32 (the default in most programming languages) Read More...
Posted 05 March 04 04:13 by BradA | 6 Comments   
Filed under ,
Design Guidelines Update: Exception Message Guidelines
It has become clear to me recently that we could be doing a better job with exception messages. I took these guidelines from a set that the UE team on the .NET Framework uses. Love to hear your comments, issues, and suggestions. 7.3.2 Exception Error Read More...
Posted 28 January 04 10:27 by BradA | 25 Comments   
Filed under ,
Design Guideline Update: Uri vs. string
ChrisAn blogged about this a few weeks ago and I am happy to announce that Krzysztof Cwalina has a guideline ready for you to comment on! System.URI Usage Use System.Uri to represent URI/URL data. This applies to parameter types, property types, and return Read More...
Posted 12 January 04 04:14 by BradA | 9 Comments   
Filed under ,
Design Guidelines Update: Enums vs Boolean Arguments
This was a pretty heavily debated guideline internally, I think we reached a good conclusion... Your feedback welcome as always! The full guidelines can be found here , we will be roll this (and other updates) into it for the whidbey release. Enums vs Read More...
Posted 12 January 04 10:01 by BradA | 12 Comments   
Filed under ,
More Posts Next page »

Search

Go

This Blog

本博客中文版 (View in Chinese)



These postings are provided "AS IS" with no warranties, and confer no rights.

Syndication

Page view tracker