How to Create an Xml File in C#: A Simple Guide

Creating an XML file in C# is straightforward and can be extremely useful for storing structured data in a human-readable format. In this guide, we’ll go over a basic example using XmlWriter to create an XML file from scratch.

1. Setting Up the XmlWriter

The XmlWriter class in C# allows us to create an XML file with structured elements and attributes. You can start by adding using System.Xml; at the top of your file to import the necessary XML namespace.

Example: Creating a Basic XML File

Let’s create an XML file called books.xml with a list of books, each containing a title, author, and publication year.

using System;
using System.Xml;

class Program
{
    static void Main()
    {
        // Define the file path where the XML will be saved
        string filePath = "books.xml";

        // Initialize the XmlWriter settings for indentation
        XmlWriterSettings settings = new XmlWriterSettings
        {
            Indent = true,   // Makes the XML easier to read
            IndentChars = "  "
        };

        // Create the XmlWriter
        using (XmlWriter writer = XmlWriter.Create(filePath, settings))
        {
            // Start the document
            writer.WriteStartDocument();

            // Root element <library>
            writer.WriteStartElement("library");

            // First book element
            writer.WriteStartElement("book");
            writer.WriteElementString("title", "C# Basics");
            writer.WriteElementString("author", "Jane Doe");
            writer.WriteElementString("year", "2023");
            writer.WriteEndElement(); // Ends <book>

            // Second book element
            writer.WriteStartElement("book");
            writer.WriteElementString("title", "Advanced C#");
            writer.WriteElementString("author", "John Smith");
            writer.WriteElementString("year", "2024");
            writer.WriteEndElement(); // Ends <book>

            // End the root element </library>
            writer.WriteEndElement();

            // End the document
            writer.WriteEndDocument();
        }

        Console.WriteLine("XML file 'books.xml' created successfully!");
    }
}

Explanation of the Code

1. Define XmlWriterSettings: We set Indent = true so that the XML is formatted nicely with indentation.
2. Start the XML Document: Using writer.WriteStartDocument() to begin the XML file.
3. Create Root Element (<library>): This is the parent element that will contain all the <book> elements.
4. Add Book Elements: For each <book>, we add child elements like <title>, <author>, and <year> using writer.WriteElementString.
5. Close Elements and Finish Document: We end each element and complete the document using WriteEndElement() and WriteEndDocument().

Resulting XML File (books.xml)

The above code will generate an XML file that looks like this:

<?xml version="1.0" encoding="utf-8"?>
<library>
  <book>
    <title>C# Basics</title>
    <author>Jane Doe</author>
    <year>2023</year>
  </book>
  <book>
    <title>Advanced C#</title>
    <author>John Smith</author>
    <year>2024</year>
  </book>
</library>

Summary

To create an XML file in C#:

• Use XmlWriter to start the document and write elements.
• Structure the XML with a root element and nested child elements.
• Save the file, and you’re ready to use XML in your application.

Creating XML files like this can make data handling more efficient and organized, especially when sharing data across different systems. Give it a try and see how easy it is to get started with XML in C#!

Happy Coding…

Subscribe to Youtube Channel