ASP.NET邮件找回密码实现报错：类型转换及Web类未找到

问题描述 #

我正在ASP.NET Web应用中实现密码找回功能，但遇到了两个问题：

1. 代码中myMessage.From = new MailAddress( "mymail@gmail.com", "Joe S.")出现错误CS0029：无法将System.Net.MailAddress隐式转换为SendGrid.Helpers.Mail.Address；
2. var transportWeb = new Web(credentials)中Web类未找到。

我已经安装了SendGrid NuGet包，相关代码如下：

public class EmailService : IIdentityMessageService { 
    public async Task SendAsync(IdentityMessage message) { 
        await configSendGridasync(message); 
    } 
    // Use NuGet to install SendGrid (Basic C# client lib) 
    private async Task configSendGridasync(IdentityMessage message) { 
        var myMessage = new SendGridMessage(); 
        myMessage.AddTo(message.Destination); 
        myMessage.From = new MailAddress( "mymail@gmail.com", "Joe S."); 
        myMessage.Subject = message.Subject; 
        myMessage.PlainTextContent = message.Body; 
        myMessage.HtmlContent = message.Body; 
        var credentials = new NetworkCredential( 
            ConfigurationManager.AppSettings["mailAccount"], 
            ConfigurationManager.AppSettings["mailPassword"] 
        ); 
        // Create a Web transport for sending email. 
        var transportWeb = new Web(credentials); 
        // Send the email. 
        if (transportWeb != null) { 
            await transportWeb.DeliverAsync(myMessage); 
        } else { 
            Trace.TraceError("Failed to create Web transport."); 
            await Task.FromResult(0); 
        } 
    } 
}

问题原因与解决方案 #

这两个问题的核心是你使用的是SendGrid旧版API的代码，但安装了v9及以上的新版SendGrid包——SendGrid在v9版本对整个客户端API做了彻底重构，旧的Web类、NetworkCredential认证方式以及SendGridMessage的属性用法都被废弃了。我来一步步帮你解决：

1. 解决类型转换错误

旧版中SendGridMessage.From接受System.Net.MailAddress，但新版要求使用SendGrid.Helpers.Mail.Address（SendGrid自身定义的地址类），直接实例化这个类即可：

var from = new SendGrid.Helpers.Mail.Address("mymail@gmail.com", "Joe S.");

2. 解决Web类找不到的问题

新版中Web类被移除，取而代之的是SendGridClient，同时认证方式从用户名密码改为SendGrid API Key（更安全，也是官方推荐的方式）。你需要：

• 登录SendGrid控制台创建一个具有「发送邮件」权限的API Key；
• 将API Key添加到你的web.config的AppSettings中：

  <appSettings>
    <add key="SendGridApiKey" value="你的SendGrid API Key"/>
  </appSettings>
  

修正后的完整代码

下面是适配新版SendGrid的代码：

using SendGrid;
using SendGrid.Helpers.Mail;
using System.Net;
using System.Threading.Tasks;
using System.Web.Configuration;
using System.Diagnostics;

public class EmailService : IIdentityMessageService
{
    public async Task SendAsync(IdentityMessage message)
    {
        await configSendGridasync(message);
    }

    private async Task configSendGridasync(IdentityMessage message)
    {
        // 从配置中获取SendGrid API Key
        var apiKey = WebConfigurationManager.AppSettings["SendGridApiKey"];
        var client = new SendGridClient(apiKey);

        // 创建发件人和收件人地址（使用SendGrid的Address类）
        var from = new Address("mymail@gmail.com", "Joe S.");
        var to = new Address(message.Destination);

        // 使用MailHelper快速创建单封邮件
        var msg = MailHelper.CreateSingleEmail(from, to, message.Subject, message.Body, message.Body);

        // 发送邮件并检查响应
        var response = await client.SendEmailAsync(msg);
        if (response.StatusCode != HttpStatusCode.Accepted && response.StatusCode != HttpStatusCode.OK)
        {
            Trace.TraceError($"邮件发送失败，状态码：{response.StatusCode}");
        }
    }
}

额外注意事项

• 确保你安装的是最新版的SendGrid NuGet包（可以在NuGet包管理器中搜索「SendGrid」并安装最新版）；
• 如果你之前安装了旧版SendGrid包，建议先卸载再安装新版，避免依赖冲突；
• 确认你的SendGrid账户已经完成邮箱验证，否则可能无法发送邮件。

内容的提问来源于stack exchange，提问作者MeatBallKing