Office 常用 API 错误代码
本文介绍了在使用通用 API 模型时可能会遇到的错误消息。 这些错误代码不适用于特定于应用程序的 API，例如 Excel JavaScript API 或 Word JavaScript API。
请参阅 API 模型 ，详细了解通用 API 模型与特定于应用程序的 API 模型之间的差异。
错误代码
下表列出了显示的错误代码、名称和消息，及其指示的条件。
| Error.code | Error.name | Error.message | 条件 | |||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1000 | 强制类型无效 | 不支持指定的强制类型 | Office 应用程序中不支持强制类型。 (例如，Excel.) 不支持 OOXML 和 HTML 强制类型 | |||||||||||||||||||||||||||||
| 1001 | 数据读取错误 | 不支持当前所选内容。 | 不支持用户当前所选内容（即与受支持的强制类型有所不同）。 | |||||||||||||||||||||||||||||
| 1002 | 强制类型无效 | 指定的强制类型与此绑定类型不兼容。 | 解决方案开发人员提供了强制类型和绑定类型的不兼容组合。 | |||||||||||||||||||||||||||||
| 1003 | 数据读取错误 | 指定的 rowCount 或 columnCount 值无效。 | 用户提供无效的列或行计数。 | |||||||||||||||||||||||||||||
| 1004 | 数据读取错误 | 当前选定内容与指定的强制类型不兼容。 | 当前选定内容不支持此应用程序指定的强制类型。 | |||||||||||||||||||||||||||||
| 1005 | 数据读取错误 | 指定的 startRow 或 startColumn 值无效。 | 用户提供的 startRow 或 startCol 值无效。 | |||||||||||||||||||||||||||||
| 1006 | 数据读取错误 | 如果表格包含合并单元格，则坐标参数不能用于强制类型“Table”。 | 用户尝试获取非统一表格（即包含合并单元格的表格）的部分数据。 | |||||||||||||||||||||||||||||
| 1007 | 数据读取错误 | 文档太大。 | 用户尝试获取大于当前支持大小的文档。 | |||||||||||||||||||||||||||||
| 1008 | 数据读取错误 | 请求的数据集太大。 | 用户请求读取超出 Office 应用程序定义的数据限制的数据。 | |||||||||||||||||||||||||||||
| 1009 | 数据读取错误 | 不支持指定的文件类型。 | 用户发送的文件类型无效。 | |||||||||||||||||||||||||||||
| 2000 | 数据写入错误 | 不支持提供的数据对象类型。 | 提供了不受支持的数据对象。 | |||||||||||||||||||||||||||||
| 2001 | 数据写入错误 | 无法写入当前所选内容。 | 写入操作不支持用户的当前选择。 (例如，当用户选择 image 时。) | |||||||||||||||||||||||||||||
| 2002 | 数据写入错误 | 提供的数据对象与当前所选内容的形状或尺寸不兼容。 | 选择了多个单元格（且所选内容的形状与数据的形状不匹配）。 选择了多个单元格（且所选内容的尺寸与数据的尺寸不匹配）。 | |||||||||||||||||||||||||||||
| 2003 | 数据写入错误 | 设置操作失败，因为提供的数据对象将覆盖数据。 | 选择了单个单元格，且提供的数据对象将覆盖工作簿中的数据。 | |||||||||||||||||||||||||||||
| 2004 | 数据写入错误 | 提供的数据对象与当前所选内容的大小不匹配。 | 用户提供的对象大于当前所选内容的大小。 | |||||||||||||||||||||||||||||
| 2005 | 数据写入错误 | 指定的 startRow 或 startColumn 值无效。 | 用户提供的 startRow 或 startCol 值无效。 | |||||||||||||||||||||||||||||
| 2006 | 无效格式错误 | 指定数据对象的格式无效。 | 解决方案开发人员提供了无效的 HTML 或 OOXML 字符串、格式错误的 HTML 字符串或无效的 OOXML 字符串。 | |||||||||||||||||||||||||||||
| 2007 | 数据对象无效 | 指定数据对象的类型与当前所选内容不兼容。 | 解决方案开发人员提供的数据对象与指定的强制类型不兼容。 | |||||||||||||||||||||||||||||
| 2008 | 数据写入错误 | TBD | TBD | |||||||||||||||||||||||||||||
| 2009 | 数据写入错误 | 指定的数据对象太大。 | 用户尝试设置的数据超出了 Office 应用程序定义的数据限制。 | |||||||||||||||||||||||||||||
| 2010 | 数据写入错误 | 如果表格包含合并单元格，则坐标参数不能用于强制类型"Table"。 | 用户尝试设置非统一表格（即包含合并单元格的表格）的部分数据。 | |||||||||||||||||||||||||||||
| 3000 | 绑定创建错误 | 无法绑定到当前所选内容。 | 不支持用户的选择进行绑定。 (例如，用户正在选择图像或其他不受支持的对象。) | |||||||||||||||||||||||||||||
| 3001 | 绑定创建错误 | TBD | TBD | |||||||||||||||||||||||||||||
| 3002 | 无效绑定错误 | 指定绑定不存在。 | 开发人员尝试绑定到不存在或已删除的绑定。 | |||||||||||||||||||||||||||||
| 3003 | 绑定创建错误 | 不支持非连续的所选内容。 | 用户进行多重选择。 | |||||||||||||||||||||||||||||
| 3004 | 绑定创建错误 | 无法使用当前所选内容和指定绑定类型创建绑定。 | 有几种情况下可能发生此错误。 请参阅本文后面的"绑定创建错误条件"部分。 | |||||||||||||||||||||||||||||
| 3005 | 绑定操作无效 | 此绑定类型不支持操作。 | 开发人员对不是强制 table类型的绑定类型发送添加行或添加列操作。 |
|||||||||||||||||||||||||||||
| 3006 | 绑定创建错误 | 命名项不存在。 | 无法找到命名项。 不存在此名称的内容控件或表格。 | |||||||||||||||||||||||||||||
| 3007 | 绑定创建错误 | 找到具有相同名称的多个对象。 | 冲突错误：存在多个同名的内容控件，冲突失败设置为 true。 |
|||||||||||||||||||||||||||||
| 3008 | 绑定创建错误 | 指定的绑定类型与提供的命名项不兼容。 | 命名项不能绑定到类型。 例如，内容控件包含文本，但开发人员尝试使用强制类型 table进行绑定。 |
|||||||||||||||||||||||||||||
| 3009 | 绑定操作无效 | 不支持绑定类型。 | 用于向后兼容性。 | |||||||||||||||||||||||||||||
| 3010 | 不受支持的绑定操作 | 所选内容需为表格格式。 将数据格式化为表格并再次尝试。 | 开发人员尝试对强制类型 matrix的数据使用 addRowsAsync 对象的 或 deleteAllDataValuesAsync 方法TableBinding。 |
|||||||||||||||||||||||||||||
| 4000 | 读取设置错误 | 指定设置名称不存在。 | 提供了不存在的设置名称。 | |||||||||||||||||||||||||||||
| 4001 | 保存设置错误 | 无法保存设置。 | 无法保存设置。 | |||||||||||||||||||||||||||||
| 4002 | 设置过期错误 | 无法保存设置，因为设置已过期。 | 设置已过期，开发人员指示不要覆盖设置。 | |||||||||||||||||||||||||||||
| 5000 | 设置过期错误 | 不支持此操作。 | 当前 Office 应用程序中不支持此操作。 例如， document.getSelectionAsync 从 Outlook 调用 。 |
|||||||||||||||||||||||||||||
| 5001 | 内部错误 | 发生内部错误。 | 请参阅内部错误情况，可能有以下几个原因。
|
|||||||||||||||||||||||||||||
| 5002 | 权限被拒绝 | 当前文档模式不允许请求的操作。 | 解决方案开发人员提交一组操作，但文档模式不允许进行修改，如"限制编辑"。 | |||||||||||||||||||||||||||||
| 5003 | 事件注册错误 | 当前对象不支持指定事件类型。 | 解决方案开发人员尝试对不存在的事件注册或取消注册处理程序。 | |||||||||||||||||||||||||||||
| 5004 | 无效的 API 调用 | 当前上下文中无效的 API 调用。 | 对上下文进行无效调用，例如，尝试在 Excel 中使用 CustomXMLPart 对象。 |
|||||||||||||||||||||||||||||
| 5005 | 数据过期 | 操作失败，因为服务器上的数据已过期。 | 需要刷新服务器上的数据。 | |||||||||||||||||||||||||||||
| 5006 | 会话超时 | 文档会话超时。重新加载文档。 | 会话已超时。 | |||||||||||||||||||||||||||||
| 5007 | 无效的 API 调用 | 当前上下文中不支持枚举。 | 当前上下文中不支持枚举。 | |||||||||||||||||||||||||||||
| 5009 | 权限被拒绝 | 访问被拒绝 | 加载项没有调用特定 API 的权限。 | |||||||||||||||||||||||||||||
| 5012 | 会话无效或超时 | Office 浏览器会话已过期或无效。 若要继续操作，请刷新页面。 | Office 客户端和服务器之间的会话已过期，或你的计算机上的日期、时间或时区不正确。 | |||||||||||||||||||||||||||||
| 6000 | 无效节点 | 未找到指定节点。 |
CustomXmlPart找不到节点。 |
|||||||||||||||||||||||||||||
| 6100 | 自定义 XML 错误 | 自定义 XML 错误 | 无效的 API 调用。 | |||||||||||||||||||||||||||||
| 7000 | ID 无效 | 指定 ID 不存在。 | ID 无效。 | |||||||||||||||||||||||||||||
| 7001 | 导航无效 | 导航不支持对象位置。 | 用户可以找到 对象，但无法导航到该对象。 (例如，在 Word 中，绑定指向页眉、页脚或注释。) | |||||||||||||||||||||||||||||
| 7002 | 导航无效 | 对象已锁定或受保护。 | 用户尝试导航到被阻止或受保护的范围。 | |||||||||||||||||||||||||||||
| 7004 | 导航无效 | 操作失败，索引已超出范围。 | 用户尝试导航到索引，但超出范围。 | |||||||||||||||||||||||||||||
| 8000 | 参数缺失 | 无法格式化表格单元格，因为缺失某些参数值。 请仔细检查参数并再次尝试。 | cellFormat 方法缺失某些参数。 例如，缺失单元格、格式或 tableOptions 参数。 | |||||||||||||||||||||||||||||
| 8010 | 值无效 | 一个或多个单元格参数包含不允许的值。 请仔细检查值并再次尝试。 | 未定义常见单元格引用枚举。 例如，All、Data、Headers。 | |||||||||||||||||||||||||||||
| 8011 | 值无效 | 一个或多个 tableOptions 参数包含不允许的值。 请仔细检查值并再次尝试。 | tableOptions 中的某个值无效。 | |||||||||||||||||||||||||||||
| 8012 | 值无效 | 一个或多个格式参数包含不允许的值。 请仔细检查值并再次尝试。 | 格式中的某个值无效。 | |||||||||||||||||||||||||||||
| 8020 | 超出范围 | 行索引值超出允许的范围。 请使用一个小于行数的正值（大于等于 0）。 | 行索引大于表格的最大行索引或小于 0。 | |||||||||||||||||||||||||||||
| 8021 | 超出范围 | 列索引值超出允许的范围。 请使用一个小于列数的正值（大于等于 0）。 | 列索引大于表格最大列索引或小于 0。 | |||||||||||||||||||||||||||||
| 8022 | 超出范围 | 值超出允许的范围。 | 格式中的某些值超出支持的范围。 | |||||||||||||||||||||||||||||
| 9016 | 权限被拒绝 | 权限被拒绝 | 访问被拒绝。 | |||||||||||||||||||||||||||||
| 9020 | 泛型响应错误 | 发生内部错误。 | 指内部错误条件，该条件可能由于任意数量的原因而发生。 | |||||||||||||||||||||||||||||
| 9021 | 保存错误 | 尝试在服务器上保存项时发生连接错误。 | 无法保存该项。 这可能是由于在 Outlook 桌面中使用联机模式时出现服务器连接错误，或者由于尝试重新保存从 Exchange 服务器中删除的草稿项目。 | |||||||||||||||||||||||||||||
| 9022 | 不同存储区中的消息错误 | 无法检索 EWS ID，因为消息保存在另一个存储区中。 | 无法检索当前邮件的 EWS ID，因为邮件可能已移动或发送邮箱可能已更改。 | |||||||||||||||||||||||||||||
| 9041 | 网络错误 | 用户不再连接到网络。 请检查网络连接并重试。 | 用户不再具有网络或 Internet 访问权限。 | |||||||||||||||||||||||||||||
| 9043 | 不支持附件类型 | 不支持附件类型。 | API 不支持附件类型。 例如， item.getAttachmentContentAsync 如果附件是 RTF 格式的嵌入图像，或者它是电子邮件或日历项以外的项目类型， (如联系人或任务项) ，则引发此错误。 |
|||||||||||||||||||||||||||||
| 9057 | 超出大小限制 | 每个加载项的设置最多有 32KB 可用。 | 通过 Office.context.roamingSettings.set 更新漫游设置时，大小不能超过 32KB。 请参阅 Office.RoamingSettings 接口。 | |||||||||||||||||||||||||||||
| 12002 | 不适用 | 不适用 | 下列一种含义： - 传递给 displayDialogAsync 的 URL 没有对应的页面。- 传递给 displayDialogAsync 的页面已加载，但对话框定向到找不到或无法加载的页面，或者已定向到使用无效语法的 URL。 在对话框中引发并在主机页面中触发 DialogEventReceived 事件。 |
|||||||||||||||||||||||||||||
| 12003 | 不适用 | 不适用 | 对话框定向到使用 HTTP 协议的 URL。 必须使用 HTTPS。 在对话框中引发并在主机页面中触发 DialogEventReceived 事件。 |
|||||||||||||||||||||||||||||
| 12004 | 不适用 | 不适用 | 传递给 displayDialogAsync 的 URL 的域不受信任。 此域必须与主机页的域相同（包括协议和端口号）。 由 displayDialogAsync 的调用引发。 |
|||||||||||||||||||||||||||||
| 12005 | 不适用 | 不适用 | 传递给 displayDialogAsync 的 URL 使用 HTTP 协议。 必须使用 HTTPS。 由 displayDialogAsync 的调用引发。 （在 Office 的某些版本中，返回 12005 的错误消息与返回 12004 错误消息是相同的。） |
|||||||||||||||||||||||||||||
| 12006 | 不适用 | 不适用 | 对话框已关闭，通常是因为用户选择了 X 按钮。 在对话框中引发并在主机页面中触发 DialogEventReceived 事件。 |
|||||||||||||||||||||||||||||
| 12007 | 不适用 | 不适用 | 已从此主机窗口打开了一个对话框。 主机窗口（如任务窗格）一次只能打开一个对话框。 由 displayDialogAsync 的调用引发。 |
|||||||||||||||||||||||||||||
| 12009 | 不适用 | 不适用 | 用户已选择忽略对话框。 联机版本的 Office 中可能会发生此错误，用户可能会选择不允许加载项显示对话框。 由 displayDialogAsync 的调用引发。 |
|||||||||||||||||||||||||||||
| 12011 | 不适用 | 不适用 | 用户的浏览器的配置方式是阻止弹出窗口。 如果浏览器是 Safari 且配置为阻止弹出窗口，或者浏览器是 Edge 旧版，并且加载项域位于与对话框尝试打开的域不同的安全区域，则 Office 网页版中可能会出现此错误。 由 displayDialogAsync 的调用引发。 |
|||||||||||||||||||||||||||||
| 13nnn | 不适用 | 不适用 | 请参阅 getAccessToken 错误的原因和处理。 |
绑定创建错误条件
在 API 中创建绑定时，指明要使用的绑定类型。 下表列出了绑定类型和生成的预期绑定行为。
Excel 中的行为
下表汇总了 Excel 中的绑定行为。
| 指定绑定类型 | 实际选择 | 行为 |
|---|---|---|
| 矩阵 | 单元格范围（包括表格和单个单元格范围内） | 在所选单元格上创建类型的 matrix 绑定。 不得修改文档。 |
| Matrix | 单元格中选定的文本 | 将在整个单元格上创建类型的 matrix 绑定。 不得修改文档。 |
| Matrix | 多重选择/选择无效（例如，用户选择了图片、对象或艺术字。） | 无法创建绑定。 |
| Table | 单元格范围（包括单个单元格） | 无法创建绑定。 |
| Table | 表格内单元格的范围（包括表格中单个单元格、整张表格或表格中单元格内的文本） | 已在整张表格中创建绑定。 |
| Table | 表格中和表格外的半选定 | 无法创建绑定。 |
| Table | 单元格（而非表格）中选定的文本。 | 无法创建绑定。 |
| Table | 多重选择/选择无效（例如，用户选择了图片、对象、艺术字等。） | 无法创建绑定。 |
| 文本 | 单元格范围 | 无法创建绑定。 |
| 文本 | 表格内的单元格范围 | 无法创建绑定。 |
| 文本 | 单个单元格 | 将创建类型的 text 绑定。 |
| Text | 表格内的单个单元格 | 将创建类型的 text 绑定。 |
| Text | 单元格中选定的文本 | 将在整个单元格中创建类型的 text 绑定。 |
Word 中的行为
下表汇总了 Word 中的绑定行为。
| 指定绑定类型 | 实际选择 | 行为 |
|---|---|---|
| 矩阵 | 文本 | 无法创建绑定。 |
| Matrix | 整张表格 | 将创建类型的 matrix 绑定。文档已更改，并且内容控件必须包装表。 |
| 矩阵 | 表格范围内 | 无法创建绑定。 |
| Matrix | 选择无效（例如，多个对象、无效对象等。） | 无法创建绑定。 |
| Table | 文本 | 无法创建绑定。 |
| Table | 整张表格 | 将创建类型的 text 绑定。 |
| 表格 | 表格范围内 | 无法创建绑定。 |
| Table | 选择无效（例如，多个对象、无效对象等。） | 无法创建绑定。 |
| 文本 | 整张表格 | 将创建类型的 text 绑定。 |
| Text | 表格范围内 | 无法创建绑定。 |
| 文本 | 多重选择 | 最后的选定内容必须与内容控件一同打包，并绑定到该控件。 将创建类型 text 为 的内容控件。 |
| Text | 选择无效（例如，多个对象、无效对象等。） | 无法创建绑定。 |