DocumentBase.SelectSingleNode(String, String, Boolean) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
XMLNode Vrátí objekt, který představuje první uzel v dokumentu, který odpovídá parametruXPath
.
public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);
member this.SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode
Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode
Parametry
- xPath
- String
Platný řetězec XPath Další informace o XPathu najdete v tématu Referenční dokumentace K XPathu.
- prefixMapping
- String
Poskytuje předponu ve schématu, oproti kterému se má vyhledávat. Parametr použijte, PrefixMapping
pokud parametr XPath
používá k hledání prvků názvy.
- fastSearchSkippingTextNodes
- Boolean
true
při hledání zadaného uzlu přeskočí všechny textové uzly. false
do hledání zahrne textové uzly. Výchozí hodnota je false.
Návraty
Objekt XMLNode , který představuje první uzel, který odpovídá parametru XPath
v dokumentu; null
pokud nejsou nalezeny žádné uzly odpovídající parametru XPath
.
Příklady
Následující příklad kódu ukazuje, jak zadat XPath
parametry a PrefixMapping
při volání SelectSingleNode metody. Pokud chcete použít tento příklad, spusťte ho ThisDocument
z třídy v projektu na úrovni dokumentu.
private void DocumentSelectSingleNode()
{
if (this.XMLSchemaReferences.Count > 0)
{
string XPath = "/x:catalog/x:book/x:title";
object key = 1;
string PrefixMapping = "xmlns:x=\"" +
this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
"\"";
Word.XMLNode node = this.SelectSingleNode(XPath,
PrefixMapping, true);
}
else
{
MessageBox.Show("The document does not contain a " +
"schema reference.");
}
}
Private Sub DocumentSelectSingleNode()
If Me.XMLSchemaReferences.Count > 0 Then
Dim XPath As String = "/x:catalog/x:book/x:title"
Dim PrefixMapping As String = "xmlns:x=""" + _
Me.XMLSchemaReferences(1).NamespaceURI + """"
Dim node As Word.XMLNode = Me.SelectSingleNode(XPath, _
PrefixMapping, True)
Else
MessageBox.Show("The document does not contain a " + _
"schema reference.")
End If
End Sub
Poznámky
Nastavení parametru FastSearchSkippingTextNodes
na true
snížení výkonu, protože Microsoft Office Word prohledá všechny uzly v dokumentu podle textu obsaženého v uzlu.
Volitelné parametry
Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro Systém Office.