Microsoft LINQ Books

Corrections for Programming Microsoft LINQ book

Marco.Russo — Fri, 20 Feb 2009 08:22:00 GMT

We just published an updated version of the corrections for the Programming Microsoft LINQ book.

You can download it from this link.

New templates for LINQ to SQL code-generation

Marco.Russo — Wed, 21 Jan 2009 10:42:16 GMT

Damien posted a new version of his templates to improve code-generation of classes for LINQ to SQL, including a short screen-cast that explain how to use it. Valuable resource if you use LINQ to SQL!

LINQ and Tuples in .NET 4.0

Marco.Russo — Thu, 27 Nov 2008 08:40:31 GMT

.NET 4.0 will add the concept of Tuples in the Base Class Library, that will improve interoperability between languages such as F# or IronPython and C# or Visual Basic. LINQ will not have big changes in .NET 4.0, but only some lifting to support new features: for example, the Zip operator will be added in System.Linq.Enumerable to combine two collections generating an ordered sequence of Tuples (that you can then project in a different way). Some good examples are described in this post by Matthew Podwysocki.

Updateable LINQ

Marco.Russo — Mon, 24 Nov 2008 10:21:26 GMT

Bart de Smet wrote a very interesting post about the possible creation of an Updateable LINQ provider, especially if it can be used for a SQL dbms (of course it would work with LINQ to SQL but it should be applicable to LINQ to Entities too). I like this approach very much.

However, a Microsoft word on this, especially defining the "official" LINQ extensions and interfaces to implement an updatable query provider, would be fundamental to write code that will be still valid when a different LINQ provider implementation will be used.

LINQ to SQL vs LINQ to Entities - decisions from ADO.NET team

Marco.Russo — Sun, 02 Nov 2008 20:44:00 GMT

To make a long story short: the ADO.NET team is now responsible of ADO.NET Entity Framework (including LINQ to Entities) and of LINQ to SQL (the last one was originally in charge of the a separated team, tied to the C# compiler).

There is an evident overlapping between LINQ to SQL and LINQ to Entities and since the first day, Microsoft said that in the long run, these two solutions would have been merged into a single one.
Now, the roadmap that is arising is: Entity Framework will be improved adding features that will be necessary to cover scenarios where LINQ to SQL today is preferred over LINQ to Entities and Entity Framework.

There are a lot of comments - I suggest you starting here to get a good recap and pointers to many others.

My personal opinion is that LINQ to SQL is very good in some scenarios and should not be dropped until a good alternative (in EF?) is available. For example, I use LINQ to SQL to implement nightly processes that are part of ETL solutions. In these cases, I use LINQ to SQL to read data (expecially configuration data, but sometimes also source data) and use the SqlBulkCopy API to write data into destination tables. Having all the necessary into a single executable file, without external dependencies, is a big advantage for deployment (a single file to copy). Today LINQ to Entities would be slower, would have more files and would require .NET 3.5 SP1 on production servers (the last one would not be a real issue in my case). There are of course other scenarios when there is something that makes LINQ to SQL a better choice against the current version of Entity Framework.

My hope is that a convergence of two partially overlapped frameworks is good, but at the same time this shouldn't be a penalization for the current users of the "losing" part. This will require several releases of .NET to be done, and I hope that in the meantime the LINQ to SQL engine will have a decent evolution to keep its current position of "light LINQ oriented DAL replacement to SQL Server".

Book signing @ PDC 08

Marco.Russo — Mon, 27 Oct 2008 15:49:00 GMT

If you are at PDC 2008, I'll be at book signing for Programming Microsoft LINQ at bookstore on Tuesday 28, during the coffee break between 3:00 and 3:30 PM.
I and Paolo will be happy to meet you and receive your direct feedback about our LINQ book.

Use IEnumerable as a source for SqlBulkCopy

Marco.Russo — Wed, 17 Sep 2008 06:05:11 GMT

Today I needed to use SqlBulkCopy class passing an IEnumerable<T> as a source instead of a IDataReader. Before writing something that someone else could have already written, I made some search and I found this interesting post that solve exactly this issue. In the post there is also a link to source code. Take also a look at performance optimization for getter as described in post comment.

Non-boolean LINQ predicates

Marco.Russo — Mon, 15 Sep 2008 09:18:23 GMT

Bart De Smet just wrote a long post about LINQ predicates that can be defined without returning a boolean value.

This is something I partially evaluated writing the Programming Microsoft LINQ book, but in his post Bart goes very deep on this topic and shows a lot of interesting details and ideas.

Active queries LINQ

Marco.Russo — Thu, 11 Sep 2008 08:12:51 GMT

Paul Stovell made a presentation on "Reactive Programming and Bindable LINQ" at TechED Australia 2008 (unfortunately, I was at the antipode in Italy, but the topic is really interesting). I didn't know there are projects somewhat similar to Bindable LINQ in CodePlex: Obtics and Continuous LINQ. I really like the idea of defining "live" queries with LINQ.

LINQ to SQL and the procedure cache of SQL Server

Marco.Russo — Thu, 28 Aug 2008 00:14:42 GMT

I just received a mail from Adam Machanic that pointed me to this bug (I would call it a performance issue) about the construction of SQL statements generated by the LINQ to SQL engine.

The issue: every string passed as a constant in the query will be auto-parameterized using the length of the passed string, even when you used a string variable into the LINQ query. If you write something like

string s = "Wine";
var query =
        from x in db.Products
        where x.ProductName == s
        select x;

you will see that a parameter of type NVARCHAR(4) will be passed to the generated SQL query. The next execution of query might contain a different value in the s parameter, and for this reason a different parameter type might be used: if the length of the string in the s variable changes, then the same query will be sent to SQL Server, but using a different type in the sp_executesql parameters .For example, a NVARCHAR(5) would be used whether s contains"Bread".

The consequence of this behavior is that you could have a non-optimal performance from SQL Server and, more important, the procedure cache could be filled up with several copies of the same query, differing each other only in the length of the parameter type.

I agree with Adam: this is something to be fixed. But my suspect is that we will get a "by design" answer another time...

IQueryable under the cover

Marco.Russo — Sun, 17 Aug 2008 09:07:48 GMT

In the Programming Microsoft LINQ book we dedicated two whole chapters (76 pages) about the writing of a IQueryable LINQ provider: one is about expression trees and the other covers the several ways to extend LINQ, including the writing of an IQueryable provider. I know that the subject is complex and probably is not necessary to every programmer. However, a good understanding of what happens under the cover of an IQueryable provider is good for everyone using any flavor of LINQ: when you debug your code, it might help you in finding issues faster.

I wrote this introduction just to explain why you should read this post of Bart De Smet, which is undoubtedly shorter than the corresponding chapter of our book and gives you a very good step-by-step introduction of the inner workings of an IQueryable LINQ provider. Then, if you really like this kind of things, you have another good reason to read the book :-)

Important LINQ Changes in .NET 3.5 SP1

Marco.Russo — Tue, 12 Aug 2008 07:55:25 GMT

Dinesh Kulkarni wrote an important post about changes in LINQ introduced by .NET 3.5 SP1 that has been released yesterday.

One of the interesting changes is in the Cast<T> operator and its behavior is better described in this post by Ed Maurer. I think that the side effects of this change should be limited, because the use of explicit type for the range variable in a query expression (i.e. from int n in numbers select... instead of from n in numbers select...) is not very common. In fact, I don't remember examples of its usage in our Programming LINQ book. Take care of this change if you used (or will use) this syntax.

Dangerous use of ArrayList in Lambda Expressions

Marco.Russo — Fri, 01 Aug 2008 10:53:07 GMT

I have just validated this bug posted on Connect. It seems a compiler issue, I'd like to read a Microsoft answer about this.

However, the general issue is that using ArrayList in a lambda expression with a collection initializer could be dangerous. There are not so many reasons to use an ArrayList in a lambda expression, unless you are refactoring or working with legacy code that cannot be modified upgrading ArrayList to generic collections.

The adoption of LINQ

Marco.Russo — Fri, 25 Jul 2008 07:06:38 GMT

Eric White has written an interesting post titled "Are developers using LINQ?" - there are interesting considerations about the adoption of functional programming too, but the most interesting part for me is the list of comment of the post. A lot of people described the adoption of LINQ into their team or company, and there is a spread variety of comments (good and bad).

An interesting comment is about the future adoption of F# when it will be shipped, because of the complete adoption of functional programming (C# 3 is not a complete functional programming like F# is). I suggest you to take a look at this post and its comments, because it gives you an idea of what is going on out there.

Multiple Results with LINQ to SQL

Marco.Russo — Thu, 24 Jul 2008 06:49:59 GMT

I just read a post about getting multiple results with LINQ to SQL without using stored procedures. This technique is interesting when you have multiple queries returning a few rows each one and you want to save time by skipping some roundtrip between your program and SQL Server. Looking at the post, I immediately thought that it would be interesting comparing this solution with an asynchronous one, executing each query in a different thread. I don't have time to make some benchmark, but it would be interesting to make a comparison between these two techniques.

Use of Distinct and OrderBy in LINQ

Marco.Russo — Sun, 20 Jul 2008 08:16:26 GMT

A few days ago I found a bug in a program written using LINQ to SQL, which was caused by years of use of SQL. The requirement was something like: get the distinct values of (bla bla bla) sorted alphabetically. An example of the required query with Northwind would be the following one:

SELECT DISTINCT
        e.LastName
FROM    Orders o
LEFT JOIN [Employees] e
        ON e.[EmployeeID] = o.[EmployeeID]
ORDER BY e.LastName

Fundamentally, we are using both a DISTINCT and an ORDER BY statement in SQL.

Now, if you create a NorthwindDataContext importing the Order and Employee tables, you can try to write a similar statement in LINQ to SQL. Unfortunately, the Distinct clause is not part of the query syntax and the most intuitive path could be the one of calling Distinct at the end of your statement, like in the following query:

var queryA =
    (from o in db.Orders
     orderby o.Employee.LastName
     select o.Employee.LastName)
     .Distinct();

However, the Distinct clause is removing the sort condition defined by the orderby keyword. In fact, the SQL statement sent to the database is the following one:

SELECT DISTINCT
        [t1].[LastName]
FROM    [dbo].[Orders] AS [t0]
LEFT OUTER JOIN [dbo].[Employees] AS [t1]
        ON [t1].[EmployeeID] = [t0].[EmployeeID]

This behavior might appear strange. The problem is that the Distinct operator does not grant that it will maintain the original order of values. Applied to LINQ to SQL, this mean that a sort constraint can be ignored in the case of a query like queryA.

The solution is pretty sample: put the OrderBy operator after the Distinct one, like in the following queryB definition:

var queryB = 
    (from o in db.Orders
     select o.Employee.LastName)
    .Distinct().OrderBy( n => n );

This will result in the following SQL statement sent to Northwind:

SELECT  [t2].[LastName]
FROM    ( SELECT DISTINCT
                    [t1].[LastName]
          FROM      [dbo].[Orders] AS [t0]
          LEFT OUTER JOIN [dbo].[Employees] AS [t1]
                    ON [t1].[EmployeeID] = [t0].[EmployeeID]
        ) AS [t2]
ORDER BY [t2].[LastName]

If you remove some syntax redundancy, this is exactly the same query I wrote at the beginning of my post.

The lesson is: in a SQL query, the position of an operator is not relevant until operators belong to the same SELECT/FROM statement. In LINQ, this is not true and the conversion to SQL could remove LINQ operators when their operation might be ignored by other operators in the same LINQ query.

Final consideration: initially I considered that the compiler could emit some warning in case a query reduction is done like in the queryA case. Unfortunately, the query reduction operation is done by the LINQ to SQL provider at execution time and not during compilation. A warning could still be possible, but it's something that I would move to tools like FxCop.

LINQ query optimizations

Marco.Russo — Fri, 18 Jul 2008 20:28:00 GMT

Look at this excellent blog post written by K. Scott Allen. I completely agree with him: don't try to optimize a LINQ query until you measure its performance and understand it is really a bottleneck that needs to be improved.

An interesting consideration I never made before is that you can call the OrderBy extension method after the Select and not before. Yes, using the query syntax of C# you are used to put the Select after the OrderBy, but sometime it could be better to invert this order (the reasons are already well explained in the Scott Allen's post).

And, of course, consider that performance have to be evaluated in two dimension: time and space. And, sooner than later, a third dimension (parallelism) will gain the same importance.

Implement progress reporting and cancellation of LINQ queries

Marco.Russo — Fri, 18 Jul 2008 01:06:29 GMT

Samuel Jack wrote two interesting posts discussing possible extension methods for LINQ. One is to implement progress reporting of a LINQ query. The other is to implement a way to cancel a running LINQ query.

Both implementations are very simple and they are very good to illustrate how LINQ can be extended and manipulated in a simple way by using extension methods.

LINQ to SQL and varchar(1) fields

Marco.Russo — Thu, 17 Jul 2008 07:03:49 GMT

If you are using the Object Relational Designer of LINQ to SQL creating an entity of an existing table that has some VARCHAR(1) fields, you are going into this issue.

The data member created in C# is char instead of string. If the field is always filled with one char, this works. But if you try to read a row from the table containing an empty string (not a NULL field, but a field of zero characters) you will get this exception:

String must be exactly one character long.

This behavior has been already described in this post and in the LINQ forum. But one more warning could be important: this is a latent error that will express yourself only at runtime if you don't fix. Thus, be careful whenever you have some VARCHAR(1) fields in your tables.

The Amazon Reviews law

Marco.Russo — Fri, 11 Jul 2008 08:48:39 GMT

While you have few reviews, a single bad review lower the overall rate. Today we got a bad review, probably because there was a misunderstanding about the scope of the book. I feel the need to give some information to help other possible readers to make a good choice.

First of all, I suggest everyone to take a look at the book contents. It already describes pretty well what you should expect to find in this large book. In the same place, you will find the links to download two sample chapters of the book. They are not the toughest ones, but they show you the general approach that is the one of explaining LINQ, addressing its use with other libraries (like ASP.NET, WCF, WPF, WCF and so on). This does not mean that we cover how to make data binding works of how to write an application in WPF. We assume that a particular library for communication or presentation is already in your skills. We only concentrate our attention on data query and manipulation.

Another point is the language. We used C# as a language of choice, and used VB.NET only in chapters where the features and/or syntaxes are significantly different (XML integration is one of the most important area for this). Converting existing C# samples in VB is very simple, and we always highlighted when major differences are expected. There are parts where only the VB syntax is available (see XML) and other parts where C# doesn't have correspondent VB syntax. All these differences are well explained in two appendixes, one for C# and the other for VB. We had to make this decision because space was limited and we had a lot of content to put into the book.

I hope this will help you. Please contact me if you have any doubt and/or would like to give other feedback.

Extending LINQ to XML

Marco.Russo — Thu, 10 Jul 2008 08:44:12 GMT

Eric White shows some interesting use of LINQ to XML to query an Open XML document.

Something that is not immediate to learn when you use LINQ is that you can define your own extension methods to make your queries smarter and more readable. This post is a good exercise to think in a more flexible way: even for me, it's the first time I see an example of "extension" applied to LINQ to XML.

Sample chapters from Programming LINQ

Marco.Russo — Tue, 24 Jun 2008 06:48:43 GMT

Two sample chapters of my Programming Microsoft LINQ book are finally available. Links to download pages in the chapters title.

Chapter 6 - Tools for LINQ to SQL

In this chapter, we took a look at the tools that are available to generate LINQ to SQL entities and DataContext classes. The .NET Framework SDK includes the command-line tool named SQLMetal. Visual Studio 2008 has a graphical editor known as the Object Relational Designer. Both allow the creation of a DBML file, the generation of source code in C# and Visual Basic, and the creation of an external XML mapping file. The Object Relational Designer also allows you to edit an existing DBML file, dynamically importing existing tables, views, stored procedures, and user-defined functions from an existing SQL Server database.

Chapter 16 - LINQ and ASP.NET

This chapter showed you how to leverage the new features and controls available in ASP.NET 3.5 to develop data-enabled Web applications, using LINQ to SQL and LINQ in general. Consider that what you have seen is really useful for rapidly defining Web site prototypes and simple Web solutions. On the other hand, in enterprise-level solutions you will probably need at least one intermediate layer between the ASP.NET presentation layer and the data persistence one, represented by LINQ to SQL. In real enterprise solutions, you usually also need a business layer that abstracts all business logic, security policies, and validation rules from any kind of specific persistence layer. And you will probably have a Model-View-Controller or Model-View-Presenter pattern governing the UI. In this more complex scenario, chances are that the LinqDataSource control will be tied to entities collections more often than to LINQ to SQL results.

The following is the complete list of the chapters included in the book.

Programming Microsoft LINQ

Part I LINQ FOUNDATIONS
- 1 LINQ Introduction
- 2 LINQ Syntax Fundamentals
- 3 LINQ to Objects
Part II LINQ to Relational Data
- 4 LINQ to SQL: Querying Data
- 5 LINQ to SQL: Managing Data
- 6 Tools for LINQ to SQL
- 7 LINQ to DataSet
- 8 LINQ to Entities
Part III LINQ and XML
- 9 LINQ to XML: Managing the XML Infoset
- 10 LINQ to XML: Querying Nodes
Part IV Advanced LINQ
- 11 Inside Expression Trees
- 12 Extending LINQ
- 13 Parallel LINQ
- 14 Other LINQ Implementations
Part V Applied LINQ
- 15 LINQ in a Multitier Solution
- 16 LINQ and ASP.NET
- 17 LINQ and WPF/Silverlight
- 18 LINQ and the Windows Communication Foundation
Appendixes
- A ADO.NET Entity Framework
- B C# 3.0: New Language Features
- C Visual Basic 2008: New Language Features

To join or not to join: that is the question (in LINQ)

Marco.Russo — Tue, 17 Jun 2008 21:22:00 GMT

A comment received by one reader of Programming LINQ suggested me to underline a concept that is not so intuitive using LINQ, especially if you come from years of SQL coding.

The idea is very simple. Two entities in LINQ might be related in the model. Whenever this happen, usually it is better to leverage on this existing relationship and not to write the join syntax in an explicit way. If you are using LINQ to SQL, the generated SQL code might be more performant or at least correspondant to the one generated by writing an explicit join in your LINQ query. The less constraints in your query, the better.

Let's look at an example on the Northwind database. Imagine you want to see a list of all categories with a flag set for the one which a particular product belongs to. This is a SQL query we could write:

SELECT
    c.CategoryID,
    c.CategoryName,
    CASE WHEN p.ProductID IS NULL
        THEN 0
        ELSE 1
    END AS Selected
FROM Categories c
LEFT JOIN Products p
    ON p.CategoryID = c.CategoryID
    AND p.ProductID = 10
ORDER BY CategoryName

Ok, we can write the same query in many other ways, but there are several more complex situations where a LEFT JOIN is used to test the presence of an element in a related table. A correspondant LINQ query might be the following one:

from c in dc.Categories
orderby c.CategoryName
join p in dc.Products.Where(p => p.ProductID == 10)
    on c.CategoryID equals p.CategoryID
    into pj
from x in pj.DefaultIfEmpty()
select new {
    c.CategoryID,
    c.CategoryName,
    Selected = x != null
};

The LINQ query above will generate a SQL query containing a LEFT JOIN statement. However, a relationship exists between Categories and Customer, and you can leverage on this relationship in the point where you really need to traverse the relationship (in the projection statement). The following one is a better way to get the same result:

from c in dc.Categories
orderby c.CategoryName
select new {
    c.CategoryID,
    c.CategoryName,
    Selected = c.Products.Any( p => p.ProductID == 10 ) ? true : false
};

This new version has two advantages. First, it is shorter and express its intent more explicitly. Second, it generates a SQL query with an EXISTS statement, similar to the following one.

SELECT CategoryID, CategoryName,
    (CASE
        WHEN EXISTS(
            SELECT NULL AS [EMPTY]
            FROM Products AS p
            WHERE (p.ProductID = 10) AND (p.CategoryID = c.CategoryID)
            ) THEN 1
        ELSE 0
    END) AS Selected
FROM Categories AS c
ORDER BY CategoryName

The execution plan used by SQL Server might be similar if not equal. However, using the implicit relationship between Categories and Products in the LINQ query is usually better, because it gives more freedom to the LINQ provider to generate a more efficient SQL code.

TechEd interview

Marco.Russo — Thu, 05 Jun 2008 15:49:00 GMT

I and Paolo have been interviewed at TechEd by Ken Rosen. We talk about our experience as book authors.

If you are interested in writing a book, or if you simply want to see our faces and hear our italian accent, you can watch the video available in both low resolution and high resolution. Enjoy!

TechEd 2008 book signing

Marco.Russo — Mon, 02 Jun 2008 13:49:00 GMT

I'm already in Orlando for TechEd 2008 Developers. Tomorrow I and Paolo Pialorsi will be at the TechEd bookshop for a book signing of our just released Programming Microsoft LINQ, scheduled at 4:00PM-4:30PM. I wrote a post a few days a go with the list of chapters included in the book. LINQ to SQL and LINQ to Entities are two technologies that are significative to access data, even if you don't have to use them in every possible scenario.

If you are attending to TechEd, meet us tomorrow at the bookshop to talk about LINQ!