XmlWriterSettings.OmitXmlDeclaration Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, следует ли опущению объявления XML.
public:
property bool OmitXmlDeclaration { bool get(); void set(bool value); };
public bool OmitXmlDeclaration { get; set; }
member this.OmitXmlDeclaration : bool with get, set
Public Property OmitXmlDeclaration As Boolean
Значение свойства
true Значение , чтобы опустить объявление XML; falseв противном случае . По умолчанию falseзаписывается объявление XML.
Примеры
В следующем примере фрагмент XML записывается в поток памяти.
XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;
// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();
// Do additional processing on the stream.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false
' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()
' Do additional processing on the stream.
Комментарии
Это свойство применяется только к XmlWriter экземплярам, выходным текстовым содержимым. В противном случае этот параметр игнорируется.
Если OmitXmlDeclaration задано значение false, объявление XML записывается автоматически.
Объявление XML всегда записывается, если ConformanceLevel задано Documentзначение , даже если OmitXmlDeclaration задано значение true.
Объявление XML никогда не записывается, если ConformanceLevel задано значение Fragment. Вы можете явно WriteProcessingInstruction записать объявление XML.