.NET Framework 4 RTM became available for download alongside Visual Studio 2010 RTM the past week, with Microsoft topping the releases off with Silverlight 4 RTW. Additional resources to accompany the development platform and tools are also served by Microsoft, most of them free of charge, in order to streamline software-building efforts. It is the case of the .NET Framework 4 Migration Issues documentation published on MSDN last week. As the name implies, the resources are focused on detailing problems and breaking changes that developers can come across when adapting their projects to the latest iteration of .NET Framework.
“With the release of .NET Framework 4 last week, it is relevant to talk about migration issues you might run into when upgrading your applications to .NET 4. My team has put together a topic that describes the migration issues (formerly known as breaking changes) between the .NET Framework version 3.5 Service Pack 1 and the .NET Framework version 4. The change in terminology is to reflect the fact that not all changes introduced by a new version of the framework break your application; rather, these are changes in behavior discovered during design review and testing that could potentially impact an application,” Maira Wenzel, documentation manager for the CLR User Education team at Microsoft, explained
Developers will be able to access detailed information on breaking changes in .NET Framework 4 areas such as ASP.NET, Core, Data (ADO.NET), Windows Communication Foundation (WCF), Windows Presentation Foundation (WPF) and XML. The MSDN resource includes migration issues for new .NET Framework fixes, evolved standards compliance and security, but also additional enhancements generated by customer feedback. Most importantly, the Redmond company is also offering guidance for the breaking changes that require programming modifications to be applied to applications. Some of the migration issues include the following:
- ASP.NET Issues
- Browser definition files
- Child applications running under mixed versions of ASP.NET
- ClientID changes
- Code access security (CAS)
- Configuration files
- Control rendering
- Event handlers in default documents
- Hashing algorithm
- HtmlEncode and UrlEncode methods
- HttpException errors in ASP.NET 2.0 applications
- Membership types
- Menu control changes
- Mobile assembly in Web.config file
- Output caching
- Page parsing
- Passport types
- PathInfo information in the FilePath property
- Request validation
- Routing
- SharePoint sites
- XHTML 1.1 standards
- Core Issues
- Configuration files
- Hosting – (unmanaged API)
- New security model
- Date and Time Issues
- Daylight savings
- Formatting strings
- Globalization Issues
- Culture names
- LCID parameter
- Obsolete culture types
- Retrieving culture
- Unicode 5.1 standards
- Exceptions Issues
- Exceptions for corrupted process state
- Execution engine exceptions
- Reflection Issues
- Assembly hash algorithms
- Assembly loading
- Declaring type
- Delegates
- Global assembly cache location change
- Interoperability Issues
- Buffer length – (unmanaged API)
- JIT debugging
- Platform invoke
- Removed interfaces – (unmanaged API)