Microsoft Open XML SDK 2.5 - kann ich mich auf undokumentierte öffentliche Methoden verlassen?

Question

Über Intellisense habe ich festgestellt, dass die DocumentFormat.OpenXml.Packaging.WordprocessingDocument-Klasse öffentliche Methoden ToFlatOpcString()/ToFlatOpcDocument(), die (wie der Name schon sagt) das OpenXml-Dokument in eine Zeichenfolge/XDocument im Flat-OPC-Format konvertiert .

Die API documents verweisen jedoch nicht auf diese Methoden - bedeutet das, dass sie von Microsoft in einem späteren Update entfernt werden? Ist es sicher, sich auf diese undokumentierten öffentlichen Methoden zu verlassen?

Answer 1

Antworten auf Ihre Fragen:

1. Bedeutet dies, dass sie in Gefahr sind, in einem späteren Update von Microsoft entfernt werden?

Keine api Dokumentation bedeutet nicht, sie Gefahr mehr sind von Microsoft als Verfahren entfernt werden, die Dokumentation haben.

2. Ist es sicher, auf diese undokumentierten öffentlichen Methoden verlassen

Absolut.

Weitere Informationen:

Im Jahr 2014 Microsoft made the announcement, dass die OpenXml Bibliothek ist die open source model zu folgen. Sie können den gesamten Code herunterladen und diese Methoden über die OpenXml GitHub site überprüfen. Sie können den Code sogar aufteilen und von Ihrem neuen Repository abarbeiten, um sich gegen den Fall zu schützen, in dem Microsoft sich entschieden hat, Methoden abzulehnen.

Ein quick search zeigt die Methode hat Dokumentation in der GitHub Repo.