Metodo XmlDocument.Save (Stream)
Aggiornamento: novembre 2007
Salva il documento XML nel flusso specificato.
Assembly: System.Xml (in System.Xml.dll)
| Eccezione | Condizione |
|---|---|
| XmlException | Il risultato dell'operazione non sarebbe un documento XML di formato corretto: ad esempio, nessun elemento documento o dichiarazioni XML duplicate. |
Gli spazi vuoti vengono mantenuti solo se PreserveWhitespace è impostato su true.
L'XmlDeclaration dell'oggetto XmlDocument corrente determina l'attributo di codifica del documento salvato. Il valore dell'attributo di codifica viene ottenuto dalla proprietà XmlDeclaration.Encoding. Se l'XmlDocument non dispone di un XmlDeclaration, oppure l'XmlDeclaration non dispone di un attributo di codifica, tale attributo non sarà disponibile neanche nel documento salvato.
Al salvataggio del documento vengono generati attributi xmlns che consentono di mantenere correttamente l'identità del nodo, costituita dalla combinazione di LocalName e NamespaceURI. Ad esempio, mediante il seguente codice C#
XmlDocument doc = new XmlDocument();
doc.AppendChild(doc.CreateElement("item","urn:1"));
doc.Save(Console.Out);
genera il seguente attributo xmls: <item xmls="urn:1"/> .
Questo metodo è un'estensione Microsoft del modello DOM (Document Object Model).
Solo il metodo Save applica un documento XML ben formato. Tutti gli altri overload di Save garantiscono soltanto un frammento ben formato.
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC, Xbox 360
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
