Question

Is there some way to insert inline code comments in LINQ in VB.NET?

Please see line 2 in the below as an example of where an inline comment would be desirable

Dim Jobs = (From X In DB.Jobs_Select(SearchStr, RequiresFilter)
    Where X.JobStatusID < 2   -- **** INSERT INLINE COMMENT HERE  ****
    Order By
        X.JobPriorityID Descending,
        If(X.TargetDate, Date.MaxValue),
        X.NeedsLit Descending,
        X.HasOldArtRequests Descending,
        X.HasOldLicRequests Descending
    )

This is trivial in SQL code and frankly, very useful as SP’s become complex. It would be nice to be able to perform the same cross-developer communication in LINQ to SQL.

Update

Here is a test condition for you.

 Dim L As New List(Of KeyValuePair(Of Integer, Integer))

 Dim a = (From X In L
            Where X.Key > 5 'test comment
            Order By X.Value)

Answer 1

Ok folks, here is the official answer – not possible in VB. Proof.

It is REALLY annoying in VB that you cannot add inline comments to
multiline LINQ statements!

And more information:

The bad news is that this wouldn’t be trivial to implement.
Limitations about single-lines and comments are built into the current
VB parser at too low a level. It’d require a complete rewrite of the
VB parser.

The good news is that we’ve embarked upon such a rewrite (codenamed
“Roslyn” — there have been several articles and talks about it). It’s
still a way off and we’re not making commitments about what/when at
this stage.

— Lucian Wischik, VB language PM