Metoda DocumentBase.SelectNodes —
Pobiera Microsoft.Office.Interop.Word.XMLNodes , która reprezentuje wszystkie węzły, które odpowiadają XPath parametr w kolejności, w jakiej występują w dokumencie.
Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word.v4.0.Utilities (w Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Składnia
'Deklaracja
Public Function SelectNodes ( _
xPath As String, _
prefixMapping As String, _
fastSearchSkippingTextNodes As Boolean _
) As XMLNodes
public XMLNodes SelectNodes(
string xPath,
string prefixMapping,
bool fastSearchSkippingTextNodes
)
Parametry
- xPath
Typ: System.String
Prawidłowy ciąg XPath.Aby uzyskać więcej informacji o składni XPath zobacz odwołanie XPath.
- prefixMapping
Typ: System.String
Zawiera prefiks w schemacie, za pomocą którego przeprowadza się wyszukiwanie.Użyj parametru PrefixMapping, jeśli parametr XPath używa nazw do wyszukania elementów.
- fastSearchSkippingTextNodes
Typ: System.Boolean
true pomija wszystkie węzły tekstu podczas wyszukiwania określonego węzła. false zawiera węzły tekstowe w wyszukiwaniu.Wartością domyślną jest false.
Wartość zwracana
Typ: Microsoft.Office.Interop.Word.XMLNodes
A Microsoft.Office.Interop.Word.XMLNodes , która reprezentuje wszystkie węzły, które odpowiadają XPath parametr w kolejności, w jakiej występują w dokumencie. nullodwołanie o wartości null (Nothing w języku Visual Basic)Jeśli nie węzłów pasujących do XPath znajdują się parametr.
Uwagi
Ustawienie FastSearchSkippingTextNodes parametru do true zmniejsza wydajność, ponieważ program Microsoft Office Word przeszukuje wszystkie węzły w dokumencie przed tekst znajdujący się w węźle.
Parametry opcjonalne
Informacje na temat parametrów opcjonalnych można wyświetlić na Parametry opcjonalne w rozwiązaniach Office.
Przykłady
Poniższy przykład kodu demonstruje sposób określania XPath i PrefixMapping parametry podczas wywoływania SelectNodes metody.Aby wykorzystać ten przykład, należy uruchomić go z klasy ThisDocument w projekcie na poziomie dokumentu.
Private Sub DocumentSelectNodes()
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.XMLNodes = Me.SelectNodes(XPath, _
PrefixMapping, True)
Else
MessageBox.Show("The document does not contain a " + _
"schema reference.")
End If
End Sub
private void DocumentSelectNodes()
{
if (this.XMLSchemaReferences.Count > 0)
{
string XPath = "/x:catalog/x:book/x:title";
object key = 1;
string PrefixMapping = "xmlns:x=\"" +
this.XMLSchemaReferences[key].NamespaceURI +
"\"";
Word.XMLNodes nodes = this.SelectNodes(XPath,
PrefixMapping, true);
}
else
{
MessageBox.Show("The document does not contain a " +
"schema reference.");
}
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.