PowerShell填充Word内容控件时ContentControl.Range.Text赋值失效

• 第一步清理Excel读取值的隐形字符
  Excel单元格大概率包含换行、回车、非打印控制字符或不间断空格，这类字符会导致Word纯文本内容控件识别异常，直接触发占位符重置。可以先对取值做清洗：

# 清理所有控制字符和不间断空格
[string]$FieldContent = $Workbook.Names($FieldName).RefersToRange.Value()
$FieldContent = $FieldContent.Trim() -replace '[\x00-\x1F\x7F]','' -replace [char]160,' '

清洗后可以输出字符编码验证是否正常：
$FieldContent.ToCharArray() | ForEach-Object { Write-Host "字符：$_，ASCII码：$([int]$_)" }

• 第二步更换内容控件赋值方式
  直接给Range.Text赋值对部分版本Office的内容控件兼容性不佳，推荐调用官方SetText方法赋值，兼容性更强：

# 替换原$control.Range.Text = $FieldContent 为以下代码
$control.Range.SetText($FieldContent)
# 赋值后锁定内容避免自动回退占位符
$control.LockContents = $true

• 第三步增加控件类型过滤
  确保仅处理纯文本类型的内容控件，避免误操作其他类型（如下拉框、日期控件）导致赋值失效，纯文本内容控件的类型枚举值为2：

ForEach($Control in $Doc.ContentControls)
{
    # 仅处理纯文本内容控件
    if($Control.Type -ne 2) {
        continue
    }
    # 后续原有逻辑
}

• 第四步验证Office互操作版本兼容性
  如果上述操作都无效，可以检查当前加载的Office Interop程序集版本，和目标Office版本是否匹配，部分低版本Interop程序集操作高版本Word文档会出现内容控件赋值异常。

修改后可直接测试的完整代码 #

ForEach($Control in $Doc.ContentControls)
{
    # 过滤非纯文本内容控件
    if($Control.Type -ne 2) {
        continue
    }
    Write-Host $control.Title
    [string]$FieldName = $control.Title.Trim()
    [string]$FieldContent = $Workbook.Names($FieldName).RefersToRange.Value()
    # 清洗隐形字符
    $FieldContent = $FieldContent.Trim() -replace '[\x00-\x1F\x7F]','' -replace [char]160,' '
    Write-Host "清洗后内容：$FieldContent，长度：$($FieldContent.Length)"
    
    $control.LockContents = $False
    $control.LockContentControl = $False
    # 调用SetText方法赋值
    $control.Range.SetText($FieldContent)
    $control.LockContents = $True
}

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