Spire.Doc バージョン 14.10.9 — 14.9.11 との詳細なアップグレード変更点

概要

このアップグレードには、いくつかの高リスクなパブリック API 変更が含まれています。最もリスクが高い項目は DocumentObjectType 列挙型の全面的な再番号付けです。再コンパイルしない場合、サイレントな動作エラーを引き起こします。

• Spire.Doc を参照するすべてのプロジェクトは完全に再コンパイルする必要があります。 DLL のみを置き換えると、MissingMethodException、TypeLoadException、または列挙定数がインライン化されるため、誤った数値のサイレント使用が発生します。
• 権限識別子が string から int に変更され、コンストラクタ、Id、コレクションの検索/インデクサ、および Paragraph.AppendPermStart/End に影響します。
• SDT（構造化文書タグ）モデルが再構築され、SDTContent/SDTInlineContent が削除され、SDT Row/Cell が TableRow/TableCell でなくなり、大量のテーブル機能が失われます。
• コレクション階層が再構築され、DocumentObjectCollection が具象クラスになり基底クラスが変更され、DocumentSubsetCollection が削除され、複数のコレクションで基底クラスが変更され、Add の戻り値が int から void に変更されます。
• 19 の型で基底クラスが変更され、メンバーが上下に移動します。ChildObjects/FirstChild/LastChild/GetIndex が DocumentObject から CompositeDocumentObject に移動します。
• 統計：パブリック型 508 → 507（+8 / -9）、パブリックメンバー 5460 → 5527（+178 / -111 / 約97）。67 の型が合計 250 の実効メンバースロットを失い、重複排除後 90 の一意なシグネチャになります。114 の型にメタデータ変更があります。

1. 比較対象とファイル情報

両バージョンの参照アセンブリリストは同一です（HarfBuzzSharp、mscorlib、System、System.Core、System.Data、System.Drawing、System.Web、System.Windows.Forms、System.Xml）。アセンブリ依存関係の追加・削除はありません。

注意：アセンブリバージョンが変更されています。.NET Framework の厳密名バインドは自動的に上位バージョンを受け入れないため、bindingRedirect がない場合、古いアプリケーションは読み込み時に失敗する可能性があります。

2. 統計概要

カウント規約：

• 「パブリックメンバー」とは BindingFlags.Public | DeclaredOnly でエクスポートされたメンバーを指し、継承メンバーは除外されます。コンストラクタはパブリックコンストラクタのみカウントされます。
• 「実効メンバーサーフェス」とは、アセンブリ内の基底クラスチェーンをマージした後にアクセス可能なメンバーを指します（コンストラクタは継承されません）。
• 「メンバースロット」は型間で重複カウントされます。同じシグネチャが複数の型に影響する場合、1 つの一意なシグネチャとしてカウントされます。
• 変更カテゴリは重複する可能性があります（例：戻り値の型とパラメータ名の両方が変更されたメンバー）。

3. 最優先の破壊的変更

3.1 DocumentObjectType 列挙型の全面的な再番号付け（最高リスク：サイレントエラー）

旧バージョンの 64 定数、新バージョンでは 62：SDT コンテンツ定数 4 つが削除、SDT Mark 定数 2 つが追加され、ほぼすべての定数の数値が変更されました。

完全なマッピングテーブル（変更されたエントリのみ記載）

旧バージョンの完全な値シーケンス

Document=0, Section=1, Body=2, HeaderFooter=3, Paragraph=4, StructureDocumentTag=5, StructureDocumentTagInline=6, StructureDocumentTagRow=7, StructureDocumentTagCell=8, SDTBlockContent=9, SDTInlineContent=10, SDTRowContent=11, SDTCellContent=12, Table=13, TableRow=14, TableCell=15, TextRange=16, Picture=17, FieldStart=18, Field=19, FieldMark=20, FieldSeparator=21, FieldEnd=22, MergeField=23, SeqField=24, EmbededField=25, ControlField=26, TextFormField=27, DropDownFormField=28, CheckBox=29, BookmarkStart=30, BookmarkEnd=31, MoveFromRangeStart=32, MoveFromRangeEnd=33, MoveToRangeStart=34, MoveToRangeEnd=35, PermissionStart=36, PermissionEnd=37, Shape=38, ShapeGroup=39, ShapeLine=40, ShapePath=41, ShapeRect=42, Comment=43, Footnote=44, TextBox=45, Break=46, Symbol=47, TOC=48, XmlParaItem=49, Undefined=50, CommentMark=51, OleObject=52, CustomXml=53, SmartTag=54, OfficeMath=55, System=56, Ruby=57, SubDocument=58, SpecialChar=59, GlossaryDocument=60, BuildingBlock=61, FormField=62, Any=63

新バージョンの完全な値シーケンス

Undefined=-2, System=-1, Any=0, Document=1, Section=2, Body=3, HeaderFooter=4, Paragraph=5, StructureDocumentTag=6, StructureDocumentTagMarkStart=7, StructureDocumentTagMarkEnd=8, StructureDocumentTagInline=9, StructureDocumentTagRow=10, StructureDocumentTagCell=11, Table=12, TableRow=13, TableCell=14, TextRange=15, Picture=16, FieldStart=17, Field=18, FieldMark=19, FieldSeparator=20, FieldEnd=21, MergeField=22, SeqField=23, EmbededField=24, ControlField=25, TextFormField=26, DropDownFormField=27, CheckBox=28, BookmarkStart=29, BookmarkEnd=30, MoveFromRangeStart=31, MoveFromRangeEnd=32, MoveToRangeStart=33, MoveToRangeEnd=34, PermissionStart=35, PermissionEnd=36, Shape=37, ShapeGroup=38, ShapeLine=39, ShapePath=40, ShapeRect=41, Comment=42, Footnote=43, TextBox=44, Break=45, Symbol=46, TOC=47, XmlParaItem=48, CommentMark=49, OleObject=50, CustomXml=51, SmartTag=52, OfficeMath=53, Ruby=54, SubDocument=55, SpecialChar=56, GlossaryDocument=57, BuildingBlock=58, FormField=59

これが最高リスクである理由：C# コンパイラは const 列挙値を呼び出しアセンブリにインライン化します。既存のアセンブリは実行時に新しい DLL の列挙値を再読み込みせず、コンパイル時の古い数値を使い続けます。例えば：

さらに、default(DocumentObjectType) は Document ではなく Any を意味するようになりました。デフォルト値、数値比較、シリアライズ/デシリアライズ、データベース保存、キャッシュに依存するコードは移行が必要です。

修正：

1. すべてのコンシューマーは新しい DLL に対して再コンパイルする必要があります。DLL の置き換えだけでは不十分です。
2. コードから数値リテラル（(DocumentObjectType)4 など）を削除し、定数名を使用します。
3. 列挙値が永続化されたことがある場合は、「旧定数名 → 新定数名」のマッピングを構築し、新しい値を取得します。数値を直接引き継がないでください。
4. switch ステートメントが新しい値をカバーしていることを確認します。旧値 63（Any）は新バージョンに対応するメンバーがありません。

3.2 権限識別子が string から int に変更

移行例：

// 古いコード
var start = new PermissionStart(doc, "editor-1");
var permission = new Permission(start);
string id = permission.Id;
var found = doc.Permissions.FindById("editor-1");
var byKey = doc.Permissions["editor-1"];       // 旧インデクサ
doc.Permissions.Remove(byKey);                  // 旧オブジェクトによる削除

// 新しいコード
var start = new PermissionStart(doc, 1);
var permission = start.Permission;            // パブリックコンストラクタはもうない
int id = permission.Id;
permission.Editor = "editor-1";               // 新しく追加された文字列識別子
var found = doc.Permissions.FindById(1);
doc.Permissions.Remove(1);                     // 新しく追加された ID による削除

ビジネス層が文字列を権限キーとして使用していた場合、新しい整数 ID 割り当てスキーム（データベースの ID 列や文書内のシーケンス番号など）を決定し、PermissionStart、PermissionEnd、Permission がすべて同じ整数を使用するようにする必要があります。

3.3 SDT（構造化文書タグ）モデルの再構築

削除された型：Spire.Doc.Documents.SDTContent（基底クラス Body）、Spire.Doc.Documents.SDTInlineContent（基底クラス DocumentObject）。

追加された型：StructureDocumentTagMarkStart、StructureDocumentTagMarkEnd（両方とも ParagraphBase を直接継承し、DocumentObjectType のみを公開）。

構造変更：

Row の構築方法：StructureDocumentTagRow(Table ownerTable) が削除され、StructureDocumentTagRow(Document doc) が追加されました。 Cell の構築方法：StructureDocumentTagCell(TableRow ownerRow) が削除され、StructureDocumentTagCell(Document doc) が追加されました。

影響：SDT の行/セルを通常のテーブル行/セルとして使用するコード（スタイリング、行の高さ、セル幅、結合、分割、XHTML 挿入、Table.Rows/Table.Cells の反復処理など）は、コンパイルに失敗するか、実行時にテーブル構造として認識されなくなります。新バージョンではこれらは「子ノードを持つ複合オブジェクト」になり、コンテンツは CompositeDocumentObject の DOM API（ChildObjects、AppendChild、InsertBefore など）を通じてアクセスされます。これはセマンティックレベルの再構築であり、型キャストだけでは解決できません。

移行例：

// 古いコード
StructureDocumentTag sdt = new StructureDocumentTag(doc);
SDTContent content = sdt.SDTContent;
content.AddParagraph();

// 新しいコード
StructureDocumentTag sdt = new StructureDocumentTag(doc);
IBody body = sdt.Body;
body.AddParagraph();

// 古いコード：SDT セルを TableCell として使用
StructureDocumentTagCell cell = new StructureDocumentTagCell(row);
cell.CellFormat.Width = 100;

// 新しいコード：CellFormat はもうない；CompositeDocumentObject の子/子コンテンツ API を使用
StructureDocumentTagCell cell = new StructureDocumentTagCell(doc);
// 具体的なセルの書式設定は子ノードを通じて行うか、文書構造を再設計する必要がある；回帰テストが必要

3.4 コレクション階層の再構築

主要な変更：

• DocumentObjectCollection が abstract から非抽象に変更され、基底クラスが DocumentItemCollectionBase から OwnerHolder に変更されました。パブリックコンストラクタは 0 個（エクスポートにパブリックコンストラクタが含まれない）で、主にプロパティを通じて取得されます。
• DocumentSubsetCollection とそのネストされた SubSetEnumerator が削除されました。
• DocumentObjectCollection.Add の戻り値の型が int から void に変更されました。
• DocumentObjectCollection に DocumentObject を受け取る強く型付けされたオーバーロードが追加されました。既存の IDocumentObject オーバーロードは保持されますが、パラメータ名が documentObject に変更されます。
• SectionCollection にパブリックコンストラクタがなくなりました。IWSectionCollection が削除され、空のマーカーインターフェース ISectionCollection に置き換えられました。

基底クラス変更の概要（コレクション関連）：

Add の戻り値の型が int から void に変更されたメンバー（バイナリ破壊）：

• DocumentObjectCollection.Add(IDocumentObject)
• ParagraphCollection.Add(IParagraph)
• TableCollection.Add(ITable)
• IParagraphCollection.Add(IParagraph)
• ITableCollection.Add(ITable)
• TableCollection.Insert(int, ITable) も int から void に変更

移行例：

// 古いコード：戻り値のインデックスに依存
int index = body.ChildObjects.Add(paragraph);
int index2 = body.Paragraphs.Add(paragraph);

// 新しいコード：Add は void を返す；インデックスが必要な場合は自分で IndexOf を呼び出す
body.ChildObjects.Add(paragraph);
int index = body.ChildObjects.IndexOf(paragraph);
body.Paragraphs.Add(paragraph);
int index2 = body.Paragraphs.IndexOf(paragraph);

// 古いコード：強く型付けされたオーバーロード
row.Cells.Add(cell);
table.Rows.Insert(0, row);

// 新しいコード：DocumentObject オーバーロードを使用（void を返す）
row.Cells.Add((DocumentObject)cell);
table.Rows.Insert(0, (DocumentObject)row);

3.5 基底クラスの変更（19 型）

基底クラスの変更は、継承メンバー、is/as キャスト、オーバーライド、シリアライズ、バイナリメンバー解決に同時に影響します。

主な影響：

• Comment、Footnote → InlineBody：両方とも「インラインボディ」になり、AddParagraph/AddTable、CharacterFormat、リビジョンプロパティを持ちますが、ParagraphBase に由来する一部の機能（ApplyCharacterFormat、ToString(string) など）を失います。
• OfficeMath、ShapeBase → CompositeDocumentObject：図形/数式が子ノードとボディ機能を持つようになりますが、ParagraphBase を継承しなくなります。
• TableOfContent → Field：TOC がフィールドになり、IField/ITextRange とフィールド関連機能を獲得します。
• StructureDocumentTagRow/Cell → CompositeDocumentObject：テーブル行/セルでなくなりました（3.3 参照）。
• ShapeItemCollection の基底クラスが「逆方向」に DocumentItemCollectionBase に変更され、コレクション操作を失います（3.4 参照）。

3.6 基底クラスメンバーの下方移動と連鎖的損失

以下のメンバーが DocumentObject から CompositeDocumentObject に下方移動します：

• ChildObjects
• FirstChild
• LastChild
• GetIndex(IDocumentObject)

結果として、複合型（Body、Section、Table、TableRow、TableCell、Document、Paragraph、Comment、Footnote、図形など）は新しい基底クラスを通じて引き続きアクセスできますが、DocumentObject 自体と 24 の非複合リーフ型（BookmarkStart/End、Break、Field、TextRange、Symbol、PermissionStart/End、透かし型など）はこれらのメンバーを公開しなくなります。

説明：ToString(string) が 48 の型から消えるのは、DocumentObject 基底クラスから削除されたためです。ApplyCharacterFormat が 11 の型から消えるのは、それらの型が ParagraphBase を継承しなくなったためです（ParagraphBase 自体はメソッドを保持しています）。

バイナリへの影響：基底クラスに上方移動するメンバーは通常依然として解決されます（CLR は基底クラスチェーンを遡ります）。派生クラスに下方移動するメンバーは異なります。古い IL のメンバー参照は通常、元の宣言型 DocumentObject を指し、CLR は派生クラスを検索しないため、DLL を置き換えた後、MissingMethodException が発生する可能性が非常に高いです。したがって、「新しい基底クラスを通じて依然到達可能」というのは再コンパイルされたソースにのみ当てはまり、古いバイナリを安全にするものではありません。

3.7 戻り値の型の変更（21 項目）

パターン概要：

• Body → IBody（7 項目）：BodyRegion.OwnerTextBody、Comment.Body、Footnote.Body、TextBox.Body、ITextBox.Body、FixedLayoutColumn.Body、TextBodySelection.TextBody。
• ParagraphBase → IParagraphBase（4 項目）：ParagraphItemCollection インデクサ、Paragraph インデクサ、IParagraph インデクサ、Document.CreateParagraphItem。
• int → void（6 項目）：コレクションの Add/Insert（3.4 参照）。
• string → int（3 項目）：Permission/PermissionStart/PermissionEnd の Id。
• TextBox → ShapeObject（1 項目）：TextBoxCollection インデクサ。
• さらに 2 項目は「交差継承置換」によりシグネチャ変更が発生し、上記の同一キー変更にはカウントされません：DocPicture.Rotation（float → double；旧メンバーは同名の基底プロパティを隠していたが、新バージョンは ShapeBase から継承）と HeadersFooters.GetEnumerator（IEnumerator → IEnumerator<DocumentObject>）。これら 2 つも古いバイナリを破壊します。

これらすべての変更は CLR メソッドシグネチャを変更します（戻り値の型はシグネチャの一部です）。古いバイナリは MissingMethodException を発生させ、ソースレベルでは通常、明示的なキャストまたはインターフェースへの切り替えが必要です。

3.8 型の削除と名前空間の移行

削除された 9 つのパブリック型：

追加された 8 つのパブリック型：

主なポイント：

• Spire.Doc.CompoundFile.IDocCloneable → Spire.Doc.Interface.IDocCloneable。インターフェースの型 ID が変更されるため、古い名前空間を明示的に参照するコードはコンパイルに失敗し、完全名によるリフレクション検索も失敗します。
• IWSectionCollection → ISectionCollection。新しいインターフェースは空のマーカーインターフェース（宣言メンバー 0）です。メンバーは ICollectionBase/IDocumentObjectCollection から提供されます。SectionCollection は新しいインターフェースを実装します。
• ITextBoxItemCollection は旧バージョンでパブリック実装者がなく、パブリックメンバーシグネチャにも現れなかったため、実用的な影響は非常に小さいですが、それでもパブリック型の削除です。
• DocumentObjectCollection+ChangeItems/ChangeItemsType はコレクション再構築と共に削除されたパブリックネストデリゲート/列挙型です。対応するパブリックイベントメンバーが見つからないため、影響は限定的です。

4. その他の破壊的および動作変更

4.1 コンストラクタとパラメータ型の変更

パラメータ名の変更（名前付き引数のみに影響；ソースは通常互換）：

• DocumentObjectCollection.Add/Contains/IndexOf/Insert/Remove：entity → documentObject
• Bookmark(BookmarkStart, BookmarkEnd)：start/end → bookmarkStart/bookmarkEnd
• FormFieldCollection.ContainsName：itemName → formFieldName
• CompositeDocumentObject.IndexOf：docObject → child

4.2 直接宣言された削除（54 項目）

これらは古い型自体に宣言されていたメンバーで、新バージョンで削除されたものです。基底クラス変更により古い型が失う継承メンバーは除外されます。後者は実効メンバーサーフェス（67 型にわたる 250 スロット）にカウントされ、通常は ChildObjects、ToString(string)、ApplyCharacterFormat の連鎖的消失です。

完全なリストは付録 Dにあります。最も注意が必要な非連鎖項目：

さらに 2 項目：旧宣言が同名の基底クラスメンバーに置き換えられるが、シグネチャが変更される

旧バージョンでは DocPicture.Rotation が float メンバーで ShapeBase.Rotation（double）を隠していました。新バージョンではその隠蔽宣言が削除され、DocPicture.Rotation は double に解決されるようになりました。float に依存するソースは明示的なキャストが必要で、古いバイナリは戻り値の型の不一致で失敗します。

さらに、CellCollection/RowCollection の強く型付けされた Add/IndexOf/Insert/Remove は削除されましたが、基底クラス DocumentObjectCollection は依然として DocumentObject バージョンを提供します。ただし、ShapeItemCollection の 11 のコレクション機能には基底クラスのフォールバックがありません。

4.3 アクセサの変更

Document.TextBoxes のセッターが削除されました。テキストボックスコレクション全体を置き換える古いコードはコンパイルできなくなり、代わりに既存のコレクションに対して DocumentObjectCollection/TextBoxCollection メソッドを通じて追加/削除する必要があります。

4.4 廃止マーカー（警告レベル）

以下の 4 つのメンバーに [Obsolete] が追加されました（IsError = false、警告のみ）：

• DocumentObjectCollection.Insert(int, IDocumentObject)：Owner.InsertBefore/InsertAfter を推奨
• DocumentObjectCollection.RemoveAt(int)：Owner.Remove(documentObject) または documentObject.Remove() を推奨
• ParagraphCollection.Insert(int, IParagraph)：同上
• TableCollection.Insert(int, ITable)：同上

これは新バージョンの API の方向性を反映しています：コレクション自体を通じた追加/削除は徐々に CompositeDocumentObject の DOM ツリー操作に取って代わられています。

4.5 動作/セマンティック変更

• SDT Row/Cell はもはやテーブル構造ではない：TableRow/TableCell に依存する走査、スタイリング、結合、分割、XHTML 挿入ロジックは再設計が必要です。
• Comment/Footnote が InlineBody になる：Body は IBody を返し、AddParagraph/AddTable を直接呼び出せます。Comment.Items は CommentedItems になり、Footnote.TextBody は削除されます（Footnote 自体がボディテキストであるため）。
• TOC が Field になる：TableOfContent の基底クラスが Field に変更され、フィールド更新と型チェックに影響する可能性があります。
• 図形/数式が複合オブジェクトになる：ShapeBase、OfficeMath が子ノード、ボディテキスト、リビジョン機能を持つようになります。DocPicture/TextBox/ShapeObject などが IBody を実装します。
• コレクションの基底クラスと戻り値の型が変更：DocumentObjectCollection.Add はインデックスを返さなくなり、コレクション階層はより均一になりますが、特定の基底クラスや戻り値に依存するコードは影響を受けます。
• TextBoxCollection インデクサが ShapeObject を返す：取得したオブジェクトが TextBox 以外の図形である可能性があります。直接 TextBox に代入する古いコードは失敗します。

5. 互換性影響分析

5.1 バイナリ互換性

結論：bindingRedirect を構成してアセンブリを読み込めたとしても、上記のシグネチャ/継承の変更により初回使用時に例外が発生します。さらに列挙の問題は例外すら発生しない可能性があり、より有害です。

5.2 ソース互換性

• コンパイル時エラー：削除された型/メンバー、戻り値の型の変更、パラメータ型の変更、Add の戻り値の使用、基底クラス変更によるメンバーの不可視化、削除されたセッター。
• コンパイル時警告：新しく追加された 4 つの [Obsolete]。
• ソース互換だが注意が必要：パラメータ名の変更は名前付き引数のみを破壊；新しいインターフェースメンバーは呼び出し元に影響しない；新しいセッターは互換。
• 明示的なキャストが必要：IParagraphBase/IBody/ShapeObject の戻り値、ISectionCollection インデクサ、TextBoxCollection インデクサ。

5.3 動作互換性

すべてのソースがコンパイルできたとしても、以下の動作については回帰テストが必要です：

1. SDT 行/セルのテーブルレイアウト、幅、結合、分割、XHTML 挿入。
2. 権限範囲（開始/終了/権限）と編集者 ID のマッチング。
3. コメント/脚注のボディ構造、および CommentedItems と旧 Items の違い。
4. TOC が Field になったことによる更新動作。
5. 図形/テキストボックス/画像の IBody としての子コンテンツとテキスト抽出。
6. コレクション Add 後のインデックス、順序、イベント/キャッシュ動作。
7. ヘッダー/フッターコレクションの列挙と Count。
8. 文書走査中の DocumentObjectType 分岐。

5.4 互換性マトリックス

6. 移行ガイド

6.1 移行順序（推奨）

6.2 主要なコード移行

(1) 列挙チェック

// 再コンパイル後、数値ではなく定数名を使用
if (obj.DocumentObjectType == DocumentObjectType.Paragraph) { ... }

// 古い永続化数値を新しい列挙に移行する必要がある場合、まず旧定数名でマッピング：
// 旧 4（Paragraph） -> 新 Paragraph（5）
// 旧 0（Document）  -> 新 Document（1）
// 旧 63（Any）      -> 新バージョンに対応するメンバーなし

(2) ChildObjects / 子ノード

// 古いコード：任意の DocumentObject からアクセス可能
DocumentObjectCollection children = documentObject.ChildObjects;

// 新しいコード：複合オブジェクトのみ ChildObjects を持つ
if (documentObject is CompositeDocumentObject composite)
{
    DocumentObjectCollection children = composite.ChildObjects;
    DocumentObject first = composite.FirstChild;
    int index = composite.GetIndex(child);
}

(3) コレクションへの追加

// Add はインデックスを返さなくなった
body.ChildObjects.Add(paragraph);
int index = body.ChildObjects.IndexOf(paragraph);

// 強く型付けされたコレクションオーバーロードはなくなった；DocumentObject オーバーロードを使用
row.Cells.Add((DocumentObject)cell);
table.Rows.Insert(0, (DocumentObject)row);

(4) インターフェースの戻り値の型

// 古いコード
ParagraphBase item = doc.CreateParagraphItem(ParagraphItemType.TextRange);
Body body = comment.Body;

// 新しいコード
IParagraphBase item = doc.CreateParagraphItem(ParagraphItemType.TextRange);
IBody body = comment.Body;

// 具象型が必要な場合は明示的にキャスト
var paragraph = (Paragraph)item;

(5) Comment / Footnote

// Comment.Items は削除されました
foreach (IParagraphBase item in comment.CommentedItems) { ... }

// Footnote.TextBody は削除されました；Footnote 自体が IBody
footnote.AddParagraph();
IBody footnoteBody = footnote.Body;

(6) TextBodyPart / TextBodySelection

part.Copy((IParagraphBase)paragraphBase, true);
part.PasteAfter((IParagraphBase)paragraphBase);
var selection = new TextBodySelection((IParagraphBase)start, (IParagraphBase)end);

(7) 図形の書式設定

// 古いコード：図形に直接 ApplyCharacterFormat
shape.ApplyCharacterFormat(format);

// 新しいコード：図形は ParagraphBase を継承しなくなった；CharacterFormat プロパティ / ApplyStyle を使用
shape.ApplyStyle("MyStyle");
// または shape.CharacterFormat に項目ごとにコピー

(8) IDocCloneable / ISectionCollection

// 名前空間の移行
using Spire.Doc.Interface; // 旧 Spire.Doc.CompoundFile
IDocCloneable cloneable = obj;

// IWSectionCollection -> ISectionCollection（空のマーカーインターフェース）
ISectionCollection sections = document.Sections;
Section first = (Section)sections; // インデクサは IDocumentObject を返す

(9) TextBoxCollection インデクサ

// 古いコード
TextBox textBox = document.TextBoxes;

// 新しいコード：インデクサは ShapeObject を返す
TextBox textBox = (TextBox)document.TextBoxes;

6.3 自動移行できない / 手動設計が必要な項目

1. 永続化された DocumentObjectType 値：数値的に引き継ぐのではなく、セマンティックにマッピングする必要があります。
2. SDT Row/Cell のテーブル機能：新しいモデルは CellFormat、RowFormat、Cells、結合/分割などを提供しなくなりました。再設計するか代替 API を見つける必要があります。
3. Style.NameToBuiltIn：同等の代替なし；名前マッピングテーブルを維持（組み込みスタイル名と列挙名は常に一致するとは限らない）。
4. ApplyCharacterFormat：図形/コメント/脚注などに同等のメソッドなし；CharacterFormat を項目ごとにコピーしても元の動作を完全に再現できない可能性があります。
5. ToString(string separator)：直接の代替なし；子を走査して自分で連結します。
6. ShapeItemCollection：パブリック型は依然存在しますが、すべてのコレクション操作がなくなり、この型を返すパブリックメンバーもありません。リフレクション/内部パスで使用している場合は、別のコレクションに切り替えてください。
7. Permission ID の割り当て：string → integer はデータモデルの変更であり、一意性と移行戦略が必要です。

7. 非破壊的拡張（利用可能）

7.1 DOM ツリー操作

DocumentObject に GetText()、Remove()、GetAncestor(...)、GetNextInPreOrder(...)、GetPreviousInPreOrder(...)、HasChildNodes が追加されました。CompositeDocumentObject に AppendChild、PrependChild、InsertBefore、InsertAfter、RemoveChild、RemoveAllChildren、RemoveChildRange、GetChild、GetChildNodes、整数インデクサ、および ChildObjects/FirstChild/LastChild が追加されました。この API グループは、コレクションの追加/削除と手動走査コードの一部を置き換えます。

7.2 リビジョントラッキング

新しい IRevisionTracking（8 メンバー）が 35 の型で実装されています：IsInsertRevision、IsDeleteRevision、IsMoveFromRevision、IsMoveToRevision、InsertRevision、DeleteRevision、MoveFromRevision、MoveToRevision。コメント、脚注、段落、フィールド、図形、透かしなどがすべてリビジョンを統一的に処理できます。

7.3 型付き範囲コレクション

• CommentRangeCollection：Comment.CommentedItems、Count、インデクサ、Contains、IndexOf、ToArray、列挙をサポート。
• TextRangeCollection：Paragraph.TextNodes、StructureDocumentTagInline.TextNodes、インデクサ、ToArray、列挙をサポート。

7.4 コレクションとクエリの拡張

• 複数のコレクションが ToArray() を獲得：ParagraphCollection、TableCollection、CellCollection、RowCollection、FieldCollection、FormFieldCollection、TextBoxCollection、SectionCollection、ParagraphItemCollection、DocumentObjectCollection。
• BookmarkCollection：Count、GetEnumerator、Remove(string)、ResetBookmarkCache。
• PermissionCollection：Count、GetEnumerator、Remove(int)、FindById(int)。
• HeadersFooters.GetHeaderFooterByType(HeaderFooterType)。
• TableRow.FirstCell/LastCell。
• StyleCollection.GetNextAvailableIstd()。
• DocumentNavigator：MoveToBodyStart/End、MoveToBookmark（オーバーロード含む）、InsertDropDown。

7.5 書き込み可能なプロパティと便利メンバー

• Bookmark.Name が書き込み可能；Bookmark.Text、Bookmark.Remove()、BookmarkStart.Bookmark 追加。
• Field.Separator が書き込み可能。
• ShapeBase.Size が書き込み可能；Shape.Title 追加；DocPicture.Size が書き込み可能。
• Permission.Editor、Permission.Remove()、PermissionStart.Permission、PermissionEnd.PermissionStart。
• Break.Text、Symbol.Text。
• DocumentObject の強く型付けされたオーバーロードと DocumentObjectCollection の Count。

8. 完全な変更リストとツール成果物

CSV 列：change, priority, type, member_kind, member_name, category, action, old_signature, new_signature, details。 change 値：type_added、type_removed、type_modified、member_added、member_removed、member_modified。 priority 規約：P0 必須修正（API を使用するとコンパイル失敗、実行時失敗、またはサイレントエラー — 169 項目）、P1 修正推奨（コンパイルは通るが、廃止警告、名前付き引数、継承置換、またはセマンティックリスクあり — 64 項目）、P2 再コンパイルのみ（新しい API または純粋なメタデータ変更 — 319 項目）。action は各行の推奨処理を示します。

9. 方法論と検証

9.1 エクスポート方法

1. Assembly.ReflectionOnlyLoadFrom を使用してターゲット DLL をリフレクション専用で読み込み、ビジネスコードを実行しない。
2. GetTypes() の前に GetReferencedAssemblies() を走査して依存関係をプリロード；ローカルに存在する依存関係は ReflectionOnlyLoadFrom にフォールバック。
3. BindingFlags.Public | DeclaredOnly を使用して型自体が宣言したメンバーのみをエクスポート；コンストラクタはパブリックコンストラクタのみ取得。
4. ネスト型の場合、DeclaringType チェーン全体がパブリックであることを要求し、内部型内のパブリックネスト型が誤ってエクスポート型としてカウントされないようにする（修正後 508）。
5. ECMA-334 XML ドキュメント ID（T:/M:/P:/F:/E:）を生成し、公式 XML ドキュメントと相互検証。
6. 「実効メンバーサーフェス」を計算：アセンブリ内の基底クラスチェーンに沿ってメンバーをマージ；コンストラクタは継承されない；型自体または祖先が新バージョンで同じ名前とシグネチャのメンバーを依然提供する場合にのみ「依然アクセス可能」とカウント。

9.2 検証

• 列挙値：Spire.Doc は逆アセンブリ保護が有効で、ildasm は「protected module」を報告。代わりに通常の読み込み + Enum.GetValues で独立して値を読み取り、結果はリフレクションエクスポートと一致；DocumentObjectType が旧バージョンで 64 項目、新バージョンで 62 項目であることも確認。
• 型数：最初のエクスポートは 538 で、「内部型内のパブリックネスト型」が誤ってカウントされていた；可視性チェーンを修正後、期待どおり 508 に。
• メンバーキー：typeFullName|kind|name(paramTypeKeys)、ジェネリックパラメータは !0/!!0 に正規化し、「オーバーロード削除 + 追加」がシグネチャ変更と誤分類されるのを回避。
• docId マッチング：旧 4247/5460（77.8%）、新 4297/5527（77.7%）；不一致のほとんどは XML ドキュメントのないパブリックメンバー。
• 制限事項：
• パブリック API のみ比較；protected/internal メンバー、メソッド本体の動作、パフォーマンス、シリアライズ形式は範囲外。
• 実行時機能テストは実施していない；動作の結論はシグネチャ、継承関係、型セマンティクスから推測。
• 難読化によって生成された非パブリックインターフェース（spr...）が GetInterfaces() の結果に現れ、レポートからフィルタリング済み；エクスポートされた JSON には依然存在する可能性があり、分析時にフィルタリングが必要。
• 「移動」は継承関係のみで判断；無関係な型間の名前変更/移行を推測して誤検知を避けることはしない。
• カスタム属性（Obsolete/Flags/EditorBrowsable 以外）およびイベントメンバー以外の高度なメタデータは分析していない。

付録 A：追加された型（8）

A.1 追加された型のパブリックメンバー

備考：CommentRangeCollection と TextRangeCollection は新しい型付きコレクション；InlineBody は Comment/Footnote の新しい基底クラス；IRevisionTracking はリビジョントラッキングインターフェース；IDocCloneable は CompoundFile 名前空間から移行；ISectionCollection は空のマーカーインターフェース；2 つの StructureDocumentTagMark* 型は SDT 境界マーク。

付録 B：削除された型（9）

備考：DocumentSubsetCollection は旧 ParagraphCollection/TableCollection の基底クラス；SDTContent/SDTInlineContent は SDT コンテンツラッパー；CompoundFile.IDocCloneable は Interface に移動；IWSectionCollection は ISectionCollection に置き換え；ITextBoxItemCollection はパブリック実装者がいなかった；2 つのネスト型は旧コレクション変更通知のパブリック成果物。

付録 C：追加されたメンバー（178）

C.1 追加された型のメンバー（37）

これら 37 のメンバーはすべてこのバージョンで追加された 8 つの型にあります。完全なリストは付録 A.1 にあり、ここでは繰り返しません。

C.2 既存型に追加されたメンバー（141）

付録 D：直接宣言された削除（54 項目）

これらのメンバーは古い型自体に宣言されており、新しいバージョンではその型も祖先も提供しません。基底クラス変更により失われた継承メンバーはこの表には含まれません。実効メンバーサーフェス統計を参照してください。

付録 E：継承により依然到達可能な削除（29 項目）

これらのメンバーは旧バージョンで何らかの型に宣言されていましたが、新バージョンではその型または祖先が同じ名前とシグネチャのメンバーを依然提供しているため、通常は再コンパイルのみが必要です。ただし、DocPicture.Rotation と HeadersFooters.GetEnumerator はシグネチャが変更されているため、「完全互換」として扱ってはいけません。

付録 F：非列挙変更（37 項目）

付録 G：基底クラスの変更（19 項目）

付録 H：型メタデータインターフェース変更の概要

114 の型にメタデータ変更があります。パブリックインターフェースレベルでの主な追加/削除：

これらのうち、Spire.Doc.Interface.IDocCloneable は 114 の型で新たに実装され、IRevisionTracking は 35 の型で新たに実装され、IBody は 7 つの新しい実装を獲得し（StructureDocumentTag、Comment、Footnote、DocOleObject、DocPicture、ShapeObject、TextBox）、StructureDocumentTagCell は IBody を失います。ITextRange は 3 つの新しい実装を獲得し（Break、Symbol、TableOfContent）、IField は 1 つの新しい実装を獲得します（TableOfContent）。

非パブリック/難読化インターフェース（spr...）はこの表にカウントされていません。完全な生のインターフェースリストは JSON 成果物にあります。

付録 I：型ごとの失われた実効メンバーサーフェス（トップ 20）