XmlWriter.WriteAttributeString Metódus

Definíció

Névtér:: System.Xml

Szerelvények:: System.Xml.dll, System.Xml.ReaderWriter.dll

Szerelvény:: System.Xml.dll

Szerelvény:: System.Xml.ReaderWriter.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Ha egy származtatott osztályban felül van bírálva, egy attribútumot ír a megadott értékkel.

Túlterhelések

Name	Description
WriteAttributeString(String, String, String)	Ha egy származtatott osztályban felül van bírálva, ír egy attribútumot a megadott helyi névvel, névtér URI-val és értékkel.
WriteAttributeString(String, String, String, String)	Ha egy származtatott osztályban felül van bírálva, a megadott előtaggal, helyi névvel, névtér URI-val és értékkel írja ki az attribútumot.
WriteAttributeString(String, String)	Ha egy származtatott osztályban felül van bírálva, a megadott helyi névvel és értékkel írja ki az attribútumot.

Megjegyzések

A metódus aszinkron verziójáról lásd WriteElementStringAsync: .

WriteAttributeString(String, String, String)

Ha egy származtatott osztályban felül van bírálva, ír egy attribútumot a megadott helyi névvel, névtér URI-val és értékkel.

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ ns, System::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)

Paraméterek

localName: String

Az attribútum helyi neve.

ns: String

Az attribútumhoz társítandó névtér URI-ja.

value: String

Az attribútum értéke.

Kivételek

InvalidOperationException

Az író állapota nincs WriteState.Element , vagy az író bezárult.

-vagy-

Egy XmlWriter metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

ArgumentException

Az xml:space vagy xml:lang attribútum értéke érvénytelen.

Példák

Az alábbi példa a névtérdeklaráció írásához használja a WriteAttributeString metódust.

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

Megjegyzések

Ez a metódus egy felhasználó által definiált névtérelőtaggal írja ki az attribútumot, és társítja a megadott névtérrel. Ha localName "xmln", akkor ez a módszer névtérdeklarációként is kezeli ezt. Ebben az esetben az ns argumentum lehet null.

WriteAttributeString a következőket teszi:

Ha az attribútum értéke dupla vagy egy idézőjelet tartalmaz, azokat a rendszer lecseréli " és ' felváltja.
Attribútum írásakor xml:space az író ellenőrzi, hogy az attribútum értéke érvényes-e. (Érvényes értékek vagy preservedefault.)
Attribútum írásakor xml:lang az író nem ellenőrzi, hogy az attribútum értéke érvényes-e a W3C XML 1.0-javaslatnak megfelelően.

A metódus aszinkron verziójáról lásd WriteAttributeStringAsync: .

A következőre érvényes:

WriteAttributeString(String, String, String, String)

Ha egy származtatott osztályban felül van bírálva, a megadott előtaggal, helyi névvel, névtér URI-val és értékkel írja ki az attribútumot.

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

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

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

Paraméterek

prefix: String

Az attribútum névtérelőtagja.

localName: String

Az attribútum helyi neve.

ns: String

Az attribútum névterének URI-ja.

value: String

Az attribútum értéke.

Kivételek

InvalidOperationException

Az író állapota nincs WriteState.Element , vagy az író bezárult.

-vagy-

ArgumentException

Az xml:space vagy xml:lang attribútum értéke érvénytelen.

XmlException

Az localName vagy ns az null.

Példák

Az alábbi példa a névtérdeklaráció írásához használja a WriteAttributeString metódust.

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

Megjegyzések

Ez a metódus egy felhasználó által definiált névtérelőtaggal írja ki az attribútumot, és társítja a megadott névtérrel. Ha az előtag "xmlns", akkor ez a módszer névtérdeklarációként is kezeli, és a deklarált előtagot a megadott attribútumértékben megadott névtér URI-val társítja. Ebben az esetben az ns argumentum lehet null.

WriteAttributeString a következőket teszi:

Ha az attribútum értéke dupla vagy egy idézőjelet tartalmaz, azokat a rendszer lecseréli " és ' felváltja.
Attribútum írásakor xml:space az író ellenőrzi, hogy az attribútum értéke érvényes-e. (Érvényes értékek vagy preservedefault.)
Attribútum írásakor xml:lang az író nem ellenőrzi, hogy az attribútum értéke érvényes-e a W3C XML 1.0-javaslatnak megfelelően.

A metódus aszinkron verziójáról lásd WriteAttributeStringAsync: .

A következőre érvényes:

WriteAttributeString(String, String)

Ha egy származtatott osztályban felül van bírálva, a megadott helyi névvel és értékkel írja ki az attribútumot.

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

public void WriteAttributeString(string localName, string value);

member this.WriteAttributeString : string * string -> unit

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

Paraméterek

localName: String

Az attribútum helyi neve.

value: String

Az attribútum értéke.

Kivételek

InvalidOperationException

Az író állapota nincs WriteState.Element , vagy az író bezárult.

-vagy-

ArgumentException

Az xml:space vagy xml:lang attribútum értéke érvénytelen.

Példák

Az alábbi példa egy könyvet ír ki.

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

Megjegyzések

WriteAttributeString a következőket teszi:

Ha az attribútum értéke dupla vagy egy idézőjelet tartalmaz, azokat a rendszer lecseréli " és ' felváltja.
Attribútum írásakor xml:space az író ellenőrzi, hogy az attribútum értéke érvényes-e. (Érvényes értékek vagy preservedefault.)
Attribútum írásakor xml:lang az író nem ellenőrzi, hogy az attribútum értéke érvényes-e a W3C XML 1.0-javaslatnak megfelelően.

A metódus aszinkron verziójáról lásd WriteAttributeStringAsync: .

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?