Udostępnij za pośrednictwem

Metoda DocumentBase.SelectSingleNode —

  • Artykuł

Zwraca Microsoft.Office.Interop.Word.XMLNode obiekt, który reprezentuje pierwszy węzeł w dokumencie, który pasuje do XPath parametru.

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 SelectSingleNode ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNode

public XMLNode SelectSingleNode(
    string xPath,
    string prefixMapping,
    bool fastSearchSkippingTextNodes
)

Parametry

  • xPath
    Typ: System.String
    Prawidłowy ciąg XPath.Aby uzyskać więcej informacji na temat 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.XMLNode
A Microsoft.Office.Interop.Word.XMLNode obiekt, który reprezentuje pierwszy węzeł, który odpowiada XPath parametr 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 SelectSingleNode metody.Aby wykorzystać ten przykład, należy uruchomić go z klasy ThisDocument w projekcie na poziomie dokumentu.

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

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.");
    }
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

DocumentBase Klasa

Przestrzeń nazw Microsoft.Office.Tools.Word