表内のテキストを操作する

以前の記事で述べたように、表には通常プレーン テキストが含まれますが、画像や他の表などの他のコンテンツを表のセルに配置することもできます。

テーブルへのテキストまたはその他のコンテンツの追加は、DocumentBuilder クラスの適切なメソッドを使用して実行されます。これについては、「テーブルを作成する」 の記事で説明されています。この記事では、既存の表内のテキストを操作する方法について説明します。

表内のテキストを置換する

テーブルは、Aspose.Words の他のノードと同様に、Range オブジェクトにアクセスできます。テーブル範囲オブジェクトを使用すると、テーブル内のテキストを置換できます。

置換時に特殊文字を使用する機能は現在サポートされているため、既存のテキストを複数段落のテキストに置き換えることができます。これを行うには、対応する Replace メソッドで説明されている特別なメタキャラクタを使用する必要があります。

通常、テキストの置換はセル レベル (セルごと) または段落レベルで行う必要があります。

次のコード例は、テーブル全体のセル内のテキスト文字列のすべてのインスタンスを置換する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table)doc.GetChild(NodeType.Table, 0, true);

table.Range.Replace("Carrots", "Eggs", new FindReplaceOptions(FindReplaceDirection.Forward));
table.LastRow.LastCell.Range.Replace("50", "20", new FindReplaceOptions(FindReplaceDirection.Forward));

doc.Save(ArtifactsDir + "FindAndReplace.ReplaceTextInTable.docx");

テーブルまたはセルからプレーンテキストを抽出する

Range オブジェクトを使用すると、テーブル範囲全体でメソッドを呼び出し、テーブルをプレーン テキストとして抽出することもできます。これを行うには、Text プロパティを使用します。

次のコード例は、表のテキスト範囲を印刷する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");
            
Table table = (Table) doc.GetChild(NodeType.Table, 0, true);

// The range text will include control characters such as "\a" for a cell.
// You can call ToString and pass SaveFormat.Text on the desired node to find the plain text content.
Console.WriteLine("Contents of the table: ");
Console.WriteLine(table.Range.Text);

同じ手法を使用して、表の個々のセルのみからコンテンツを抽出します。

次のコード例は、行要素とテーブル要素のテキスト範囲を印刷する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Console.WriteLine("\nContents of the row: ");
Console.WriteLine(table.Rows[1].Range.Text);

Console.WriteLine("\nContents of the cell: ");
Console.WriteLine(table.LastRow.LastCell.Range.Text);

代替テーブルテキストの操作

Microsoft Word テーブルには、テーブルに含まれる情報の代替テキスト表現を提供する table title と table description があります。

Aspose.Words では、Title プロパティと Description プロパティを使用してテーブルのタイトルと説明を追加することもできます。これらのプロパティは、ISO/IEC 29500 に準拠する DOCX ドキュメントにとって重要です。ISO/IEC 29500 より前の形式で保存する場合、これらのプロパティは無視されます。

次のコード例は、テーブルのタイトルと説明のプロパティを設定する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Tables.docx");

Table table = (Table) doc.GetChild(NodeType.Table, 0, true);
table.Title = "Test title";
table.Description = "Test description";

OoxmlSaveOptions options = new OoxmlSaveOptions { Compliance = OoxmlCompliance.Iso29500_2008_Strict };

doc.CompatibilityOptions.OptimizeFor(Aspose.Words.Settings.MsWordVersion.Word2016);

doc.Save(ArtifactsDir + "WorkingWithTableStylesAndFormatting.TableTitleAndDescription.docx", options);