XmlWriterSettings.ConformanceLevel Propriedade

public:
 property System::Xml::ConformanceLevel ConformanceLevel { System::Xml::ConformanceLevel get(); void set(System::Xml::ConformanceLevel value); };

public System.Xml.ConformanceLevel ConformanceLevel { get; set; }

member this.ConformanceLevel : System.Xml.ConformanceLevel with get, set

Public Property ConformanceLevel As ConformanceLevel

Valor de Propriedade

Um dos valores de enumeração que especifica o nível de conformidade (documento, fragmento ou deteção automática). A predefinição é Document.

Exemplos

O exemplo seguinte escreve um fragmento XML num fluxo de memória.

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.

Observações

A XmlWriterSettings.ConformanceLevel propriedade configura o escritor XML para verificar e garantir que o fluxo a ser escrito cumpre um determinado conjunto de regras. Os dados XML podem ser verificados para verificar se cumprem as regras de um documento XML 1.0 bem formado ou de um fragmento de documento. A tabela seguinte descreve as três configurações. O padrão é a conformidade ao nível do documento.

Se o escritor XML detetar alguma informação que viole o nível de conformidade especificado, lança uma exceção. Em alguns casos, o escritor XML corrige automaticamente o erro de conformidade. Por exemplo, o escritor fecha um atributo não fechado sem lançar uma exceção. A tabela seguinte mostra como as várias violações de conformidade são tratadas em cada cenário.