XmlWriter.WriteAttributeString Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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 " ' .
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 " ' .
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 " ' .
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

XmlWriter.WriteAttributeString Metoda

Definicja

Przeciążenia

Uwagi

WriteAttributeString(String, String, String, String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

WriteAttributeString(String, String, String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

WriteAttributeString(String, String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby