Startseite › Entwickler-Tools › JSON in C#-Klasse

JSON in C#-Klasse

Füge ein JSON-Objekt oder eine API-Antwort ein und erhalte C#-Modellklassen oder Records mit PascalCase-Properties, den passenden numerischen und Nullable-Typen sowie optionalen System.Text.Json- oder Newtonsoft.Json-Attributen. Die Umwandlung läuft komplett in deinem Browser.

Zuletzt aktualisiert:

Dein JSON wird lokal in diesem Tab geparst und nie hochgeladen. Tipp: Strg + Eingabe generiert.

Anzeige
Anzeige

Anleitung: JSON in C#-Klasse

  1. Füge dein JSON in das linke Feld ein oder öffne eine .json-Datei. Ein Beispiel ist geladen, damit du sofort eine Ausgabe siehst.
  2. Benenne die Root-Klasse und lege einen Namespace fest oder leere das Feld, um den Namespace wegzulassen.
  3. Wähle die Optionen: class oder record, Attribut-Bibliothek, Collection-Typ, double oder decimal, Nullable-Referenztypen und DateTime-Erkennung.
  4. Klicke auf C#-Klassen generieren. Mit aktivierter Live-Aktualisierung wird der Code beim Tippen aktualisiert.
  5. Kopiere oder lade die .cs-Datei herunter und deserialisiere mit JsonSerializer.Deserialize<Root>(json).

Beispiel: JSON in eine C#-Klasse

Für {"id": 7, "user_name": "ada", "price": 9.99, "tags": ["new"], "shippedAt": null} erzeugen die Standardoptionen (System.Text.Json, Nullable-Referenztypen):

public class Root
{
    [JsonPropertyName("id")]
    public int Id { get; set; }

    [JsonPropertyName("user_name")]
    public string UserName { get; set; } = string.Empty;

    [JsonPropertyName("price")]
    public double Price { get; set; }

    [JsonPropertyName("tags")]
    public List<string> Tags { get; set; } = new();

    [JsonPropertyName("shippedAt")]
    public object? ShippedAt { get; set; }
}

Deserialisiere es mit var root = JsonSerializer.Deserialize<Root>(json); (System.Text.Json) oder JsonConvert.DeserializeObject<Root>(json) (Newtonsoft.Json).

So werden JSON-Werte auf C#-Typen abgebildet

JSON-WertC#-Typ
"text"string (string?, wenn es null sein oder fehlen kann)
"2024-05-01T09:30:00Z"DateTime (wenn die Datumserkennung aktiviert ist)
42int; long über 2,147,483,647
9.99double oder decimal
truebool (bool?, wenn es null sein oder fehlen kann)
{ … }Eine separate Klasse oder ein Record
{}Dictionary<string, object?>
["a"]List<string>, string[] oder IReadOnlyList<string>
[], gemischte Werte, immer nullobject / List<object>

Tipps für saubere C#-Modelle

  • Verwende decimal für Geldbeträge. double kann 0.1 nicht exakt darstellen, daher sollten Preise und Kontostände decimal sein.
  • Abgleich ohne Groß-/Kleinschreibung. Ohne Attribute gleicht System.Text.Json Property-Namen unter Beachtung der Groß-/Kleinschreibung ab, außer du setzt PropertyNameCaseInsensitive = true oder nutzt JsonSerializerDefaults.Web. Die generierten Attribute vermeiden dieses Problem vollständig.
  • Bevorzuge DateTimeOffset für Zeiten mit Zeitzone. Wenn Zeitstempel einen Offset wie +02:00 enthalten und du ihn behalten musst, ändere DateTime in DateTimeOffset.
  • Verwende echte Beispiele. Füge ein Array mit mehreren Einträgen ein, damit der Generator erkennt, welche Properties optional oder nullable sind.

Häufige Fragen

System.Text.Json- oder Newtonsoft.Json-Attribute?

System.Text.Json ist ab .NET Core 3.0 integriert und der Standard in ASP.NET Core, daher ist [JsonPropertyName("…")] die übliche Wahl. Wähle Newtonsoft.Json, wenn dein Projekt bereits Json.NET verwendet; dann gibt es [JsonProperty("…")]. Die Attribute ordnen jede PascalCase-Property wieder dem exakten JSON-Schlüssel zu, sodass die Deserialisierung unabhängig von der Namensrichtlinie funktioniert.

Klasse oder Record?

Records (ab C# 9) bieten wertbasierte Gleichheit und with-Ausdrücke, und die generierten init-Accessoren machen Objekte nach der Erstellung unveränderlich, was gut zu DTOs und API-Antworten passt. Klassen mit get; set; sind veränderbar und funktionieren mit jeder C#-Version und jedem Serializer.

Wie werden Zahlen typisiert?

Ganze Zahlen werden zu int oder zu long, wenn ein Wert außerhalb des 32-Bit-Bereichs liegt. Zahlen mit Dezimalpunkt oder Exponent werden zu double oder, wenn du es wählst, zu decimal, was für Geldbeträge besser ist. Ein Feld, das ganze und Dezimalzahlen mischt, verwendet den gewählten Dezimaltyp.

Wie werden null und fehlende Werte behandelt?

Werttypen, die in manchen Einträgen null sind oder fehlen, werden nullable, etwa int? oder bool?. Mit aktivierten Nullable-Referenztypen bekommen nullbare Strings, Listen und Klassen ein ?, und nicht nullbare werden initialisiert (string.Empty, new()), damit der Compiler nicht warnt. Aus diesem Grund beginnt die Datei mit #nullable enable.

Wie werden Property-Namen erzeugt?

Schlüssel werden an Unterstrichen, Bindestrichen, Leerzeichen und camelCase-Grenzen in Wörter zerlegt und in PascalCase zusammengefügt, sodass avatar_url zu AvatarUrl und email-notifications zu EmailNotifications wird. Ein Schlüssel, der dem Klassennamen entsprechen würde, erhält das Suffix Value, weil C# kein Member mit demselben Namen wie sein Typ erlaubt.

Was wird aus einem Array oder einem gemischten Wert?

Ein Array von Objekten wird zu einer List einer Klasse, die aus allen Einträgen zusammengeführt wird. Ein leeres Array wird zu List<object>, und Werte mit gemischten Typen (zum Beispiel Zahlen und Strings) werden zu object, weil C# keine Union-Typen kennt.

Wird mein JSON hochgeladen?

Nein. Alles passiert per JavaScript auf dieser Seite, dein JSON verlässt also nie dein Gerät.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Daten- & Dateiformat-Konverter ansehen →