XmlWriter.WriteAttributeString Methode

Definitie

Naamruimte:: System.Xml

Assembly's:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assembly's:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u een kenmerk met de opgegeven waarde.

Overloads

Name	Description
WriteAttributeString(String, String, String, String)	Wanneer het kenmerk wordt overschreven in een afgeleide klasse, schrijft u het kenmerk uit met het opgegeven voorvoegsel, de lokale naam, de naamruimte-URI en de waarde.
WriteAttributeString(String, String, String)	Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u een kenmerk met de opgegeven lokale naam, naamruimte-URI en waarde.
WriteAttributeString(String, String)	Wanneer het kenmerk wordt overschreven in een afgeleide klasse, schrijft u het kenmerk uit met de opgegeven lokale naam en waarde.

Opmerkingen

Zie voor de asynchrone versie van deze methode WriteElementStringAsync.

WriteAttributeString(String, String, String, String)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Wanneer het kenmerk wordt overschreven in een afgeleide klasse, schrijft u het kenmerk uit met het opgegeven voorvoegsel, de lokale naam, de naamruimte-URI en de waarde.

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)

Parameters

prefix: String

Het voorvoegsel van de naamruimte van het kenmerk.

localName: String

De lokale naam van het kenmerk.

ns: String

De naamruimte-URI van het kenmerk.

value: String

De waarde van het kenmerk.

Uitzonderingen

InvalidOperationException

De staat van schrijver is niet WriteState.Element of schrijver is gesloten.

– of –

Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

ArgumentException

De xml:space waarde of xml:lang het kenmerk is ongeldig.

XmlException

De localName of ns is null.

Voorbeelden

In het volgende voorbeeld wordt de WriteAttributeString methode gebruikt om een naamruimtedeclaratie te schrijven.

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

Opmerkingen

Met deze methode wordt het kenmerk weggeschreven met een door de gebruiker gedefinieerd naamruimtevoorvoegsel en wordt het gekoppeld aan de opgegeven naamruimte. Als het voorvoegsel 'xmlns' is, behandelt deze methode dit ook als een naamruimtedeclaratie en koppelt het gedeclareerde voorvoegsel aan de naamruimte-URI die is opgegeven in de opgegeven kenmerkwaarde. In dit geval kan het ns argument zijn null.

WriteAttributeString doet het volgende:

Als de kenmerkwaarde dubbele of enkele aanhalingstekens bevat, worden deze vervangen " door respectievelijk ' .
Als u een xml:space kenmerk schrijft, controleert de schrijver of de kenmerkwaarde geldig is. (Geldige waarden zijn preserve of default.)
Als u een xml:lang kenmerk schrijft, controleert de schrijver niet of de kenmerkwaarde geldig is volgens de W3C XML 1.0-aanbeveling.

Zie voor de asynchrone versie van deze methode WriteAttributeStringAsync.

Van toepassing op

WriteAttributeString(String, String, String)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u een kenmerk met de opgegeven lokale naam, naamruimte-URI en waarde.

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)

Parameters

localName: String

De lokale naam van het kenmerk.

ns: String

De naamruimte-URI die moet worden gekoppeld aan het kenmerk.

value: String

De waarde van het kenmerk.

Uitzonderingen

InvalidOperationException

De staat van schrijver is niet WriteState.Element of schrijver is gesloten.

– of –

ArgumentException

De xml:space waarde of xml:lang het kenmerk is ongeldig.

Voorbeelden

In het volgende voorbeeld wordt de WriteAttributeString methode gebruikt om een naamruimtedeclaratie te schrijven.

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

Opmerkingen

Met deze methode wordt het kenmerk weggeschreven met een door de gebruiker gedefinieerd naamruimtevoorvoegsel en wordt het gekoppeld aan de opgegeven naamruimte. Als localName 'xmlns' is, wordt deze methode ook behandeld als een naamruimtedeclaratie. In dit geval kan het ns argument zijn null.

WriteAttributeString doet het volgende:

Als de kenmerkwaarde dubbele of enkele aanhalingstekens bevat, worden deze vervangen " door respectievelijk ' .
Als u een xml:space kenmerk schrijft, controleert de schrijver of de kenmerkwaarde geldig is. (Geldige waarden zijn preserve of default.)
Als u een xml:lang kenmerk schrijft, controleert de schrijver niet of de kenmerkwaarde geldig is volgens de W3C XML 1.0-aanbeveling.

Zie voor de asynchrone versie van deze methode WriteAttributeStringAsync.

Van toepassing op

WriteAttributeString(String, String)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Wanneer het kenmerk wordt overschreven in een afgeleide klasse, schrijft u het kenmerk uit met de opgegeven lokale naam en waarde.

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)

Parameters

localName: String

De lokale naam van het kenmerk.

value: String

De waarde van het kenmerk.

Uitzonderingen

InvalidOperationException

De staat van schrijver is niet WriteState.Element of schrijver is gesloten.

– of –

ArgumentException

De xml:space waarde of xml:lang het kenmerk is ongeldig.

Voorbeelden

In het volgende voorbeeld wordt een boek geschreven.

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

Opmerkingen

WriteAttributeString doet het volgende:

Als de kenmerkwaarde dubbele of enkele aanhalingstekens bevat, worden deze vervangen " door respectievelijk ' .
Als u een xml:space kenmerk schrijft, controleert de schrijver of de kenmerkwaarde geldig is. (Geldige waarden zijn preserve of default.)
Als u een xml:lang kenmerk schrijft, controleert de schrijver niet of de kenmerkwaarde geldig is volgens de W3C XML 1.0-aanbeveling.

Zie voor de asynchrone versie van deze methode WriteAttributeStringAsync.

Van toepassing op

Feedback

Is deze pagina nuttig?