Udostępnij za pośrednictwem

XmlWriter.WriteAttributeString Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Xml
Zestaw:
System.Xml.ReaderWriter.dll
Zestaw:
System.Xml.dll
Zestaw:
netstandard.dll

Po zastąpieniu w klasie pochodnej zapisuje atrybut z określoną wartością.

Przeciążenia

WriteAttributeString(String, String, String, String)

Po zastąpieniu w klasie pochodnej zapisuje atrybut z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.
WriteAttributeString(String, String, String)

Po zastąpieniu w klasie pochodnej zapisuje atrybut z określoną lokalną nazwą, identyfikatorem URI przestrzeni nazw i wartością.
WriteAttributeString(String, String)

Po zastąpieniu w klasie pochodnej zapisuje atrybut z określoną lokalną nazwą i wartością.

Uwagi

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteElementStringAsync.

WriteAttributeString(String, String, String, String)

Po zastąpieniu w klasie pochodnej zapisuje atrybut z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.

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

Prefiks przestrzeni nazw atrybutu.

localName
String

Lokalna nazwa atrybutu.

ns
String

Identyfikator URI przestrzeni nazw atrybutu.

value
String

Wartość atrybutu.

Wyjątki

InvalidOperationException

Stan pisarza nie WriteState.Element jest lub pisarz jest zamknięty.

-lub- Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentException

Wartość atrybutu lub xml:lang jest nieprawidłowaxml:space.

XmlException

Wartość localName lub ns to null.

Przykłady

W poniższym przykładzie WriteAttributeString użyto metody do zapisania deklaracji przestrzeni nazw.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlWriter^ writer = nullptr;
   writer = XmlWriter::Create( L"sampledata.xml" );
   
   // Write the root element.
   writer->WriteStartElement( L"book" );
   
   // Write the xmlns:bk="urn:book" namespace declaration.
   writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:book" );
   
   // Write the bk:ISBN="1-800-925" attribute.
   writer->WriteAttributeString( L"ISBN", L"urn:book", L"1-800-925" );
   writer->WriteElementString( L"price", L"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();
}

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

Uwagi

Ta metoda zapisuje atrybut z prefiksem przestrzeni nazw zdefiniowanej przez użytkownika i kojarzy go z daną przestrzenią nazw. Jeśli prefiks to "xmlns", ta metoda traktuje ją również jako deklarację przestrzeni nazw i kojarzy zadeklarowany prefiks z identyfikatorem URI przestrzeni nazw podanym w podanej wartości atrybutu. W takim przypadku ns argument może mieć wartość null.

WriteAttributeString wykonuje następujące czynności:

  • Jeśli wartość atrybutu zawiera podwójne lub pojedyncze cudzysłowy, są one zastępowane odpowiednio i &quot; &apos; .

  • W przypadku pisania atrybutu xml:space składnik zapisywania sprawdza, czy wartość atrybutu jest prawidłowa. (Prawidłowe wartości to preserve lub default.)

  • W przypadku pisania xml:lang atrybutu składnik zapisywania nie sprawdza, czy wartość atrybutu jest prawidłowa zgodnie z zaleceniem W3C XML 1.0.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteAttributeStringAsync.

Dotyczy

WriteAttributeString(String, String, String)

Po zastąpieniu w klasie pochodnej zapisuje atrybut z określoną lokalną nazwą, identyfikatorem URI przestrzeni nazw i wartością.

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

Lokalna nazwa atrybutu.

ns
String

Identyfikator URI przestrzeni nazw do skojarzenia z atrybutem .

value
String

Wartość atrybutu.

Wyjątki

InvalidOperationException

Stan pisarza nie WriteState.Element jest lub pisarz jest zamknięty.

-lub- Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentException

Wartość atrybutu lub xml:lang jest nieprawidłowaxml:space.

Przykłady

W poniższym przykładzie użyto WriteAttributeString metody do zapisania deklaracji przestrzeni nazw.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlWriter^ writer = nullptr;
   writer = XmlWriter::Create( L"sampledata.xml" );
   
   // Write the root element.
   writer->WriteStartElement( L"book" );
   
   // Write the xmlns:bk="urn:book" namespace declaration.
   writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:book" );
   
   // Write the bk:ISBN="1-800-925" attribute.
   writer->WriteAttributeString( L"ISBN", L"urn:book", L"1-800-925" );
   writer->WriteElementString( L"price", L"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();
}

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

Uwagi

Ta metoda zapisuje atrybut z prefiksem przestrzeni nazw zdefiniowanym przez użytkownika i kojarzy go z daną przestrzenią nazw. Jeśli localName element to "xmlns", ta metoda traktuje ją również jako deklarację przestrzeni nazw. W takim przypadku argumentem ns może być null.

WriteAttributeString wykonuje następujące czynności:

  • Jeśli wartość atrybutu zawiera podwójny lub pojedynczy cudzysłów, są one zastępowane odpowiednio i &quot; &apos; .

  • W przypadku pisania atrybutu xml:space moduł zapisywania sprawdza, czy wartość atrybutu jest prawidłowa. (Prawidłowe wartości to preserve lub default.

  • W przypadku pisania atrybutu xml:lang składnik zapisywania nie sprawdza, czy wartość atrybutu jest prawidłowa zgodnie z zaleceniem W3C XML 1.0.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteAttributeStringAsync.

Dotyczy

WriteAttributeString(String, String)

Po zastąpieniu w klasie pochodnej zapisuje atrybut z określoną lokalną nazwą i wartością.

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

Lokalna nazwa atrybutu.

value
String

Wartość atrybutu.

Wyjątki

InvalidOperationException

Stan pisarza nie WriteState.Element jest lub pisarz jest zamknięty.

-lub-

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentException

Wartość atrybutu lub xml:lang jest nieprawidłowaxml:space.

Przykłady

Poniższy przykład zapisuje książkę.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
public ref class Sample
{
private:
   static String^ m_Document = L"sampledata.xml";

public:
   static void Main()
   {
      XmlWriter^ writer = nullptr;
      try
      {
         XmlWriterSettings^ settings = gcnew XmlWriterSettings;
         settings->Indent = true;
         writer = XmlWriter::Create( m_Document,settings );
         writer->WriteComment( L"sample XML fragment" );
         
         // Write an element (this one is the root).
         writer->WriteStartElement( L"book" );
         
         // Write the namespace declaration.
         writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:samples" );
         
         // Write the genre attribute.
         writer->WriteAttributeString( L"genre", L"novel" );
         
         // Write the title.
         writer->WriteStartElement( L"title" );
         writer->WriteString( L"The Handmaid's Tale" );
         writer->WriteEndElement();
         
         // Write the price.
         writer->WriteElementString( L"price", L"19.95" );
         
         // Lookup the prefix and write the ISBN element.
         String^ prefix = writer->LookupPrefix( L"urn:samples" );
         writer->WriteStartElement( prefix, L"ISBN", L"urn:samples" );
         writer->WriteString( L"1-861003-78" );
         writer->WriteEndElement();
         
         // Write the style element (shows a different way to handle prefixes).
         writer->WriteElementString( L"style", L"urn:samples", L"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 != nullptr )
                  writer->Close();
      }

   }

};

void main()
{
   Sample::Main();
}

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

Uwagi

WriteAttributeString wykonuje następujące czynności:

  • Jeśli wartość atrybutu zawiera podwójny lub pojedynczy cudzysłów, są one zastępowane odpowiednio i &quot; &apos; .

  • W przypadku pisania atrybutu xml:space moduł zapisywania sprawdza, czy wartość atrybutu jest prawidłowa. (Prawidłowe wartości to preserve lub default.

  • W przypadku pisania atrybutu xml:lang składnik zapisywania nie sprawdza, czy wartość atrybutu jest prawidłowa zgodnie z zaleceniem W3C XML 1.0.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteAttributeStringAsync.

Dotyczy