In Visual Basic .NET, there are several cases in which the statement completion list will present the user with a list of values rather than the standard completion set. Most often, this occurs when assigning to a variable of one of the common System.Drawing types, Color, Brush or Pen.
At first glance, the screenshot above might seem as if the Visual Basic IDE has hard-coded a set of values into IntelliSense, but that’s not the case. In fact, this is caused by a seldom-used feature of XML Documentation that is supported by Visual Basic .NET, but isn’t currently supported by C#1. By cracking open the the XML Documentation file for System.Drawing.dll (located at C:\Windows\Microsoft.NET\Framework\v2.0.50727\en\System.Drawing.xml on my machine), we’ll see a curious XML tag on the System.Drawing.Color definition.
<summary>Represents an ARGB (alpha, red, green, blue) color.</summary>
<completionlist cref="T:System.Drawing.Color" />
The highlighted completionlist tag above is used by Visual Basic to populate the completion list with the public shared2 fields and properties from the specified class or module. In this particular case, the XML documentation causes Visual Basic to populate the completion list with the public shared properties of System.Drawing.Color.
Don’t believe me? Just comment out the System.Drawing.Color completionlist tag above, save and restart Visual Studio to see how this influences the statement completion list.
Many of you are probably thinking, “so, is this just a nifty implementation detail, or is something I can actually use?” The answer is, yes, this something you can use today to customize Visual Basic’s statement completion. The code below demonstrates how the completionlist tag can be used.
''' <completionlist cref="CommonOperations"/>
Public Class Operation
Private ReadOnly _execute As Func(Of Integer, Integer, Integer)
Public Sub New(ByVal execute As Func(Of Integer, Integer, Integer))
_execute = execute
Public Function Execute(ByVal arg1 As Integer, ByVal arg2 As Integer) As Integer
Return _execute(arg1, arg2)
Public NotInheritable Class CommonOperations
Public Shared ReadOnly Add = New Operation(Function(x, y) x + y)
Public Shared ReadOnly Subtract = New Operation(Function(x, y) x - y)
Public Shared ReadOnly Multiply = New Operation(Function(x, y) x * y)
Public Shared ReadOnly Divide = New Operation(Function(x, y) x / y)
Visual Basic will automatically pick up the completionlist tag in the code above and use it to populate the completion list like so.
While a bit limited, it’s pretty easy to customize the statement completion list experience for Visual Basic to make certain types of APIs more discoverable. It’s as simple as a single XML tag.
1Kevin Pilch-Bisson (C# IDE Developer Lead and swell guy) has a clever idea for supporting the completionlist tag in the C# statement completion list while staying true to the C# IntelliSense model.
2The VB "Shared" keyword = static in C#.