File: CodeFixes\CodeFix.cs
Web Access
Project: src\src\Workspaces\Core\Portable\Microsoft.CodeAnalysis.Workspaces.csproj (Microsoft.CodeAnalysis.Workspaces)
// 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.Collections.Generic;
using System.Collections.Immutable;
using System.Diagnostics;
using System.Linq;
using Microsoft.CodeAnalysis.CodeActions;
using Microsoft.CodeAnalysis.Diagnostics;
 
namespace Microsoft.CodeAnalysis.CodeFixes;
 
/// <summary>
/// Represents a single fix. This is essentially a tuple
/// that holds on to a <see cref="CodeAction"/> and the set of
/// <see cref="Diagnostic"/>s that this <see cref="CodeAction"/> will fix.
/// </summary>
internal sealed class CodeFix
{
    internal readonly Project Project;
    internal readonly CodeAction Action;
    internal readonly ImmutableArray<Diagnostic> Diagnostics;
 
    /// <summary>
    /// This is the diagnostic that will show up in the preview pane header when a particular fix
    /// is selected in the light bulb menu. We also group all fixes with the same <see cref="PrimaryDiagnostic"/>
    /// together (into a single SuggestedActionSet) in the light bulb menu.
    /// </summary>
    /// <remarks>
    /// A given fix can fix one or more diagnostics. However, our light bulb UI (preview pane, grouping
    /// of fixes in the light bulb menu etc.) currently keeps things simple and pretends that
    /// each fix fixes a single <see cref="PrimaryDiagnostic"/>.
    /// 
    /// Implementation-wise the <see cref="PrimaryDiagnostic"/> is always the first diagnostic that
    /// the <see cref="CodeFixProvider"/> supplied when registering the fix (<see 
    /// cref="CodeFixContext.RegisterCodeFix(CodeAction, IEnumerable{Diagnostic})"/>). This could change
    /// in the future, if we decide to change the UI to depict the true mapping between fixes and diagnostics
    /// or if we decide to use some other heuristic to determine the <see cref="PrimaryDiagnostic"/>.
    /// </remarks>
    internal Diagnostic PrimaryDiagnostic => Diagnostics[0];
 
    internal CodeFix(Project project, CodeAction action, Diagnostic diagnostic)
    {
        Project = project;
        Action = action;
        Diagnostics = [diagnostic];
    }
 
    internal CodeFix(Project project, CodeAction action, ImmutableArray<Diagnostic> diagnostics)
    {
        Debug.Assert(!diagnostics.IsDefaultOrEmpty);
        Project = project;
        Action = action;
        Diagnostics = diagnostics;
    }
 
    internal DiagnosticData GetPrimaryDiagnosticData()
    {
        var diagnostic = PrimaryDiagnostic;
 
        if (diagnostic.Location.IsInSource)
        {
            var document = Project.GetDocument(diagnostic.Location.SourceTree);
            if (document != null)
            {
                return DiagnosticData.Create(diagnostic, document);
            }
        }
        else if (diagnostic.Location.Kind == LocationKind.ExternalFile)
        {
            var document = Project.Documents.FirstOrDefault(d => d.FilePath == diagnostic.Location.GetLineSpan().Path);
            if (document != null)
            {
                return DiagnosticData.Create(diagnostic, document);
            }
        }
 
        return DiagnosticData.Create(Project.Solution, diagnostic, Project);
    }
}