File: Completion\KeywordRecommenders\Types\BuiltInTypesKeywordRecommender.vb
Web Access
Project: src\src\roslyn\src\Features\VisualBasic\Portable\Microsoft.CodeAnalysis.VisualBasic.Features.vbproj (Microsoft.CodeAnalysis.VisualBasic.Features)
' Licensed to the .NET Foundation under one or more agreements.
' The .NET Foundation licenses this file to you under the MIT license.
' See the LICENSE file in the project root for more information.

Imports System.Collections.Immutable
Imports System.Threading
Imports Microsoft.CodeAnalysis.Completion
Imports Microsoft.CodeAnalysis.Completion.Providers
Imports Microsoft.CodeAnalysis.VisualBasic.Extensions.ContextQuery
Imports Microsoft.CodeAnalysis.VisualBasic.Syntax

Namespace Microsoft.CodeAnalysis.VisualBasic.Completion.KeywordRecommenders.Types
    ''' <summary>
    ''' Recommends built-in types in various contexts.
    ''' </summary>
    Friend Class BuiltInTypesKeywordRecommender
        Inherits AbstractKeywordRecommender

        Protected Overrides Function RecommendKeywords(context As VisualBasicSyntaxContext, cancellationToken As CancellationToken) As ImmutableArray(Of RecommendedKeyword)
            If context.IsTaskLikeTypeContext Then
                Return ImmutableArray(Of RecommendedKeyword).Empty
            End If

            Dim targetToken = context.TargetToken

            ' Are we right after an As in an Enum declaration?
            If context.IsEnumBaseListContext Then

                Dim keywordList = GetIntrinsicTypeKeywords(context)

                Return keywordList.WhereAsArray(
                    Function(k) k.Keyword.EndsWith("Byte", StringComparison.Ordinal) OrElse
                                k.Keyword.EndsWith("Short", StringComparison.Ordinal) OrElse
                                k.Keyword.EndsWith("Integer", StringComparison.Ordinal) OrElse
                                k.Keyword.EndsWith("Long", StringComparison.Ordinal))
            End If

            ' Are we inside a type constraint? Because these are never allowed there
            If targetToken.GetAncestor(Of TypeParameterSingleConstraintClauseSyntax)() IsNot Nothing OrElse
               targetToken.GetAncestor(Of TypeParameterMultipleConstraintClauseSyntax)() IsNot Nothing Then
                Return ImmutableArray(Of RecommendedKeyword).Empty
            End If

            ' Are we inside an attribute block? They're at least not allowed as the attribute itself
            If targetToken.Parent.IsKind(SyntaxKind.AttributeList) Then
                Return ImmutableArray(Of RecommendedKeyword).Empty
            End If

            ' Are we in an Imports statement? Type keywords aren't allowed there, just fully qualified type names
            If targetToken.GetAncestor(Of ImportsStatementSyntax)() IsNot Nothing Then
                Return ImmutableArray(Of RecommendedKeyword).Empty
            End If

            ' Are we after Inherits or Implements? Type keywords aren't allowed here.
            If targetToken.IsChildToken(Of InheritsStatementSyntax)(Function(n) n.InheritsKeyword) OrElse
               targetToken.IsChildToken(Of ImplementsStatementSyntax)(Function(n) n.ImplementsKeyword) Then
                Return ImmutableArray(Of RecommendedKeyword).Empty
            End If

            If context.IsTypeContext Then
                Return GetIntrinsicTypeKeywords(context)
            End If

            Return ImmutableArray(Of RecommendedKeyword).Empty
        End Function

        Private Shared ReadOnly s_intrinsicKeywordNames As String() = {
            "Boolean",
            "Byte",
            "Char",
            "Date",
            "Decimal",
            "Double",
            "Integer",
            "Long",
            "Object",
            "SByte",
            "Short",
            "Single",
            "String",
            "UInteger",
            "ULong",
            "UShort"}

        Private Shared ReadOnly s_intrinsicSpecialTypes As SByte() = {
            SpecialType.System_Boolean,
            SpecialType.System_Byte,
            SpecialType.System_Char,
            SpecialType.System_DateTime,
            SpecialType.System_Decimal,
            SpecialType.System_Double,
            SpecialType.System_Int32,
            SpecialType.System_Int64,
            SpecialType.System_Object,
            SpecialType.System_SByte,
            SpecialType.System_Int16,
            SpecialType.System_Single,
            SpecialType.System_String,
            SpecialType.System_UInt32,
            SpecialType.System_UInt64,
            SpecialType.System_UInt16}

        Private Shared Function GetIntrinsicTypeKeywords(context As VisualBasicSyntaxContext) As ImmutableArray(Of RecommendedKeyword)
            Debug.Assert(s_intrinsicKeywordNames.Length = s_intrinsicSpecialTypes.Length)

            Dim inferredSpecialTypes = context.InferredTypes.Select(Function(t) t.SpecialType).ToSet()

            Dim recommendedKeywords(s_intrinsicKeywordNames.Length - 1) As RecommendedKeyword
            For i = 0 To s_intrinsicKeywordNames.Length - 1
                Dim keyword As String = s_intrinsicKeywordNames(i)
                Dim specialType As SpecialType = DirectCast(s_intrinsicSpecialTypes(i), SpecialType)

                Dim priority = If(inferredSpecialTypes.Contains(specialType), SymbolMatchPriority.Keyword, MatchPriority.Default)

                recommendedKeywords(i) = New RecommendedKeyword(s_intrinsicKeywordNames(i), Glyph.Keyword,
                                                                Function(cancellationToken)
                                                                    Dim tooltip = GetDocumentationCommentText(context, specialType, cancellationToken)
                                                                    Return RecommendedKeyword.CreateDisplayParts(keyword, tooltip)
                                                                End Function, isIntrinsic:=True, matchPriority:=priority)
            Next

            Return recommendedKeywords.ToImmutableArray()
        End Function

        Private Shared Function GetDocumentationCommentText(context As VisualBasicSyntaxContext, type As SpecialType, cancellationToken As CancellationToken) As String
            Dim symbol = context.SemanticModel.Compilation.GetSpecialType(type)
            Return symbol.GetDocumentationComment(context.SemanticModel.Compilation, Globalization.CultureInfo.CurrentUICulture, expandIncludes:=True, expandInheritdoc:=True, cancellationToken:=cancellationToken).SummaryText
        End Function
    End Class
End Namespace