如何为Exchange邮件添加更新自定义属性以同步SQL数据库？

一、先搞定Exchange自定义属性 #

你需要在Exchange里注册一个自定义扩展属性，用来存邮件的唯一标识，后续靠它判断是否已处理。有两种方式：

• PowerShell操作（适用于本地Exchange或Exchange Online）：

  # 连接Exchange Online（本地的话换Connect-ExchangeServer）
  Connect-ExchangeOnline
  # 创建名为"ProcessedUniqueId"的字符串类型自定义属性，指定目标邮箱
  New-ExtendedPropertyDefinition -Name "ProcessedUniqueId" -Type String -Mailbox "目标邮箱地址"
  

• 代码中动态定义（C# + EWS Managed API）：

  var processedIdProp = new ExtendedPropertyDefinition(DefaultExtendedPropertySet.PublicStrings, "ProcessedUniqueId", MapiPropertyType.String);
  

二、读取邮件时检查标记 #

在你已有的邮件读取逻辑里加一步检查：

• 读取邮件时，同时拉取这个ProcessedUniqueId属性的值
• 如果属性存在且不为空，说明这邮件已经处理过，直接跳过
• 如果属性不存在或为空，就判定为未处理，走插入SQL的流程

三、插入SQL后给邮件打标记 #

邮件成功插入SQL数据库后，立刻给Exchange里的对应邮件加上这个自定义属性：

• 可以直接用Exchange邮件原生的UniqueId作为标记值（天生唯一，不用自己生成Guid）
• 通过EWS或者PowerShell把这个值写入自定义属性，确保后续再读取时能识别到已处理

四、C#代码示例（基于EWS Managed API） #

// 初始化EWS服务
ExchangeService ewsService = new ExchangeService(ExchangeVersion.Exchange2016);
ewsService.Credentials = new WebCredentials("你的账号", "你的密码");
ewsService.Url = new Uri("https://你的Exchange服务器地址/EWS/Exchange.asmx");

// 定义自定义属性
ExtendedPropertyDefinition processedIdProp = new ExtendedPropertyDefinition(DefaultExtendedPropertySet.PublicStrings, "ProcessedUniqueId", MapiPropertyType.String);

// 读取收件箱邮件（分页读取，避免一次性拉太多）
Folder inbox = Folder.Bind(ewsService, WellKnownFolderName.Inbox);
ItemView itemView = new ItemView(50);
// 读取时包含自定义属性，减少后续额外请求
itemView.PropertySet = new PropertySet(BasePropertySet.FirstClassProperties) { processedIdProp };
FindItemsResults<Item> mailItems = ewsService.FindItems(inbox.Id, itemView);

foreach (Item mail in mailItems)
{
    object processedId;
    // 检查是否已存在标记属性
    if (mail.TryGetProperty(processedIdProp, out processedId) && processedId != null)
    {
        continue; // 已处理，跳过
    }

    // 1. 执行SQL插入逻辑（替换成你自己的代码）
    InsertMailToSql(mail.Subject, mail.Body.Text, mail.DateTimeReceived, mail.Id.UniqueId);

    // 2. 给邮件添加标记属性，标记为已处理
    mail.SetExtendedProperty(processedIdProp, mail.Id.UniqueId);
    mail.Update(ConflictResolutionMode.AlwaysOverwrite);
}

五、需要注意的点 #

• 权限：运行代码的账号必须有目标邮箱的读写权限，不然改不了邮件属性
• 批量处理：一定要分页读取邮件，一次性拉几百上千封会拖垮性能
• 异常处理：给SQL插入和属性更新加try-catch，比如插入失败就不要打标记，避免数据不一致
• 幂等性：就算重复跑脚本，已标记的邮件会被跳过，不会重复插入SQL

内容的提问来源于stack exchange，提问作者SK-USA