XmlWriter.WriteAttributeString Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Při přepsání v odvozené třídě zapíše atribut se zadanou hodnotou.

Přetížení

WriteAttributeString(String, String, String, String)	Při přepsání v odvozené třídě zapíše atribut se zadanou předponou, místním názvem, identifikátorem URI oboru názvů a hodnotou.
WriteAttributeString(String, String, String)	Při přepsání v odvozené třídě zapíše atribut se zadaným místním názvem, identifikátorem URI oboru názvů a hodnotou.
WriteAttributeString(String, String)	Při přepsání v odvozené třídě zapíše atribut se zadaným místním názvem a hodnotou.

Poznámky

Asynchronní verzi této metody najdete v tématu WriteElementStringAsync.

WriteAttributeString(String, String, String, String)

Zdroj:

XmlWriter.cs

Při přepsání v odvozené třídě zapíše atribut se zadanou předponou, místním názvem, identifikátorem URI oboru názvů a hodnotou.

C#

public void WriteAttributeString (string? prefix, string localName, string? ns, string? value);

Parametry

prefix

String

Předpona oboru názvů atributu.

localName

String

Místní název atributu.

ns

String

Identifikátor URI oboru názvů atributu.

value

String

Hodnota atributu.

Výjimky

InvalidOperationException

Stav zapisovače není WriteState.Element nebo je zapisovač uzavřen.

-nebo-

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda . V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

ArgumentException

Hodnota atributu xml:space nebo xml:lang je neplatná.

XmlException

Hodnota localName nebo ns je null.

Příklady

Následující příklad používá metodu WriteAttributeString k zápisu deklarace oboru názvů.

C#

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

     // Write the root element.
     writer.WriteStartElement("book");

     // Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", null,"urn:book");

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();
  }
}

Poznámky

Tato metoda vypíše atribut s předponou oboru názvů definovanou uživatelem a přidruží ho k danému oboru názvů. Pokud je předpona "xmlns", pak tato metoda také považuje za deklaraci oboru názvů a přidruží deklarovanou předponu k identifikátoru URI oboru názvů zadanému v dané hodnotě atributu. V tomto případě ns může být nullargumentem .

WriteAttributeString provede následující:

• Pokud hodnota atributu obsahuje dvojité nebo jednoduché uvozovky, nahradí " se za a ' v uvedeném pořadí.

• Při zápisu atributu xml:space zapisovač ověří, že hodnota atributu je platná. (Platné hodnoty jsou preserve nebo default.)

• Při zápisu xml:lang atributu zapisovač neověřuje, zda je hodnota atributu platná podle doporučení W3C XML 1.0.

Asynchronní verzi této metody najdete v tématu WriteAttributeStringAsync.

WriteAttributeString(String, String, String)

Zdroj:

XmlWriter.cs

Při přepsání v odvozené třídě zapíše atribut se zadaným místním názvem, identifikátorem URI oboru názvů a hodnotou.

C#

public void WriteAttributeString (string localName, string? ns, string? value);

Parametry

localName

String

Místní název atributu.

ns

String

Identifikátor URI oboru názvů, který se má přidružit k atributu .

value

String

Hodnota atributu.

Výjimky

InvalidOperationException

Stav zapisovače není WriteState.Element nebo je zapisovač uzavřen.

-nebo-

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda . V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

ArgumentException

Hodnota atributu xml:space nebo xml:lang je neplatná.

Příklady

Následující příklad používá metodu WriteAttributeString k zápisu deklarace oboru názvů.

C#

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

     // Write the root element.
     writer.WriteStartElement("book");

     // Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", null,"urn:book");

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();
  }
}

Poznámky

Tato metoda vypíše atribut s předponou oboru názvů definovanou uživatelem a přidruží ho k danému oboru názvů. Pokud localName je "xmlns", pak tato metoda také považuje za deklaraci oboru názvů. V tomto případě ns může být nullargument .

WriteAttributeString provede následující:

• Pokud hodnota atributu obsahuje dvojité nebo jednoduché uvozovky, nahradí " se za a ' v uvedeném pořadí.

• Při zápisu atributu xml:space zapisovač ověří, že hodnota atributu je platná. (Platné hodnoty jsou preserve nebo default.)

• Při zápisu xml:lang atributu zapisovač neověřuje, zda je hodnota atributu platná podle doporučení W3C XML 1.0.

Asynchronní verzi této metody najdete v tématu WriteAttributeStringAsync.

WriteAttributeString(String, String)

Zdroj:

XmlWriter.cs

Při přepsání v odvozené třídě zapíše atribut se zadaným místním názvem a hodnotou.

C#

public void WriteAttributeString (string localName, string? value);

Parametry

localName

String

Místní název atributu.

value

String

Hodnota atributu.

Výjimky

InvalidOperationException

Stav zapisovače není WriteState.Element nebo je zapisovač uzavřen.

-nebo-

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda . V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

ArgumentException

Hodnota atributu xml:space nebo xml:lang je neplatná.

Příklady

Následující příklad zapíše knihu.

C#

using System;
using System.IO;
using System.Xml;

 public class Sample
 {
   private const string m_Document = "sampledata.xml";

   public static void Main() {

      XmlWriter writer = null;

      try {

        XmlWriterSettings settings = new XmlWriterSettings();
        settings.Indent = true;
        writer = XmlWriter.Create (m_Document, settings);

        writer.WriteComment("sample XML fragment");

        // Write an element (this one is the root).
        writer.WriteStartElement("book");

        // Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", null, "urn:samples");

        // Write the genre attribute.
        writer.WriteAttributeString("genre", "novel");

        // Write the title.
        writer.WriteStartElement("title");
        writer.WriteString("The Handmaid's Tale");
        writer.WriteEndElement();

        // Write the price.
        writer.WriteElementString("price", "19.95");

        // Lookup the prefix and write the ISBN element.
        string prefix = writer.LookupPrefix("urn:samples");
        writer.WriteStartElement(prefix, "ISBN", "urn:samples");
        writer.WriteString("1-861003-78");
        writer.WriteEndElement();

        // Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover");

        // Write the close tag for the root element.
        writer.WriteEndElement();

        // Write the XML to file and close the writer.
        writer.Flush();
        writer.Close();
      }

      finally {
        if (writer != null)
           writer.Close();
     }
   }
 }

Poznámky

WriteAttributeString provede následující:

• Pokud hodnota atributu obsahuje dvojité nebo jednoduché uvozovky, nahradí " se za a ' v uvedeném pořadí.

• Při zápisu atributu xml:space zapisovač ověří, že hodnota atributu je platná. (Platné hodnoty jsou preserve nebo default.)

• Při zápisu xml:lang atributu zapisovač neověřuje, zda je hodnota atributu platná podle doporučení W3C XML 1.0.

Asynchronní verzi této metody najdete v tématu WriteAttributeStringAsync.