Ikona wiadomości
Przejdź do treści stopki
  1. IronPDF
  2. Blog IronPDF
  3. Pomoc .NET
  4. C# Json Serializer
POMOC .NET

Serializator JSON w języku C# (jak to działa dla programistów)

Jacob Mellor, Dyrektor Technologiczny @ Team Iron
Jacob Mellor
Zaktualizowano:

W obszarze nowoczesnego tworzenia oprogramowania formaty wymiany danych odgrywają kluczową rolę w umożliwianiu komunikacji między różnorodnymi systemami. Jednym z takich formatów, który zyskał ogromną popularność, jest JSON (JavaScript Object Notation).

Programiści C# często mają do czynienia z danymi JSON, a aby ułatwić płynną interakcję, C# oferuje potężne narzędzie — C# JSON Serializer.

W tym artykule omówimy, czym jest serializacja JSON i jakie ma zastosowania. Postaramy się również zrozumieć proces serializacji JSON na przykładzie z wykorzystaniem biblioteki IronPDF.

1. Understanding C# JSON Serializer

C# JSON Serializer is a component that converts C# objects into their JSON representation and vice versa. This process, known as serialization and deserialization, is essential when exchanging data between a C# application and external systems or services.

Consider a scenario where an e-commerce application needs to send product information to a mobile app. Instead of sending raw C# objects, which the mobile app might not understand, the application can use a JSON serializer to convert the objects into a JSON format that is universally recognized and easily consumable by various platforms.

1.1. Examples of C# JSON Serialization

Let's delve into a simple example to illustrate the concept. Assume we have a C# class representing a person:

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}
public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}
Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
End Class
$vbLabelText   $csharpLabel

Using C# JSON serialization, we can convert an instance of this class into a JSON string:

Person person = new Person { Name = "John Doe", Age = 30 };
string json = JsonConvert.SerializeObject(person);
Person person = new Person { Name = "John Doe", Age = 30 };
string json = JsonConvert.SerializeObject(person);
Dim person As New Person With {
	.Name = "John Doe",
	.Age = 30
}
Dim json As String = JsonConvert.SerializeObject(person)
$vbLabelText   $csharpLabel

The resulting JSON string would be {"Name":"John Doe","Age":30}, representing the person object in a JSON format.

2. Types of C# JSON Serializer and Code Examples

C# offers various ways to perform JSON serialization, each with its own set of features and use cases. Here are some commonly used JSON serialization methods in C#:

2.1. DataContractJsonSerializer

This serializer is part of the System.Runtime.Serialization.Json namespace and uses the Data Contract attributes to control the serialization process.

using System;
using System.IO;
using System.Runtime.Serialization.Json;
using System.Text;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main()
    {
        Person person = new Person { Name = "John Doe", Age = 30 };
        DataContractJsonSerializer serializer = new DataContractJsonSerializer(typeof(Person));
        using (MemoryStream stream = new MemoryStream())
        {
            serializer.WriteObject(stream, person);
            string json = Encoding.UTF8.GetString(stream.ToArray());
            Console.WriteLine("Serialized JSON using DataContractJsonSerializer:");
            Console.WriteLine(json);
        }
    }
}
using System;
using System.IO;
using System.Runtime.Serialization.Json;
using System.Text;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main()
    {
        Person person = new Person { Name = "John Doe", Age = 30 };
        DataContractJsonSerializer serializer = new DataContractJsonSerializer(typeof(Person));
        using (MemoryStream stream = new MemoryStream())
        {
            serializer.WriteObject(stream, person);
            string json = Encoding.UTF8.GetString(stream.ToArray());
            Console.WriteLine("Serialized JSON using DataContractJsonSerializer:");
            Console.WriteLine(json);
        }
    }
}
Imports System
Imports System.IO
Imports System.Runtime.Serialization.Json
Imports System.Text

Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
End Class

Friend Class Program
	Shared Sub Main()
		Dim person As New Person With {
			.Name = "John Doe",
			.Age = 30
		}
		Dim serializer As New DataContractJsonSerializer(GetType(Person))
		Using stream As New MemoryStream()
			serializer.WriteObject(stream, person)
			Dim json As String = Encoding.UTF8.GetString(stream.ToArray())
			Console.WriteLine("Serialized JSON using DataContractJsonSerializer:")
			Console.WriteLine(json)
		End Using
	End Sub
End Class
$vbLabelText   $csharpLabel

2.2. JavaScriptSerializer

Located in the System.Web.Script.Serialization namespace, this serializer is a part of ASP.NET and provides a simple way to serialize objects to JSON format.

using System;
using System.Web.Script.Serialization;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main()
    {
        Person person = new Person { Name = "John Doe", Age = 30 };
        JavaScriptSerializer serializer = new JavaScriptSerializer();
        string json = serializer.Serialize(person);
        Console.WriteLine("Serialized JSON using JavaScriptSerializer:");
        Console.WriteLine(json);
    }
}
using System;
using System.Web.Script.Serialization;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main()
    {
        Person person = new Person { Name = "John Doe", Age = 30 };
        JavaScriptSerializer serializer = new JavaScriptSerializer();
        string json = serializer.Serialize(person);
        Console.WriteLine("Serialized JSON using JavaScriptSerializer:");
        Console.WriteLine(json);
    }
}
Imports System
Imports System.Web.Script.Serialization

Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
End Class

Friend Class Program
	Shared Sub Main()
		Dim person As New Person With {
			.Name = "John Doe",
			.Age = 30
		}
		Dim serializer As New JavaScriptSerializer()
		Dim json As String = serializer.Serialize(person)
		Console.WriteLine("Serialized JSON using JavaScriptSerializer:")
		Console.WriteLine(json)
	End Sub
End Class
$vbLabelText   $csharpLabel

2.3. Json.NET (Newtonsoft.Json)

Json.NET (Newtonsoft.Json) is a widely used third-party library for JSON serialization in C#. It offers flexibility, performance, and a rich set of features.

using System;
using Newtonsoft.Json;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main()
    {
        Person person = new Person { Name = "John Doe", Age = 30 };
        string json = JsonConvert.SerializeObject(person);
        Console.WriteLine("Serialized JSON using Json.NET (Newtonsoft.Json):");
        Console.WriteLine(json);
    }
}
using System;
using Newtonsoft.Json;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main()
    {
        Person person = new Person { Name = "John Doe", Age = 30 };
        string json = JsonConvert.SerializeObject(person);
        Console.WriteLine("Serialized JSON using Json.NET (Newtonsoft.Json):");
        Console.WriteLine(json);
    }
}
Imports System
Imports Newtonsoft.Json

Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
End Class

Friend Class Program
	Shared Sub Main()
		Dim person As New Person With {
			.Name = "John Doe",
			.Age = 30
		}
		Dim json As String = JsonConvert.SerializeObject(person)
		Console.WriteLine("Serialized JSON using Json.NET (Newtonsoft.Json):")
		Console.WriteLine(json)
	End Sub
End Class
$vbLabelText   $csharpLabel

3. When to Use C# JSON Serializer

Knowing when to employ C# JSON serialization is crucial for efficient and error-free data exchange. Here are common scenarios where using a JSON serializer is beneficial:

3.1. Web APIs

When developing web APIs that communicate with client applications, JSON is a preferred format for data exchange due to its lightweight and human-readable nature.

3.2. Configuration Settings

Storing and reading configuration settings in a JSON format is a common practice. JSON serialization simplifies the process of converting these settings between C# objects and JSON.

3.3. Interoperability

When integrating C# applications with systems developed in other languages, JSON provides a language-agnostic data format, ensuring seamless interoperability.

4. What is a deserialized JSON string?

Deserialization is the process of converting a JSON string back into its equivalent C# object. This is a crucial step when working with data received from external sources, such as web APIs or stored JSON data.

In C#, the same serializers used for serialization can often be employed for deserialization. Let's illustrate deserialization with a simple example using Json.NET (Newtonsoft.Json):

using System;
using Newtonsoft.Json;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main()
    {
        string json = "{\"Name\":\"John Doe\",\"Age\":30}";
        Person deserializedPerson = JsonConvert.DeserializeObject<Person>(json);
        Console.WriteLine("Deserialized Person:");
        Console.WriteLine($"Name: {deserializedPerson.Name}, Age: {deserializedPerson.Age}");
    }
}
using System;
using Newtonsoft.Json;

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main()
    {
        string json = "{\"Name\":\"John Doe\",\"Age\":30}";
        Person deserializedPerson = JsonConvert.DeserializeObject<Person>(json);
        Console.WriteLine("Deserialized Person:");
        Console.WriteLine($"Name: {deserializedPerson.Name}, Age: {deserializedPerson.Age}");
    }
}
Imports System
Imports Newtonsoft.Json

Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
End Class

Friend Class Program
	Shared Sub Main()
		Dim json As String = "{""Name"":""John Doe"",""Age"":30}"
		Dim deserializedPerson As Person = JsonConvert.DeserializeObject(Of Person)(json)
		Console.WriteLine("Deserialized Person:")
		Console.WriteLine($"Name: {deserializedPerson.Name}, Age: {deserializedPerson.Age}")
	End Sub
End Class
$vbLabelText   $csharpLabel

5. Introducing IronPDF in C

Now that we have a solid understanding of C# JSON serialization, let's explore the integration of IronPDF C# Library, a powerful library for working with PDFs in C#. IronPDF simplifies the process of generating and manipulating PDF documents, making it an excellent choice for scenarios where PDFs are involved.

5.1. IronPDF in a Nutshell

IronPDF is a C# library that allows developers to create, manipulate, and render PDF documents within their applications. Whether you need to generate invoices, reports, or any other type of PDF document, IronPDF provides a convenient and feature-rich solution.

IronPDF's HTML to PDF Conversion feature is a highlight, maintaining your layouts and styles. It turns web content into PDFs, suitable for reports, invoices, and documentation. You can convert HTML files, URLs, and HTML strings to PDFs with ease.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert an HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert an HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert a URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert an HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert an HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert a URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert an HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert an HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert a URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class
$vbLabelText   $csharpLabel

To get started with IronPDF, you first need to install the IronPDF NuGet package:

Install-Package IronPdf

Once installed, you can use the IronPDF library to perform various PDF-related tasks in your C# application.

5.2. Using C# JSON Serializer with IronPDF Code

Now, let's explore a practical example of how C# JSON serialization can be seamlessly integrated with IronPDF. Consider a scenario where you have a collection of data that needs to be presented in a PDF report.

The data is initially stored as C# objects and needs to be converted into JSON format before being embedded into the PDF document using IronPDF.

5.3. Example Code

using IronPdf;
using Newtonsoft.Json;
using System.Collections.Generic;

public class ReportData
{
    public string Title { get; set; }
    public string Content { get; set; }
}

public class Program
{
    static void Main()
    {
        var data = new List<ReportData>
        {
            new ReportData { Title = "Section 1", Content = "Lorem ipsum dolor sit amet." },
            new ReportData { Title = "Section 2", Content = "Consectetur adipiscing elit." },
            // Add more data as needed
        };

        // Convert data to JSON format
        string jsonData = JsonConvert.SerializeObject(data);

        // Create a PDF document using IronPDF
        var renderer = new ChromePdfRenderer();

        // Embed JSON data into the PDF
        string htmlContent = $"<html><body><h4>{jsonData}</h4></body></html>";
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save or display the PDF as needed
        pdfDocument.SaveAs("Report.pdf");
    }
}
using IronPdf;
using Newtonsoft.Json;
using System.Collections.Generic;

public class ReportData
{
    public string Title { get; set; }
    public string Content { get; set; }
}

public class Program
{
    static void Main()
    {
        var data = new List<ReportData>
        {
            new ReportData { Title = "Section 1", Content = "Lorem ipsum dolor sit amet." },
            new ReportData { Title = "Section 2", Content = "Consectetur adipiscing elit." },
            // Add more data as needed
        };

        // Convert data to JSON format
        string jsonData = JsonConvert.SerializeObject(data);

        // Create a PDF document using IronPDF
        var renderer = new ChromePdfRenderer();

        // Embed JSON data into the PDF
        string htmlContent = $"<html><body><h4>{jsonData}</h4></body></html>";
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save or display the PDF as needed
        pdfDocument.SaveAs("Report.pdf");
    }
}
Imports IronPdf
Imports Newtonsoft.Json
Imports System.Collections.Generic

Public Class ReportData
	Public Property Title() As String
	Public Property Content() As String
End Class

Public Class Program
	Shared Sub Main()
		Dim data = New List(Of ReportData) From {
			New ReportData With {
				.Title = "Section 1",
				.Content = "Lorem ipsum dolor sit amet."
			},
			New ReportData With {
				.Title = "Section 2",
				.Content = "Consectetur adipiscing elit."
			}
		}

		' Convert data to JSON format
		Dim jsonData As String = JsonConvert.SerializeObject(data)

		' Create a PDF document using IronPDF
		Dim renderer = New ChromePdfRenderer()

		' Embed JSON data into the PDF
		Dim htmlContent As String = $"<html><body><h4>{jsonData}</h4></body></html>"
		Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

		' Save or display the PDF as needed
		pdfDocument.SaveAs("Report.pdf")
	End Sub
End Class
$vbLabelText   $csharpLabel

In this example, the ReportData class represents the data structure for each section in the report. Lista danych zawiera instancje tej klasy.

Dane są serializowane do formatu JSON przy użyciu metody JsonConvert.SerializeObject, a wynikowy ciąg JSON jest osadzany w szablonie HTML. Następnie do konwersji tego szablonu HTML na dokument PDF używa się IronPDF.

5.4. Wynik

C# Json Serializer (How It Works For Developers) Figure 1

6. Podsumowanie

Podsumowując, serializacja JSON w języku C# jest podstawowym narzędziem do obsługi wymiany danych w aplikacjach napisanych w języku C#.

Niezależnie od tego, czy pracujesz z interfejsami API, ustawieniami konfiguracyjnymi, czy integrujesz systemy w innych językach, zrozumienie i wykorzystanie serializacji JSON w języku C# może znacznie zwiększyć wydajność i elastyczność Twoich aplikacji.

Jeśli chodzi o pracę z plikami PDF w języku C#, IronPDF zapewnia solidne rozwiązanie do tworzenia, edycji i renderowania dokumentów PDF.

Łącząc możliwości serializacji JSON w języku C# z biblioteką IronPDF, programiści mogą płynnie integrować dane z obiektów C# z raportami PDF, otwierając nowe możliwości generowania dynamicznej i opartej na danych zawartości PDF w swoich aplikacjach.

W miarę ewolucji świata tworzenia oprogramowania opanowanie tych narzędzi staje się coraz ważniejsze dla budowania solidnych i interoperacyjnych rozwiązań.

IronPDF offers a free trial license, which is a great opportunity to test and familiarize yourself with the C# PDF Library IronPDF Pricing with pricing starting from $799 for the lite version.

Aby dowiedzieć się, jak rozpocząć pracę z IronPDF, odwiedź dokumentację IronPDF.

Często Zadawane Pytania

Jak mogę przekonwertować HTML na PDF w języku C#?

Możesz użyć metody RenderHtmlAsPdf biblioteki IronPDF do konwersji ciągów HTML na pliki PDF. Możesz również konwertować pliki HTML na pliki PDF za pomocą metody RenderHtmlFileAsPdf.

Czym jest serializacja JSON w języku C# i dlaczego jest ważna?

Serializacja JSON w języku C# to proces przekształcania obiektów C# na ich reprezentację JSON, co ma kluczowe znaczenie dla wymiany danych między aplikacjami a systemami zewnętrznymi. To sprawia, że jest to niezbędne narzędzie w takich scenariuszach, jak interfejsy API sieci Web i ustawienia konfiguracyjne.

Jakie są główne dostępne serializatory JSON w języku C#?

Głównymi serializatorami JSON w języku C# są DataContractJsonSerializer, JavaScriptSerializer oraz Json.NET (Newtonsoft.Json), z których każdy oferuje unikalne funkcje dostosowane do różnych zastosowań.

Jak w języku C# można osadzić dane JSON w dokumentach PDF?

Można serializować obiekty C# do formatu JSON, a następnie użyć IronPDF do osadzenia tych danych JSON w dokumentach PDF, wykorzystując jego możliwości renderowania HTML.

Czy mogę przekonwertować ciągi JSON z powrotem na obiekty C#? Jak to zrobić?

Tak, można przekonwertować ciągi JSON z powrotem na obiekty C# poprzez proces zwany deserializacją. Json.NET (Newtonsoft.Json) zapewnia solidne funkcje deserializacji JSON do obiektów C#.

Jaką rolę odgrywa IronPDF w generowaniu plików PDF z JSON w języku C#?

IronPDF pozwala programistom tworzyć pliki PDF poprzez renderowanie treści HTML, która może zawierać dane JSON. Ta integracja jest przydatna do generowania dynamicznych, opartych na danych plików PDF.

Jak zainstalować bibliotekę PDF w projekcie C#?

Bibliotekę PDF można zainstalować w projekcie C#, używając menedżera pakietów NuGet do dodania odpowiedniego pakietu biblioteki, takiego jak IronPDF, do projektu.

W jaki sposób serializacja JSON zwiększa interoperacyjność między systemami?

Serializacja JSON zwiększa interoperacyjność, zapewniając format danych niezależny od języka, który pozwala różnym systemom, potencjalnie opracowanym w różnych językach, na płynną wymianę danych.

Jakie są zalety korzystania z Json.NET do serializacji JSON w języku C#?

Json.NET (Newtonsoft.Json) oferuje elastyczność, wydajność i kompleksowy zestaw funkcji, co czyni go preferowanym wyborem do serializacji JSON w aplikacjach C#.

Jaki jest praktyczny przykład użycia IronPDF z serializacją JSON w C#?

Praktycznym przykładem jest konwersja obiektów C# do formatu JSON i użycie IronPDF do osadzenia tego JSON w dokumencie PDF, tworząc tym samym dynamiczny raport, który można łatwo udostępniać i drukować.

Jacob Mellor, Dyrektor Technologiczny @ Team Iron
Jacob Mellor
  Czat z zespołem inżynierów teraz
Dyrektor ds. technologii

Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczą...

Czytaj więcej

Powiązane artykuły

30-dniowy okres próbny → Pełna wersja produktu. Bez ograniczeń. Bez karty. Bezpłatna próba

Zespol wsparcia Iron

Jestesmy online 24 godziny, 5 dni w tygodniu.
Czat
Email
Zadzwon do mnie