XPathNavigator.SelectAncestors Yöntem

Tanım

Ad Alanı:

System.Xml.XPath

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Geçerli düğümün seçim ölçütleriyle eşleşen tüm ata düğümlerini seçer.

Aşırı Yüklemeler

SelectAncestors(XPathNodeType, Boolean)	Geçerli düğümün eşleşen XPathNodeTypetüm atası düğümlerini seçer.
SelectAncestors(String, String, Boolean)	Belirtilen yerel ada ve ad alanı URI'sine sahip geçerli düğümün tüm üst düğümlerini seçer.

SelectAncestors(XPathNodeType, Boolean)

Source:

XPathNavigator.cs

Geçerli düğümün eşleşen XPathNodeTypetüm atası düğümlerini seçer.

public:
 virtual System::Xml::XPath::XPathNodeIterator ^ SelectAncestors(System::Xml::XPath::XPathNodeType type, bool matchSelf);

public virtual System.Xml.XPath.XPathNodeIterator SelectAncestors (System.Xml.XPath.XPathNodeType type, bool matchSelf);

abstract member SelectAncestors : System.Xml.XPath.XPathNodeType * bool -> System.Xml.XPath.XPathNodeIterator
override this.SelectAncestors : System.Xml.XPath.XPathNodeType * bool -> System.Xml.XPath.XPathNodeIterator

Public Overridable Function SelectAncestors (type As XPathNodeType, matchSelf As Boolean) As XPathNodeIterator

Parametreler

type

XPathNodeType

Ata XPathNodeType düğümlerinin sayısı.

matchSelf

Boolean

Bağlam düğümünü seçime dahil etmek için; truedeğilse , false.

Döndürülenler

XPathNodeIterator

XPathNodeIterator Seçili düğümleri içeren bir. Döndürülen düğümler ters belge sırasına göre sıralanır.

Örnekler

Ata düğümlerini seçme örneği için bkz XPathNavigator.SelectAncestors. .

Açıklamalar

yönteminin SelectAncestors durumunu etkilemesi XPathNavigatorgerekmez.

Ayrıca bkz.

• SelectChildren(XPathNodeType)
• SelectDescendants(XPathNodeType, Boolean)
• Select(XPathExpression)

SelectAncestors(String, String, Boolean)

Source:

XPathNavigator.cs

Belirtilen yerel ada ve ad alanı URI'sine sahip geçerli düğümün tüm üst düğümlerini seçer.

public:
 virtual System::Xml::XPath::XPathNodeIterator ^ SelectAncestors(System::String ^ name, System::String ^ namespaceURI, bool matchSelf);

public virtual System.Xml.XPath.XPathNodeIterator SelectAncestors (string name, string namespaceURI, bool matchSelf);

abstract member SelectAncestors : string * string * bool -> System.Xml.XPath.XPathNodeIterator
override this.SelectAncestors : string * string * bool -> System.Xml.XPath.XPathNodeIterator

Public Overridable Function SelectAncestors (name As String, namespaceURI As String, matchSelf As Boolean) As XPathNodeIterator

Parametreler

name

String

Ata düğümlerinin yerel adı.

namespaceURI

String

Ata düğümlerinin ad alanı URI'si.

matchSelf

Boolean

Bağlam düğümünü seçime dahil etmek için; truedeğilse , false.

Döndürülenler

XPathNodeIterator

XPathNodeIterator Seçili düğümleri içeren bir. Döndürülen düğümler ters belge sırasına göre sıralanır.

Özel durumlar

ArgumentNullException

null parametre olarak geçirilemez.

Örnekler

Aşağıdaki örnekte, üst, alt ve alt düğümlerin seçilmesi gösterilmektedir.

XPathDocument^ document = gcnew XPathDocument("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "http://www.contoso.com/books");
navigator->MoveToChild("book", "http://www.contoso.com/books");

// Select all the descendant nodes of the book node.
XPathNodeIterator^ bookDescendants = navigator->SelectDescendants("", "http://www.contoso.com/books", false);

// Display the LocalName of each descendant node.
Console::WriteLine("Descendant nodes of the book node:");
while (bookDescendants->MoveNext())
{
    Console::WriteLine(bookDescendants->Current->Name);
}

// Select all the child nodes of the book node.
XPathNodeIterator^ bookChildren = navigator->SelectChildren("", "http://www.contoso.com/books");

// Display the LocalName of each child node.
Console::WriteLine("\nChild nodes of the book node:");
while (bookChildren->MoveNext())
{
    Console::WriteLine(bookChildren->Current->Name);
}

// Select all the ancestor nodes of the title node.
navigator->MoveToChild("title", "http://www.contoso.com/books");

XPathNodeIterator^ bookAncestors = navigator->SelectAncestors("", "http://www.contoso.com/books", false);

// Display the LocalName of each ancestor node.
Console::WriteLine("\nAncestor nodes of the title node:");

while (bookAncestors->MoveNext())
{
    Console::WriteLine(bookAncestors->Current->Name);
}

XPathDocument document = new XPathDocument("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");

// Select all the descendant nodes of the book node.
XPathNodeIterator bookDescendants = navigator.SelectDescendants("", "http://www.contoso.com/books", false);

// Display the LocalName of each descendant node.
Console.WriteLine("Descendant nodes of the book node:");
while (bookDescendants.MoveNext())
{
    Console.WriteLine(bookDescendants.Current.Name);
}

// Select all the child nodes of the book node.
XPathNodeIterator bookChildren = navigator.SelectChildren("", "http://www.contoso.com/books");

// Display the LocalName of each child node.
Console.WriteLine("\nChild nodes of the book node:");
while (bookChildren.MoveNext())
{
    Console.WriteLine(bookChildren.Current.Name);
}

// Select all the ancestor nodes of the title node.
navigator.MoveToChild("title", "http://www.contoso.com/books");

XPathNodeIterator bookAncestors = navigator.SelectAncestors("", "http://www.contoso.com/books", false);

// Display the LocalName of each ancestor node.
Console.WriteLine("\nAncestor nodes of the title node:");

while (bookAncestors.MoveNext())
{
    Console.WriteLine(bookAncestors.Current.Name);
}

Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")

' Select all the descendant nodes of the book node.
Dim bookDescendants As XPathNodeIterator = navigator.SelectDescendants("", "http://www.contoso.com/books", False)

' Display the LocalName of each descendant node.
Console.WriteLine("Descendant nodes of the book node:")
While bookDescendants.MoveNext()
    Console.WriteLine(bookDescendants.Current.Name)
End While

' Select all the child nodes of the book node.
Dim bookChildren As XPathNodeIterator = navigator.SelectChildren("", "http://www.contoso.com/books")

' Display the LocalName of each child node.
Console.WriteLine(vbCrLf & "Child nodes of the book node:")
While bookChildren.MoveNext()
    Console.WriteLine(bookChildren.Current.Name)
End While

' Select all the ancestor nodes of the title node.
navigator.MoveToChild("title", "http://www.contoso.com/books")

Dim bookAncestors As XPathNodeIterator = navigator.SelectAncestors("", "http://www.contoso.com/books", False)

' Display the LocalName of each ancestor node.
Console.WriteLine(vbCrLf & "Ancestor nodes of the title node:")

While bookAncestors.MoveNext()
    Console.WriteLine(bookAncestors.Current.Name)
End While

Örnek, dosyayı giriş olarak alır contosoBooks.xml .

<?xml version="1.0" encoding="utf-8" ?>  
<bookstore xmlns="http://www.contoso.com/books">  
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">  
        <title>The Autobiography of Benjamin Franklin</title>  
        <author>  
            <first-name>Benjamin</first-name>  
            <last-name>Franklin</last-name>  
        </author>  
        <price>8.99</price>  
    </book>  
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">  
        <title>The Confidence Man</title>  
        <author>  
            <first-name>Herman</first-name>  
            <last-name>Melville</last-name>  
        </author>  
        <price>11.99</price>  
    </book>  
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">  
        <title>The Gorgias</title>  
        <author>  
            <name>Plato</name>  
        </author>  
        <price>9.99</price>  
    </book>  
</bookstore>  

Açıklamalar

parametresi olarak name belirtilirseString.Empty, belirtilen ad alanı URI'sine ait tüm üst düğümler seçilir. parametresi olarak namespaceURI belirtilirseString.Empty, ad alanına ait olmayan belirtilen yerel ada sahip tüm üst düğümler seçilir. Hem yerel ad hem de ad alanı URI'si olarak belirtilirse String.Empty , ad alanına ait olmayan tüm üst düğümler seçilir.

yönteminin SelectAncestors durumunu etkilemesi XPathNavigatorgerekmez.

Ayrıca bkz.

• SelectChildren(XPathNodeType)
• SelectDescendants(XPathNodeType, Boolean)
• Select(XPathExpression)