XmlWriter.Create Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée une nouvelle instance XmlWriter.
Surcharges
| Nom | Description |
|---|---|
| Create(StringBuilder, XmlWriterSettings) |
Crée une XmlWriter instance à l’aide des objets et StringBuilder des XmlWriterSettings objets. |
| Create(String, XmlWriterSettings) |
Crée une XmlWriter instance à l’aide du nom de fichier et XmlWriterSettings de l’objet. |
| Create(TextWriter, XmlWriterSettings) |
Crée une XmlWriter instance à l’aide des objets et TextWriter des XmlWriterSettings objets. |
| Create(Stream, XmlWriterSettings) |
Crée une XmlWriter instance à l’aide du flux et XmlWriterSettings de l’objet. |
| Create(XmlWriter, XmlWriterSettings) |
Crée une XmlWriter instance à l’aide des objets et XmlWriter des objets spécifiésXmlWriterSettings. |
| Create(StringBuilder) |
Crée une XmlWriter instance à l’aide de l’élément spécifié StringBuilder. |
| Create(String) |
Crée une XmlWriter instance à l’aide du nom de fichier spécifié. |
| Create(TextWriter) |
Crée une XmlWriter instance à l’aide de l’élément spécifié TextWriter. |
| Create(Stream) |
Crée une XmlWriter instance à l’aide du flux spécifié. |
| Create(XmlWriter) |
Crée une XmlWriter instance à l’aide de l’objet spécifié XmlWriter . |
Remarques
Certaines surcharges Create incluent un settings paramètre qui accepte un XmlWriterSettings objet. Vous pouvez utiliser cet objet pour :
Spécifiez les fonctionnalités que vous souhaitez prendre en charge sur l’objet créé XmlWriter .
Réutilisez l’objet XmlWriterSettings pour créer plusieurs objets writer. L’objet XmlWriterSettings est copié et marqué en lecture seule pour chaque enregistreur créé. Les modifications apportées aux paramètres d’une XmlWriterSettings instance n’affectent pas les enregistreurs existants avec les mêmes paramètres. Par conséquent, vous pouvez utiliser les mêmes paramètres pour créer plusieurs enregistreurs avec la même fonctionnalité. Vous pouvez également modifier les paramètres d’une XmlWriterSettings instance et créer un enregistreur avec un ensemble différent de fonctionnalités.
Ajoutez des fonctionnalités à un enregistreur XML existant. La Create méthode peut accepter un autre XmlWriter objet. L’objet sous-jacent XmlWriter n’a pas besoin d’être un enregistreur XML créé par la méthode statique Create . Par exemple, vous pouvez spécifier un enregistreur XML défini par l’utilisateur pour ajouter des fonctionnalités supplémentaires.
Tirez pleinement parti des fonctionnalités telles que la vérification de la conformité et la conformité à la recommandation XML 1.0 qui sont disponibles uniquement sur XmlWriter les objets créés par la méthode statique Create .
Si vous utilisez une Create surcharge qui n’accepte pas d’objet XmlWriterSettings , les paramètres d’enregistreur par défaut suivants sont utilisés :
| Setting | Par défaut |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Deux espaces |
| NamespaceHandling | Default (aucune suppression) |
| NewLineChars |
\r\n (retour chariot, flux de ligne) pour les plateformes non Unix ou \n (flux de ligne) pour les plateformes Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Note
Bien que l’infrastructure .NET inclut la classe XmlTextWriter, qui est une implémentation concrète de la classe XmlWriter, nous vous recommandons de créer des instances XmlWriter à l’aide de la méthode Create.
Create(StringBuilder, XmlWriterSettings)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
Crée une XmlWriter instance à l’aide des objets et StringBuilder des XmlWriterSettings objets.
public:
static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.Text.StringBuilder output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.Text.StringBuilder output, System.Xml.XmlWriterSettings? settings);
static member Create : System.Text.StringBuilder * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As StringBuilder, settings As XmlWriterSettings) As XmlWriter
Paramètres
- output
- StringBuilder
StringBuilder auquel écrire. Le contenu écrit par le XmlWriter fichier est ajouté au StringBuilder.
- settings
- XmlWriterSettings
Objet XmlWriterSettings utilisé pour configurer la nouvelle XmlWriter instance. Si c’est nullle cas, un XmlWriterSettings paramètre par défaut est utilisé.
Si la XmlWriter méthode est utilisée Transform(String, XmlWriter) , vous devez utiliser la OutputSettings propriété pour obtenir un XmlWriterSettings objet avec les paramètres appropriés. Cela garantit que l’objet créé XmlWriter a les paramètres de sortie corrects.
Retours
Objet XmlWriter.
Exceptions
output a la valeur null.
S’applique à
Create(String, XmlWriterSettings)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
Crée une XmlWriter instance à l’aide du nom de fichier et XmlWriterSettings de l’objet.
public:
static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(string outputFileName, System.Xml.XmlWriterSettings? settings);
public static System.Xml.XmlWriter Create(string outputFileName, System.Xml.XmlWriterSettings settings);
static member Create : string * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (outputFileName As String, settings As XmlWriterSettings) As XmlWriter
Paramètres
- outputFileName
- String
Fichier dans lequel vous souhaitez écrire. Le XmlWriter fichier crée un fichier au chemin d’accès spécifié et l’écrit dans la syntaxe de texte XML 1.0. Il outputFileName doit s’agir d’un chemin d’accès au système de fichiers.
- settings
- XmlWriterSettings
Objet XmlWriterSettings utilisé pour configurer la nouvelle XmlWriter instance. Si c’est nullle cas, un XmlWriterSettings paramètre par défaut est utilisé.
Si la XmlWriter méthode est utilisée Transform(String, XmlWriter) , vous devez utiliser la OutputSettings propriété pour obtenir un XmlWriterSettings objet avec les paramètres appropriés. Cela garantit que l’objet créé XmlWriter a les paramètres de sortie corrects.
Retours
Objet XmlWriter.
Exceptions
outputFileName a la valeur null.
Exemples
L’exemple suivant crée un XmlWriter objet avec les paramètres définis.
using System;
using System.IO;
using System.Xml;
using System.Text;
public class Sample {
public static void Main() {
XmlWriter writer = null;
try {
// Create an XmlWriterSettings object with the correct options.
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = ("\t");
settings.OmitXmlDeclaration = true;
// Create the XmlWriter object and write some content.
writer = XmlWriter.Create("data.xml", settings);
writer.WriteStartElement("book");
writer.WriteElementString("item", "tesing");
writer.WriteEndElement();
writer.Flush();
}
finally {
if (writer != null)
writer.Close();
}
}
}
Imports System.IO
Imports System.Xml
Imports System.Text
Public Class Sample
Public Shared Sub Main()
Dim writer As XmlWriter = Nothing
Try
' Create an XmlWriterSettings object with the correct options.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.Indent = true
settings.IndentChars = (ControlChars.Tab)
settings.OmitXmlDeclaration = true
' Create the XmlWriter object and write some content.
writer = XmlWriter.Create("data.xml", settings)
writer.WriteStartElement("book")
writer.WriteElementString("item", "tesing")
writer.WriteEndElement()
writer.Flush()
Finally
If Not (writer Is Nothing) Then
writer.Close()
End If
End Try
End Sub
End Class
S’applique à
Create(TextWriter, XmlWriterSettings)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
Crée une XmlWriter instance à l’aide des objets et TextWriter des XmlWriterSettings objets.
public:
static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.IO.TextWriter output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.IO.TextWriter output, System.Xml.XmlWriterSettings? settings);
static member Create : System.IO.TextWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As TextWriter, settings As XmlWriterSettings) As XmlWriter
Paramètres
- output
- TextWriter
TextWriter Auquel vous souhaitez écrire. Écrit XmlWriter la syntaxe de texte XML 1.0 et l’ajoute à l’élément spécifié TextWriter.
- settings
- XmlWriterSettings
Objet XmlWriterSettings utilisé pour configurer la nouvelle XmlWriter instance. Si c’est nullle cas, un XmlWriterSettings paramètre par défaut est utilisé.
Si la XmlWriter méthode est utilisée Transform(String, XmlWriter) , vous devez utiliser la OutputSettings propriété pour obtenir un XmlWriterSettings objet avec les paramètres appropriés. Cela garantit que l’objet créé XmlWriter a les paramètres de sortie corrects.
Retours
Objet XmlWriter.
Exceptions
output a la valeur null.
Exemples
L’exemple suivant écrit une chaîne XML.
XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
StringWriter sw = new StringWriter();
using (XmlWriter writer = XmlWriter.Create(sw, settings))
{
writer.WriteStartElement("book");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
String output = sw.ToString();
}
Dim settings As New XmlWriterSettings()
settings.OmitXmlDeclaration = True
Dim sw As New StringWriter()
Using writer As XmlWriter = XmlWriter.Create(sw, settings)
writer.WriteStartElement("book")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
Dim output As String = sw.ToString()
End Using
S’applique à
Create(Stream, XmlWriterSettings)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
Crée une XmlWriter instance à l’aide du flux et XmlWriterSettings de l’objet.
public:
static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.IO.Stream output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.IO.Stream output, System.Xml.XmlWriterSettings? settings);
static member Create : System.IO.Stream * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As Stream, settings As XmlWriterSettings) As XmlWriter
Paramètres
- output
- Stream
Flux dans lequel vous souhaitez écrire. Écrit XmlWriter la syntaxe de texte XML 1.0 et l’ajoute au flux spécifié.
- settings
- XmlWriterSettings
Objet XmlWriterSettings utilisé pour configurer la nouvelle XmlWriter instance. Si c’est nullle cas, un XmlWriterSettings paramètre par défaut est utilisé.
Si la XmlWriter méthode est utilisée Transform(String, XmlWriter) , vous devez utiliser la OutputSettings propriété pour obtenir un XmlWriterSettings objet avec les paramètres appropriés. Cela garantit que l’objet créé XmlWriter a les paramètres de sortie corrects.
Retours
Objet XmlWriter.
Exceptions
output a la valeur null.
Exemples
L’exemple suivant écrit un fragment XML dans un flux de mémoire.
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.
Remarques
XmlWriter écrit toujours une marque d’ordre d’octet (BOM) dans le flux de données sous-jacent ; toutefois, certains flux ne doivent pas avoir de boM. Pour omettre le boM, créez un XmlWriterSettings objet et définissez la propriété Encoding sur un nouvel UTF8Encoding objet avec la valeur booléenne dans le constructeur défini sur false.
S’applique à
Create(XmlWriter, XmlWriterSettings)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
Crée une XmlWriter instance à l’aide des objets et XmlWriter des objets spécifiésXmlWriterSettings.
public:
static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.Xml.XmlWriter output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.Xml.XmlWriter output, System.Xml.XmlWriterSettings? settings);
static member Create : System.Xml.XmlWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As XmlWriter, settings As XmlWriterSettings) As XmlWriter
Paramètres
- settings
- XmlWriterSettings
Objet XmlWriterSettings utilisé pour configurer la nouvelle XmlWriter instance. Si c’est nullle cas, un XmlWriterSettings paramètre par défaut est utilisé.
Si la XmlWriter méthode est utilisée Transform(String, XmlWriter) , vous devez utiliser la OutputSettings propriété pour obtenir un XmlWriterSettings objet avec les paramètres appropriés. Cela garantit que l’objet créé XmlWriter a les paramètres de sortie corrects.
Retours
Objet XmlWriter encapsulé autour de l’objet spécifié XmlWriter .
Exceptions
output a la valeur null.
Remarques
Cette méthode vous permet d’ajouter des fonctionnalités supplémentaires à un objet sous-jacent XmlWriter . L’objet sous-jacent XmlWriter peut être un objet créé par la XmlWriter.Create méthode ou un objet créé à l’aide de l’implémentation XmlTextWriter .
S’applique à
Create(StringBuilder)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
Crée une XmlWriter instance à l’aide de l’élément spécifié StringBuilder.
public:
static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output);
public static System.Xml.XmlWriter Create(System.Text.StringBuilder output);
static member Create : System.Text.StringBuilder -> System.Xml.XmlWriter
Public Shared Function Create (output As StringBuilder) As XmlWriter
Paramètres
- output
- StringBuilder
StringBuilder auquel écrire. Le contenu écrit par le XmlWriter fichier est ajouté au StringBuilder.
Retours
Objet XmlWriter.
Exceptions
output a la valeur null.
Remarques
Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec les paramètres par défaut est utilisé pour créer l’enregistreur XML.
| Setting | Par défaut |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Deux espaces |
| NamespaceHandling | Default (aucune suppression) |
| NewLineChars |
\r\n (retour chariot, flux de ligne) pour les plateformes non Unix ou \n (flux de ligne) pour les plateformes Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur XML créé, utilisez une surcharge qui prend un XmlWriterSettings objet en tant qu’un de ses arguments et passez un XmlWriterSettings objet avec vos paramètres personnalisés.
S’applique à
Create(String)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
Crée une XmlWriter instance à l’aide du nom de fichier spécifié.
public:
static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName);
public static System.Xml.XmlWriter Create(string outputFileName);
static member Create : string -> System.Xml.XmlWriter
Public Shared Function Create (outputFileName As String) As XmlWriter
Paramètres
- outputFileName
- String
Fichier dans lequel vous souhaitez écrire. Le XmlWriter fichier crée un fichier au chemin d’accès spécifié et l’écrit dans la syntaxe de texte XML 1.0. Il outputFileName doit s’agir d’un chemin d’accès au système de fichiers.
Retours
Objet XmlWriter.
Exceptions
outputFileName a la valeur null.
Exemples
L’exemple suivant crée un XmlWriter objet et écrit un nœud de livre.
using (XmlWriter writer = XmlWriter.Create("output.xml"))
{
writer.WriteStartElement("book");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
}
Using writer As XmlWriter = XmlWriter.Create("output.xml")
writer.WriteStartElement("book")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
End Using
Remarques
Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec les paramètres par défaut est utilisé pour créer l’enregistreur XML.
| Setting | Par défaut |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Deux espaces |
| NamespaceHandling | Default (aucune suppression) |
| NewLineChars |
\r\n (retour chariot, flux de ligne) pour les plateformes non Unix ou \n (flux de ligne) pour les plateformes Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur XML créé, utilisez une surcharge qui prend un XmlWriterSettings objet en tant qu’un de ses arguments et passez un XmlWriterSettings objet avec vos paramètres personnalisés.
S’applique à
Create(TextWriter)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
Crée une XmlWriter instance à l’aide de l’élément spécifié TextWriter.
public:
static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output);
public static System.Xml.XmlWriter Create(System.IO.TextWriter output);
static member Create : System.IO.TextWriter -> System.Xml.XmlWriter
Public Shared Function Create (output As TextWriter) As XmlWriter
Paramètres
- output
- TextWriter
TextWriter Auquel vous souhaitez écrire. Écrit XmlWriter la syntaxe de texte XML 1.0 et l’ajoute à l’élément spécifié TextWriter.
Retours
Objet XmlWriter.
Exceptions
output a la valeur null.
Exemples
L’exemple suivant crée un enregistreur qui se produit dans la console.
using (XmlWriter writer = XmlWriter.Create(Console.Out))
{
writer.WriteStartElement("book");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
}
Using writer As XmlWriter = XmlWriter.Create(Console.Out)
writer.WriteStartElement("book")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
End Using
Remarques
Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec les paramètres par défaut est utilisé pour créer l’enregistreur XML.
| Setting | Par défaut |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Deux espaces |
| NamespaceHandling | Default (aucune suppression) |
| NewLineChars |
\r\n (retour chariot, flux de ligne) pour les plateformes non Unix ou \n (flux de ligne) pour les plateformes Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur créé, utilisez une surcharge qui prend un XmlWriterSettings objet en tant qu’un de ses arguments et passez un XmlWriterSettings objet avec vos paramètres personnalisés.
S’applique à
Create(Stream)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
Crée une XmlWriter instance à l’aide du flux spécifié.
public:
static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output);
public static System.Xml.XmlWriter Create(System.IO.Stream output);
static member Create : System.IO.Stream -> System.Xml.XmlWriter
Public Shared Function Create (output As Stream) As XmlWriter
Paramètres
- output
- Stream
Flux dans lequel vous souhaitez écrire. Écrit XmlWriter la syntaxe de texte XML 1.0 et l’ajoute au flux spécifié.
Retours
Objet XmlWriter.
Exceptions
output a la valeur null.
Exemples
L’exemple suivant écrit un fragment XML dans un flux de mémoire. (Il utilise la Create(Stream, XmlWriterSettings) surcharge, qui configure également les paramètres sur la nouvelle instance d’enregistreur 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.
Remarques
Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec les paramètres par défaut suivants est utilisé pour créer l’enregistreur XML :
| Setting | Par défaut |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Deux espaces |
| NamespaceHandling | Default (aucune suppression) |
| NewLineChars |
\r\n (retour chariot, flux de ligne) pour les plateformes non Unix ou \n (flux de ligne) pour les plateformes Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur créé, utilisez une surcharge qui prend un XmlWriterSettings objet en tant qu’un de ses arguments et passez un XmlWriterSettings objet avec vos paramètres personnalisés.
En outre, XmlWriter écrit toujours une marque d’ordre d’octet (BOM) dans le flux de données sous-jacent ; toutefois, certains flux ne doivent pas avoir de boM. Pour omettre le boM, créez un XmlWriterSettings objet et définissez la propriété Encoding sur un nouvel UTF8Encoding objet avec la valeur booléenne dans le constructeur défini sur false.
S’applique à
Create(XmlWriter)
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
- Source:
- XmlWriter.cs
public:
static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output);
public static System.Xml.XmlWriter Create(System.Xml.XmlWriter output);
static member Create : System.Xml.XmlWriter -> System.Xml.XmlWriter
Public Shared Function Create (output As XmlWriter) As XmlWriter
Paramètres
Retours
Objet XmlWriter encapsulé autour de l’objet spécifié XmlWriter .
Exceptions
output a la valeur null.
Remarques
Cette méthode vous permet d’ajouter des fonctionnalités à un objet sous-jacent XmlWriter . L’objet sous-jacent XmlWriter peut être un objet créé par la XmlWriter.Create méthode ou un objet créé à l’aide de l’implémentation XmlTextWriter .
Lorsque vous utilisez cette surcharge, un XmlWriterSettings objet avec les paramètres par défaut est utilisé pour créer l’enregistreur XML.
| Setting | Par défaut |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Deux espaces |
| NamespaceHandling | Default (aucune suppression) |
| NewLineChars |
\r\n (retour chariot, flux de ligne) pour les plateformes non Unix ou \n (flux de ligne) pour les plateformes Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur l’enregistreur XML créé, utilisez une surcharge qui prend un XmlWriterSettings objet en tant qu’un de ses arguments et passez un XmlWriterSettings objet avec vos paramètres personnalisés.