DocumentBase.SelectLinkedControls メソッド
指定したカスタム XML ノードにリンクされている文書内のすべてのコンテンツ コントロールを返します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word.v4.0.Utilities (Microsoft.Office.Tools.Word.v4.0.Utilities.dll 内)
構文
'宣言
Public Function SelectLinkedControls ( _
node As CustomXMLNode _
) As ContentControls
public ContentControls SelectLinkedControls(
CustomXMLNode node
)
パラメーター
- node
型 : Microsoft.Office.Core.CustomXMLNode
コンテンツ コントロールのリンク先 CustomXMLNode。
戻り値
型 : Microsoft.Office.Interop.Word.ContentControls
指定したカスタム XML ノードにリンクされているコンテンツ コントロールを格納する ContentControls コレクション。
例
次のコード例では、現在の文書に 3 つのプレーンテキスト コンテンツ コントロールを追加します。また、従業員データを含む CustomXMLPart を追加し、2 つのコンテンツ コントロールを CustomXMLPart の XML ノードにリンクします。次に、従業員名のノードにリンクされているコントロールを取得し、リンクされたコントロールの数を示すメッセージ ボックスを表示します。最後に、リンクされたコントロールを反復処理し、それぞれのタイトルを表示します。このコードを実行して取得したコントロールの中には、Employee Name というタイトルのリンクされたコントロールが含まれています。この例を使用するには、これをドキュメント レベルのプロジェクトの ThisDocument クラスから実行します。
Private Sub LinkedControls()
Me.Paragraphs.Last.Range.InsertParagraphAfter()
Dim employeeName As Microsoft.Office.Tools.Word.PlainTextContentControl _
= Me.Controls.AddPlainTextContentControl(Me.Paragraphs.Last.Range, _
"employeeName")
employeeName.Title = "Employee Name"
Me.Paragraphs.Last.Range.InsertParagraphAfter()
Dim employeeHireDate As _
Microsoft.Office.Tools.Word.PlainTextContentControl = _
Me.Controls.AddPlainTextContentControl(Me.Paragraphs.Last.Range, _
"employeeHireDate")
employeeHireDate.Title = "Employee Hire Date"
Me.Paragraphs.Last.Range.InsertParagraphAfter()
Dim comments As Microsoft.Office.Tools.Word.PlainTextContentControl _
= Me.Controls.AddPlainTextContentControl(Me.Paragraphs.Last.Range, _
"comments")
comments.Title = "Comments"
Dim xmlString As String = _
"<?xml version=""1.0"" encoding=""utf-8"" ?>" _
+ "<employees>" _
+ "<employee>" _
+ "<name>Karina Leal</name>" _
+ "<hireDate>1999-04-01</hireDate>" _
+ "</employee>" _
+ "</employees>"
Dim employeeXMLPart As Office.CustomXMLPart = _
Me.CustomXMLParts.Add(xmlString)
employeeName.XMLMapping.SetMapping("/employees/employee/name")
employeeHireDate.XMLMapping.SetMapping("/employees/employee/hireDate")
Dim node As Office.CustomXMLNode = employeeXMLPart.SelectSingleNode( _
"/employees[1]/employee[1]/name[1]")
Dim linkedControls As Word.ContentControls = Me.SelectLinkedControls(node)
MessageBox.Show("Number of controls linked to the " + node.XPath _
+ " node: " + linkedControls.Count.ToString())
For Each linkedControl As Word.ContentControl In linkedControls
MessageBox.Show("Linked control title: " + linkedControl.Title)
Next
End Sub
private void LinkedControls()
{
this.Paragraphs.Last.Range.InsertParagraphAfter();
Microsoft.Office.Tools.Word.PlainTextContentControl employeeName =
this.Controls.AddPlainTextContentControl(this.Paragraphs.Last.Range,
"employeeName");
employeeName.Title = "Employee Name";
this.Paragraphs.Last.Range.InsertParagraphAfter();
Microsoft.Office.Tools.Word.PlainTextContentControl employeeHireDate =
this.Controls.AddPlainTextContentControl(this.Paragraphs.Last.Range,
"employeeHireDate");
employeeHireDate.Title = "Employee Hire Date";
this.Paragraphs.Last.Range.InsertParagraphAfter();
Microsoft.Office.Tools.Word.PlainTextContentControl comments =
this.Controls.AddPlainTextContentControl(this.Paragraphs.Last.Range,
"comments");
comments.Title = "Comments";
string xmlString =
"<?xml version=\"1.0\" encoding=\"utf-8\" ?>"
+ "<employees>"
+ "<employee>"
+ "<name>Karina Leal</name>"
+ "<hireDate>1999-04-01</hireDate>"
+ "</employee>"
+ "</employees>";
Office.CustomXMLPart employeeXMLPart =
this.CustomXMLParts.Add(xmlString, missing);
employeeName.XMLMapping.SetMapping(
"/employees/employee/name", "", employeeXMLPart);
employeeHireDate.XMLMapping.SetMapping(
"/employees/employee/hireDate", "", employeeXMLPart);
Office.CustomXMLNode node = employeeXMLPart.SelectSingleNode(
"/employees[1]/employee[1]/name[1]");
Word.ContentControls linkedControls = this.SelectLinkedControls(node);
MessageBox.Show("Number of controls linked to the " + node.XPath
+ " node: " + linkedControls.Count.ToString());
foreach (Word.ContentControl linkedControl in linkedControls)
{
MessageBox.Show("Linked control title: " + linkedControl.Title);
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。