XmlElement.SetAttribute メソッド (String, String)

指定した名前の属性の値を設定します。

Overloads Public Overridable Sub SetAttribute( _
   ByVal name As String, _   ByVal value As String _)
[C#]
public virtual void SetAttribute(stringname,stringvalue);
[C++]
public: virtual void SetAttribute(String* name,String* value);
[JScript]
public function SetAttribute(
   name : String,value : String);

パラメータ

• name
  作成または変更する属性の名前。これは限定名です。名前にコロンが含まれている場合、その名前はプリフィックスとローカル名コンポーネントに解析されます。
• value
  属性に設定する値。

例外

例外の種類	条件
XmlException	指定した名前に無効な文字が含まれています。
ArgumentException	ノードが読み取り専用です。

解説

同じ名前の属性が既に要素に存在している場合、その値は value の値に変更されます。value は単純文字列です。その文字列は、設定されているとおりには解析されません。エンティティ参照として認識される構文などのマークアップは、すべてリテラル テキストとして扱われ、書き込み時に実装によって正しくエスケープする必要があります。エンティティ参照を含む属性値を割り当てるには、ユーザーは、 XmlAttribute ノードに加えて、 XmlText ノードおよび XmlEntityReference ノードを作成し、適切なサブツリーを構築して、 SetAttributeNode を使用して属性の値として割り当てる必要があります。

使用例

[Visual Basic, C#, C++] 属性を要素に追加する例を次に示します。

 
Imports System
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" & _
                "<title>Pride And Prejudice</title>" & _
                "</book>")

    Dim root as XmlElement = doc.DocumentElement

    ' Add a new attribute.
    root.SetAttribute("genre", "novel")

    Console.WriteLine("Display the modified XML...")
    Console.WriteLine(doc.InnerXml)

  end sub
end class

[C#] 
using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlElement root = doc.DocumentElement;

    // Add a new attribute.
    root.SetAttribute("genre", "novel");

    Console.WriteLine("Display the modified XML...");
    Console.WriteLine(doc.InnerXml);

  }
}

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
    XmlDocument* doc = new XmlDocument();
    doc->LoadXml(S"<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>");

    XmlElement* root = doc->DocumentElement;

    // Add a new attribute.
    root->SetAttribute(S"genre", S"novel");

    Console::WriteLine(S"Display the modified XML...");
    Console::WriteLine(doc->InnerXml);
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

XmlElement クラス | XmlElement メンバ | System.Xml 名前空間 | XmlElement.SetAttribute オーバーロードの一覧