XmlWriter.WriteAttributeString Metoda

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.dll, System.Xml.ReaderWriter.dll

Sestavení:: netstandard.dll, System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Přetížení

Name	Description
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 naleznete v tématu WriteElementStringAsync.

WriteAttributeString(String, String, String, String)

Zdroj:: XmlWriter.cs

Zdroj:: XmlWriter.cs

Zdroj:: XmlWriter.cs

Zdroj:: XmlWriter.cs

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.

public:
 void WriteAttributeString(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);

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

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

member this.WriteAttributeString : string * string * string * string -> unit

Public Sub WriteAttributeString (prefix As String, localName As String, ns As String, value As String)

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 spisovatele není WriteState.Element nebo zapisovač je zavřený.

nebo

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

ArgumentException

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

XmlException

localName Nebo ns je null.

Příklady

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

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();
  }
}

Imports System.IO
Imports System.Xml

Public Class Sample 

  Public Shared Sub Main() 
 
     Dim writer As XmlWriter = Nothing

     writer = XmlWriter.Create("sampledata.xml")
        
     ' Write the root element.
     writer.WriteStartElement("book")

     ' Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", Nothing,"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()  

  End Sub
End Class

Poznámky

Tato metoda zapíš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", tato metoda také zachází jako s deklarací 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 nullargument .

WriteAttributeString provede následující:

Pokud hodnota atributu obsahuje dvojité nebo jednoduché uvozovky, nahradí " se 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ěří, že hodnota atributu je platná podle doporučení W3C XML 1.0.

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

Platí pro

WriteAttributeString(String, String, String)

Zdroj:: XmlWriter.cs

Zdroj:: XmlWriter.cs

Zdroj:: XmlWriter.cs

Zdroj:: XmlWriter.cs

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.

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ ns, System::String ^ value);

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

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

member this.WriteAttributeString : string * string * string -> unit

Public Sub WriteAttributeString (localName As String, ns As String, value As String)

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 spisovatele není WriteState.Element nebo zapisovač je zavřený.

nebo

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

ArgumentException

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

Příklady

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

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();
  }
}

Imports System.IO
Imports System.Xml

Public Class Sample 

  Public Shared Sub Main() 
 
     Dim writer As XmlWriter = Nothing

     writer = XmlWriter.Create("sampledata.xml")
        
     ' Write the root element.
     writer.WriteStartElement("book")

     ' Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", Nothing,"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()  

  End Sub
End Class

Poznámky

Tato metoda zapíš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", 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 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ěří, že hodnota atributu je platná podle doporučení W3C XML 1.0.

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

Platí pro

WriteAttributeString(String, String)

Zdroj:: XmlWriter.cs

Zdroj:: XmlWriter.cs

Zdroj:: XmlWriter.cs

Zdroj:: XmlWriter.cs

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.

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ value);

public void WriteAttributeString(string localName, string value);

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

member this.WriteAttributeString : string * string -> unit

Public Sub WriteAttributeString (localName As String, value As String)

Parametry

localName: String

Místní název atributu.

value: String

Hodnota atributu.

Výjimky

InvalidOperationException

Stav spisovatele není WriteState.Element nebo zapisovač je zavřený.

nebo

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

ArgumentException

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

Příklady

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

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();
     }
   }
 }

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml

Public Class Sample
    Private Shared m_Document As String = "sampledata.xml"
    
    Public Shared Sub Main()
        Dim writer As XmlWriter = Nothing
        
      Try

        Dim settings As XmlWriterSettings = 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", Nothing, "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.
        Dim prefix As String = 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 Not (writer Is Nothing) Then
                writer.Close()
            End If
        End Try

    End Sub
End Class

Poznámky

WriteAttributeString provede následující:

Pokud hodnota atributu obsahuje dvojité nebo jednoduché uvozovky, nahradí " se 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ěří, že hodnota atributu je platná podle doporučení W3C XML 1.0.

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

Platí pro

Váš názor

Byla tato stránka užitečná?