XPathNavigator.CreateAttributes 메서드

정의

네임스페이스:

System.Xml.XPath

어셈블리:

System.Xml.ReaderWriter.dll

어셈블리:

System.Xml.XPath.dll

어셈블리:

System.Xml.dll

어셈블리:

netstandard.dll

현재 요소에 새 특성을 만드는 데 사용된 XmlWriter 개체를 반환합니다.

public:
 virtual System::Xml::XmlWriter ^ CreateAttributes();

public virtual System.Xml.XmlWriter CreateAttributes ();

abstract member CreateAttributes : unit -> System.Xml.XmlWriter
override this.CreateAttributes : unit -> System.Xml.XmlWriter

Public Overridable Function CreateAttributes () As XmlWriter

반환

XmlWriter

현재 요소에 새 특성을 만드는 데 사용된 XmlWriter 개체입니다.

예외

InvalidOperationException

요소 노드에 XPathNavigator의 위치가 지정되지 않습니다.

NotSupportedException

XPathNavigator에서는 편집을 지원하지 않습니다.

예제

다음 예제에서는 discount 메서드에서 반환된 currency 개체를 사용하여 price 파일에서 첫 번째 book 요소의 contosoBooks.xml 자식 요소에 새 XmlWriter 및 CreateAttributes 특성을 만듭니다.

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

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

XmlWriter^ attributes = navigator->CreateAttributes();

attributes->WriteAttributeString("discount", "1.00");
attributes->WriteAttributeString("currency", "USD");
attributes->Close();

navigator->MoveToParent();
Console::WriteLine(navigator->OuterXml);

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

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

XmlWriter attributes = navigator.CreateAttributes();

attributes.WriteAttributeString("discount", "1.00");
attributes.WriteAttributeString("currency", "USD");
attributes.Close();

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);

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

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

Dim attributes As XmlWriter = navigator.CreateAttributes()

attributes.WriteAttributeString("discount", "1.00")
attributes.WriteAttributeString("currency", "USD")
attributes.Close()

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

이 예제에서는 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>  

설명

다음은 메서드를 사용할 CreateAttributes 때 고려해야 할 중요한 참고 사항입니다.

• 요소에 XPathNavigator 위치하면 메서드에서 만든 XPathNavigator 새 특성이 현재 요소의 특성 목록 끝에 배치됩니다.

• 개체의 XmlWriter 메서드가 호출될 때까지 Close 새 특성이 삽입되지 않습니다.

• 지정된 네임스페이 String.Empty 스 접두사이거나 null새 특성의 네임스페이스 URI에 대한 접두사는 범위 내의 현재 네임스페이스에서 가져옵니다. 현재 범위에서 지정된 네임스페이스 URI에 할당된 네임스페이스 접두사가 없는 경우 네임스페이스 접두사는 자동으로 생성됩니다. 예를 들어 파일의 contosoBooks.xml 기본 네임스페이스에 있는 요소에 새 특성을 만들려면 네xmlns="http://www.contoso.com/books"임스페이스 접두사 및 네임스페이스 URI 매개 변수를 모두 지정 null 하거나 String.Empty 지정합니다. http://www.contoso.com/books 네임스페이스 URI 매개 변수로 지정하면 메서드에서 CreateAttribute 새 특성에 대한 네임스페이스 접두사 자동 생성이 발생합니다.

• 생성된 새 특성이 요소의 네임스페이스 선언과 충돌하는 네임스페이스 노드인 경우, 선택한 네임스페이스 접두사는 동일한 범위의 다른 네임스페이스 선언에서 사용되거나 선택한 접두사는 요소의 접두사와 동일하지만 다른 네임스페이스 URI에 바인딩되어 있기 때문에 예외가 throw됩니다.

• 반환된 개체는 XmlWriter 특성을 만드는 데만 사용할 수 있습니다. 특성을 만들지 않는 다른 XmlWriter 개체 메서드를 호출하면 예외가 throw됩니다.

• 메서드는 CreateAttributes .의 XPathNavigator위치에 영향을 주지 않습니다.