Udostępnij za pośrednictwem

Metoda DocumentBase.SelectSingleNode —

  • Artykuł

Zwraca Microsoft.Office.Interop.Word.XMLNode obiekt, który reprezentuje pierwszego węzła 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 Skorowidz XPath.
  • prefixMapping
    Typ: System.String
    Zawiera prefiks w schemacie w stosunku do którego ma przeprowadzić wyszukiwanie.Użycie PrefixMapping parametr Jeśli Twój XPath parametr używa nazwy, aby wyszukać elementy.
  • fastSearchSkippingTextNodes
    Typ: System.Boolean
    true Pomija wszystkie węzły tekstu podczas poszukiwania określonego węzła. false zawiera węzły tekstu 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ły dopasowania XPath znajdują się parametr.

Uwagi

Ustawienie FastSearchSkippingTextNodes parametru do true zmniejsza wydajność, ponieważ program Microsoft Office Word przeszukuje wszystkie węzły dokumentu przed tekst znajdujący się w węźle.

Parametry opcjonalne

Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.

Przykłady

Poniższy przykład kodu demonstruje, jak określić XPath i PrefixMapping parametry podczas wywoływania SelectSingleNode metoda.Aby wykorzystać ten przykład, należy uruchomić go z ThisDocument klasy 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