XPathNavigator.CreateAttribute(String, String, String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定された値で指定した名前空間プレフィックス、ローカル名、および名前空間 URI を使用して、現在の要素ノードに属性ノードを作成します。
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);
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)
パラメーター
- prefix
- String
新しい属性ノードの名前空間プレフィックス (存在する場合)。
- namespaceURI
- String
新しい属性ノードの名前空間 URI (存在する場合)。
例外
XPathNavigator が要素ノードに配置されていません。
XPathNavigator では、編集はサポートされていません。
例
次の例では、ファイル内の最初book
の要素のprice
子要素に新しいdiscount
属性がcontosoBooks.xml
作成されます。
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");
navigator->CreateAttribute("", "discount", "", "1.00");
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");
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)
この例は、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>
注釈
名前空間プレフィックスと URI 値は、 メソッドまたは LookupNamespace メソッドをLookupPrefix使用して取得できます。 たとえば、次の構文では、スコープ内名前空間 xmlns:bk="http://www.contoso.com/books"
を使用して 属性を作成します。
editor.CreateAttribute(navigator.Prefix, "attributeName", LookupNamespace(navigator.Prefix), "text")
これにより、現在の要素に新しい属性 <bk:element attributeName="text"/>
が作成されます。
メソッドを使用する場合に考慮すべき重要な注意事項を次に CreateAttribute 示します。
指定された名前空間プレフィックスが または
null
の場合、String.Empty新しい属性の名前空間 URI のプレフィックスは、スコープ内の現在の名前空間から取得されます。 現在のスコープで指定された名前空間 URI に名前空間プレフィックスが割り当てられていない場合は、名前空間プレフィックスが自動的に生成されます。 たとえば、ファイルの既定の名前空間内の要素に新しい属性を作成するには(xmlns="http://www.contoso.com/books"
)、名前空間プレフィックスと名前空間 URI パラメーターのcontosoBooks.xml
両方に または String.Empty を指定null
します。 名前空間 URI パラメーターとして をhttp://www.contoso.com/books
指定すると、メソッドは CreateAttribute 新しい属性の名前空間プレフィックスを自動生成します。選択した名前空間プレフィックスが同じスコープの別の名前空間宣言によって使用されているか、選択したプレフィックスが要素の同じであり、別の名前空間 URI にバインドされているために、作成された新しい属性が要素の名前空間宣言と競合する名前空間ノードである場合は、例外がスローされます。
メソッドは CreateAttribute の位置には XPathNavigator影響しません。
適用対象
.NET