Microsoft Open XML SDK 2.5 - 我可以依赖未记录的 public 方法吗?
Microsoft Open XML SDK 2.5 - can I rely on undocumented public methods?
通过 Intellisense,我发现 DocumentFormat.OpenXml.Packaging.WordprocessingDocument class 公开了 public 方法 ToFlatOpcString()/ToFlatOpcDocument(),它(顾名思义)转换 OpenXml 文档到 Flat OPC 格式的 string/XDocument。
但是,API documents 没有提及这些方法 - 这是否意味着它们有可能在以后的更新中被 Microsoft 删除?依赖这些未记录的 public 方法安全吗?
您问题的答案:
- Does this mean they are at risk of being removed by Microsoft in a later update?
没有 api 文档并不意味着它们比有文档的方法更容易被 Microsoft 删除。
- Is it safe to rely on these undocumented public methods
绝对。
更多信息:
2014 年,微软made the announcement that the OpenXml library is to follow the open source model. You can download all of the code and review these methods via the OpenXml GitHub site。您甚至可以分叉代码并使用您的新存储库来防止 Microsoft 确实决定弃用方法的情况。
A quick search 显示该方法在 GitHub 存储库中有文档。
通过 Intellisense,我发现 DocumentFormat.OpenXml.Packaging.WordprocessingDocument class 公开了 public 方法 ToFlatOpcString()/ToFlatOpcDocument(),它(顾名思义)转换 OpenXml 文档到 Flat OPC 格式的 string/XDocument。
但是,API documents 没有提及这些方法 - 这是否意味着它们有可能在以后的更新中被 Microsoft 删除?依赖这些未记录的 public 方法安全吗?
您问题的答案:
- Does this mean they are at risk of being removed by Microsoft in a later update?
没有 api 文档并不意味着它们比有文档的方法更容易被 Microsoft 删除。
- Is it safe to rely on these undocumented public methods
绝对。
更多信息:
2014 年,微软made the announcement that the OpenXml library is to follow the open source model. You can download all of the code and review these methods via the OpenXml GitHub site。您甚至可以分叉代码并使用您的新存储库来防止 Microsoft 确实决定弃用方法的情况。
A quick search 显示该方法在 GitHub 存储库中有文档。