src/VisualStudio/Core/Def/F1Help/AbstractHelpContextService.cs - main - githubmirror/roslyn

src/VisualStudio/Core/Def/F1Help/AbstractHelpContextService.cs

47 строк2 KB

Cyrus Najmabadi

Remove unnecessary nullable directives

25 мар 2025, 21:58

25 мар 2025, 21:582a3f854

// 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.

using System.Threading;
using System.Threading.Tasks;
using Microsoft.CodeAnalysis;
using Microsoft.CodeAnalysis.Text;

namespace Microsoft.VisualStudio.LanguageServices.Implementation.F1Help;

internal abstract class AbstractHelpContextService : IHelpContextService
{
    // MSDN Format: type parameters to types expressed as `1
    // type parameters to methods expressed as ``1
    // C`1.M``2
    // constructors: Parent.Type.#ctor
    protected static readonly SymbolDisplayFormat TypeFormat =
        new(
            globalNamespaceStyle: SymbolDisplayGlobalNamespaceStyle.Omitted,
            typeQualificationStyle: SymbolDisplayTypeQualificationStyle.NameAndContainingTypesAndNamespaces,
            propertyStyle: SymbolDisplayPropertyStyle.NameOnly,
            genericsOptions: SymbolDisplayGenericsOptions.None,
            miscellaneousOptions: SymbolDisplayMiscellaneousOptions.EscapeKeywordIdentifiers);

    protected static readonly SymbolDisplayFormat SpecialTypeFormat =
        new(
            globalNamespaceStyle: SymbolDisplayGlobalNamespaceStyle.Omitted,
            typeQualificationStyle: SymbolDisplayTypeQualificationStyle.NameOnly,
            genericsOptions: SymbolDisplayGenericsOptions.None,
            miscellaneousOptions:
                SymbolDisplayMiscellaneousOptions.EscapeKeywordIdentifiers |
                SymbolDisplayMiscellaneousOptions.UseSpecialTypes);

    protected static readonly SymbolDisplayFormat NameFormat =
        new(
            globalNamespaceStyle: SymbolDisplayGlobalNamespaceStyle.Omitted,
            typeQualificationStyle: SymbolDisplayTypeQualificationStyle.NameOnly,
            miscellaneousOptions: SymbolDisplayMiscellaneousOptions.UseSpecialTypes);

    public abstract string Language { get; }
    public abstract string Product { get; }

    public abstract Task<string> GetHelpTermAsync(Document document, TextSpan textSpan, CancellationToken cancellationToken);

    public abstract string? FormatSymbol(ISymbol symbol);
}