UWP应用向Windows剪贴板添加DataPackage时触发异常求助

常见问题排查与修复方案 #

• 确认自定义数据格式名称合规
  ConvertTypeName需使用唯一且规范的专属格式名，比如"MyApp.CopiedResourceNodes"，避免和系统内置格式冲突，防止因格式识别失败触发异常。

• 强制在UI线程执行剪贴板操作
  UWP的剪贴板操作必须在UI线程中进行，若CopyNode方法在后台线程调用，需切换到UI线程执行：

  await CoreApplication.MainView.CoreWindow.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
  {
      var dataPackage = new DataPackage();
      dataPackage.SetData("MyApp.CopiedResourceNodes", JsonConvert.SerializeObject(resourceNode));
      Clipboard.SetContent(dataPackage);
  });
  

• 设置DataPackage的操作类型
  必须指定剪贴板操作类型，否则会因权限或操作无效抛出异常：

  dataPackage.RequestedOperation = DataPackageOperation.Copy;
  

• 提前验证JSON序列化有效性
  确保CopiedResourceNodes实例能正常序列化为JSON，避免序列化失败导致的异常：

  var json = JsonConvert.SerializeObject(resourceNode);
  if(string.IsNullOrEmpty(json))
  {
      // 处理序列化失败场景
      return;
  }
  

• 捕获异常定位具体问题
  添加异常捕获逻辑，输出详细异常信息，便于精准排查：

  public void CopyNode(CopiedResourceNodes resourceNode)
  {
      try
      {
          var dataPackage = new DataPackage();
          dataPackage.RequestedOperation = DataPackageOperation.Copy;
          dataPackage.SetData("MyApp.CopiedResourceNodes", JsonConvert.SerializeObject(resourceNode));
          Clipboard.SetContent(dataPackage);
      }
      catch (Exception ex)
      {
          System.Diagnostics.Debug.WriteLine($"复制异常：{ex.Message}\n{ex.StackTrace}");
      }
  }
  

• 检查应用剪贴板权限
  在Package.appxmanifest中确认已声明剪贴板权限（默认允许，特殊配置场景需检查）：

  <Capabilities>
      <Capability Name="internetClient" />
      <uap:Capability Name="clipboard" />
  </Capabilities>
  

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