Json.NET (Newtonsoft) – библиотека для работы с форматом JSON

JSON (JavaScript Object Notation)

JSON (JavaScript Object Notation) is a text format used for exchanging data between client-side and server-side applications. It is a lightweight and human-readable format based on the syntax of JavaScript objects. To work with JSON in the C# programming language, you can use the Json.NET library, also known as Newtonsoft.Json.

Json.NET Library

Json.NET is the most popular library for working with JSON in C#. It provides a wide range of functions and offers a simple and efficient way to serialize and deserialize objects into JSON format.

Getting Started with Json.NET in C#

To use Json.NET in C#, you need to add a reference to the Newtonsoft.Json NuGet package. Open the NuGet Package Manager Console in your project and execute the following command:

Install-Package Newtonsoft.Json

After installing the library, you can include the Newtonsoft.Json namespace in your code:

using Newtonsoft.Json;

Serialization with Json.NET

To serialize a C# object into JSON format, you can use the JsonConvert.SerializeObject() method. For example, suppose we have a Person class:

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

We can create an instance of this class and serialize it:

Person person = new Person { Name = "John", Age = 30 };
string json = JsonConvert.SerializeObject(person);

The result will be:

{"Name":"John","Age":30}

Deserialization with Json.NET

To deserialize a JSON string into a C# object, you can use the JsonConvert.DeserializeObject() method. For example, suppose we have a JSON string:

{"Name":"John","Age":30}

We can deserialize it into a Person object:

string json = "{\"Name\":\"John\",\"Age\":30}";
Person person = JsonConvert.DeserializeObject<Person>(json);

Now we have a person object with the Name and Age properties filled.

Customizing Serialization and Deserialization

Json.NET provides options for customizing the serialization and deserialization process using attributes and serializer settings. For example, you can ignore a specific property during serialization:

public class Person
{
    public string Name { get; set; }
    
    [JsonIgnore] // ignore this property during serialization
    public int Age { get; set; }
}

You can also customize date and time formatting, select specific fields for serialization, and much more.

Working with Collections

Json.NET also supports working with collections, including arrays, lists, and dictionaries. You can serialize and deserialize objects that contain these collections without much effort.

Working with Dynamic JSON Objects

Json.NET provides the ability to work with dynamic JSON objects using the JObject class, which allows you to dynamically read and write JSON object properties.

Conclusion

Json.NET is a powerful and convenient library for working with JSON in C#. It provides a simple and efficient way to serialize and deserialize objects into JSON format, and it offers many features for customizing the serialization and deserialization process.