XmlWriterSettings.ConformanceLevel Proprietà

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

Valore della proprietà

Uno dei valori di enumerazione che specifica il livello di conformità (documento, frammento o rilevamento automatico). Il valore predefinito è Document.

Esempio

Nell'esempio seguente viene scritto un frammento XML in un flusso di memoria.

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.

Commenti

La XmlWriterSettings.ConformanceLevel proprietà configura il writer XML per verificare e garantire che il flusso scritto sia conforme a un determinato set di regole. È possibile controllare i dati XML per verificare che siano conformi alle regole per un documento XML 1.0 ben formato o un frammento di documento. Nella tabella seguente vengono descritte le tre impostazioni. Il valore predefinito è la conformità a livello di documento.

Se il writer XML rileva eventuali informazioni che violano il livello di conformità specificato, genera un'eccezione. In alcuni casi, il writer XML corregge automaticamente l'errore di conformità. Ad esempio, il writer chiude un attributo non chiuso senza generare un'eccezione. Nella tabella seguente viene illustrato come vengono gestite varie violazioni di conformità in ogni impostazione.