XPathNavigator.CreateAttribute(String, String, String, String) Yöntem

Tanım

Ad Alanı:

System.Xml.XPath

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XPathNavigator.cs

Belirtilen değerle belirtilen ad alanı ön ekini, yerel adı ve ad alanı URI'sini kullanarak geçerli öğe düğümünde bir öznitelik düğümü oluşturur.

public:
 virtual void CreateAttribute(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);

public virtual void CreateAttribute(string? prefix, string localName, string? namespaceURI, string? value);

abstract member CreateAttribute : string * string * string * string -> unit
override this.CreateAttribute : string * string * string * string -> unit

Public Overridable Sub CreateAttribute (prefix As String, localName As String, namespaceURI As String, value As String)

Parametreler

prefix

String

Yeni öznitelik düğümünün ad alanı ön eki (varsa).

localName

String

Yeni öznitelik düğümünün veya olamaz Emptynullyerel adı.

namespaceURI

String

Yeni öznitelik düğümü (varsa) için ad alanı URI'si.

value

String

Yeni öznitelik düğümünün değeri. Geçirilirse veya Empty geçirilirse null boş bir öznitelik düğümü oluşturulur.

Özel durumlar

InvalidOperationException

XPathNavigator bir öğe düğümünde konumlandırılmaz.

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

Örnekler

Aşağıdaki örnekte, dosyadaki discount ilk price öğenin book alt öğesinde yeni contosoBooks.xml bir öznitelik oluşturulur.

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

navigator.CreateAttribute("", "discount", "", "1.00");

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")

navigator.CreateAttribute("", "discount", "", "1.00")

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

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

<?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

Ad alanı ön eki ve URI değerleri veya LookupPrefix yöntemi kullanılarak LookupNamespace elde edilebilir. Örneğin, aşağıdaki söz dizimi kapsam içi ad alanını xmlns:bk="http://www.contoso.com/books"kullanarak bir öznitelik oluşturur:

editor.CreateAttribute(navigator.Prefix, "attributeName", LookupNamespace(navigator.Prefix), "text")

Bu, geçerli öğede yeni özniteliği <bk:element attributeName="text"/> oluşturur.

Yöntemi kullanırken dikkate alınması gereken önemli notlar aşağıdadır CreateAttribute .

• Belirtilen ad alanı öneki veya String.Emptyisenull, yeni özniteliğin ad alanı URI'sinin ön eki kapsamdaki geçerli ad alanından alınır. Geçerli kapsamda belirtilen ad alanı URI'sine atanmış bir ad alanı ön eki yoksa, otomatik olarak bir ad alanı ön eki oluşturulur. Örneğin, dosyanın varsayılan ad alanında contosoBooks.xml bulunan bir öğede yeni bir öznitelik oluşturmak için (xmlns="http://www.contoso.com/books" ), hem ad alanı ön eki hem de ad alanı URI parametrelerini belirtirsiniz nullString.Empty . Ad alanı URI parametresi olarak belirtilmesi http://www.contoso.com/books yöntemin CreateAttribute yeni öznitelik için bir ad alanı ön eki oluşturmasına neden olur.

• Oluşturulan yeni öznitelik, seçilen ad alanı öneki aynı kapsamdaki başka bir ad alanı bildirimi tarafından kullanıldığından veya seçilen ön ek öğeninkiyle aynı olduğundan ancak farklı bir ad alanı URI'sine bağlı olduğundan öğedeki bir ad alanı bildirimiyle çakan bir ad alanı düğümüyse, bir özel durum oluşturulur.

• yöntemi, CreateAttribute konumunu XPathNavigatoretkilemez.