XmlWriter.WriteAttributeString Метод

Определение

Пространство имен:: System.Xml

Сборки:: System.Xml.dll, System.Xml.ReaderWriter.dll

Сборки:: netstandard.dll, System.Xml.ReaderWriter.dll

Сборка:: System.Xml.ReaderWriter.dll

Сборка:: System.Xml.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

При переопределении в производном классе записывает атрибут с указанным значением.

Перегрузки

Имя	Описание
WriteAttributeString(String, String, String, String)	При переопределении в производном классе записывает атрибут с указанным префиксом, локальным именем, URI пространства имен и значением.
WriteAttributeString(String, String, String)	При переопределении в производном классе записывает атрибут с указанным локальным именем, URI пространства имен и значением.
WriteAttributeString(String, String)	При переопределении в производном классе записывает атрибут с указанным локальным именем и значением.

WriteAttributeString(String, String, String, String)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

При переопределении в производном классе записывает атрибут с указанным префиксом, локальным именем, URI пространства имен и значением.

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)

Параметры

prefix: String

Префикс пространства имен атрибута.

localName: String

Локальное имя атрибута.

ns: String

URI пространства имен атрибута.

value: String

Значение атрибута.

Исключения

InvalidOperationException

Состояние писателя не WriteState.Element закрыто или запись закрыта.

–или–

Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".

ArgumentException

Недопустимое xml:space значение или xml:lang значение атрибута.

XmlException

Или localNamens есть null.

Примеры

В следующем примере метод используется WriteAttributeString для записи объявления пространства имен.

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

Этот метод записывает атрибут с префиксом пользовательского пространства имен и связывает его с заданным пространством имен. Если префикс имеет значение xmlns, этот метод также обрабатывает это как объявление пространства имен и связывает объявленный префикс с URI пространства имен, предоставленным в заданном значении атрибута. В этом случае ns аргумент может быть null.

WriteAttributeString выполняет следующие действия:

Если значение атрибута содержит двойные или одинарные кавычки, они заменяются и "' соответственно.
При написании атрибута xml:space средство записи проверяет допустимое значение атрибута. (Допустимые значения: preserve или default.)
При написании атрибута xml:lang модуль записи не проверяет допустимость значения атрибута в соответствии с рекомендацией W3C XML 1.0.

Сведения об асинхронной версии этого метода см. в разделе WriteAttributeStringAsync.

Применяется к

WriteAttributeString(String, String, String)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

При переопределении в производном классе записывает атрибут с указанным локальным именем, URI пространства имен и значением.

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)

Параметры

localName: String

Локальное имя атрибута.

ns: String

Универсальный код ресурса (URI) пространства имен для связывания с атрибутом.

value: String

Значение атрибута.

Исключения

InvalidOperationException

Состояние писателя не WriteState.Element закрыто или запись закрыта.

–или–

ArgumentException

Недопустимое xml:space значение или xml:lang значение атрибута.

Примеры

В следующем примере метод используется WriteAttributeString для записи объявления пространства имен.

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

Этот метод записывает атрибут с префиксом пользовательского пространства имен и связывает его с заданным пространством имен. Если localName это xmlns, этот метод также обрабатывает это как объявление пространства имен. В этом случае ns аргумент может быть null.

WriteAttributeString выполняет следующие действия:

Если значение атрибута содержит двойные или одинарные кавычки, они заменяются и "' соответственно.
При написании атрибута xml:space средство записи проверяет допустимое значение атрибута. (Допустимые значения: preserve или default.)
При написании атрибута xml:lang модуль записи не проверяет допустимость значения атрибута в соответствии с рекомендацией W3C XML 1.0.

Сведения об асинхронной версии этого метода см. в разделе WriteAttributeStringAsync.

Применяется к

WriteAttributeString(String, String)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

При переопределении в производном классе записывает атрибут с указанным локальным именем и значением.

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)

Параметры

localName: String

Локальное имя атрибута.

value: String

Значение атрибута.

Исключения

InvalidOperationException

Состояние писателя не WriteState.Element закрыто или запись закрыта.

–или–

ArgumentException

Недопустимое xml:space значение или xml:lang значение атрибута.

Примеры

В следующем примере выписывается книга.

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

Если значение атрибута содержит двойные или одинарные кавычки, они заменяются и "' соответственно.
При написании атрибута xml:space средство записи проверяет допустимое значение атрибута. (Допустимые значения: preserve или default.)
При написании атрибута xml:lang модуль записи не проверяет допустимость значения атрибута в соответствии с рекомендацией W3C XML 1.0.

Сведения об асинхронной версии этого метода см. в разделе WriteAttributeStringAsync.

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

XmlWriter.WriteAttributeString Метод

Определение

Перегрузки

Комментарии

WriteAttributeString(String, String, String, String)

Параметры

Исключения

Примеры

Комментарии

Применяется к

WriteAttributeString(String, String, String)

Параметры

Исключения

Примеры

Комментарии

Применяется к

WriteAttributeString(String, String)

Параметры

Исключения

Примеры

Комментарии

Применяется к