JSON→C# 타입 매핑
문자열은 string 또는 ISO-8601 일 경우 DateTime, 정수는 long, 소수는 double, 불리는 bool, 객체는 전용 클래스로, 배열은 목록<T>로 변환됩니다. 샘플에 null 값이 있으면 해당 속성이 널 가능 로 표시되며 널 가능 모드에서는 자동으로 ?를 붙입니다. 서로 다른 타입이 섞인 배열은 목록<object>로 다운그레이드되어 모든 페이로드를 안전하게 표현합니다.
Preparing your comprehensive developer toolkit
실용 가이드
JSON 데이터를 강력한 형식의 C# 클래스 코드로 변환하고 JsonPropertyName 특성, 널 가능 참조, 깔끔한 get/set 구문을 자동으로 추가합니다.
REST API, 클라우드 이벤트, 구성 파일, 텔레메트리, 메시지 큐 등 대부분의 .NET 워크로드는 JSON 을 다룹니다. 샘플을 강한 타입의 C# 클래스로 변환하면 컴파일 타임 안전성, 풍부한 IntelliSense, 명확한 도메인 모델, 안전한 리팩토링을 모두 얻을 수 있습니다. JsonPropertyName 으로 원본 키를 유지하면 팀 간 계약도 빠르게 공유할 수 있습니다.
문자열은 string 또는 ISO-8601 일 경우 DateTime, 정수는 long, 소수는 double, 불리는 bool, 객체는 전용 클래스로, 배열은 목록<T>로 변환됩니다. 샘플에 null 값이 있으면 해당 속성이 널 가능 로 표시되며 널 가능 모드에서는 자동으로 ?를 붙입니다. 서로 다른 타입이 섞인 배열은 목록<object>로 다운그레이드되어 모든 페이로드를 안전하게 표현합니다.
재귀적으로 JSON 구조를 탐색하며 동일한 모양의 객체를 하나의 시그니처로 묶어 재사용합니다. 속성 이름은 PascalCase(파스칼 케이스) 로 정규화하고 C# 예약어를 피합니다. 배열은 추론된 요소 타입을 공유하여 중복 클래스를 만들지 않으며, 변환이 끝나면 클래스/속성/배열 개수를 통계로 보여 줍니다.
시스템.텍스트.Json 은 JsonPropertyName 특성으로 키를 찾으므로 snake_case(스네이크 케이스) JSON 도 PascalCase(파스칼 케이스) 속성으로 사용할 수 있습니다. 생성된 클래스는 partial 이므로 사용자 정의 검증이나 컨버터를 별도의 파일에서 추가해도 자동 생성 코드를 훼손하지 않습니다.
널 가능 참조를 활성화하면 샘플에 null 이 등장하는 순간 bool/long/double 같은 값 형식과 string/목록<T>/중첩 클래스와 같은 참조 형식 모두 자동으로 ?가 붙습니다. 컴파일러가 미리 경고하기 때문에 런타임 NullReferenceException 을 크게 줄일 수 있습니다.
C# 친화적인 타입과 중첩 클래스를 자동으로 구성하고 원본 JSON 키를 정확하게 보존합니다.
snake_case(스네이크 케이스) JSON 도 시스템.텍스트.Json 에서 올바르게 역직렬화되도록 속성에 JsonPropertyName 을 부여합니다.
샘플에 null 이 포함되면 즉시 ? 를 추가하여 컴파일 단계에서 null 위험을 알립니다.
변환 직후 클래스/속성/배열 개수를 확인해 모델 복잡도를 파악할 수 있습니다.
JSON에서 C# 클래스 생성은 JSON 데이터 구조에서 강력한 형식의 C# 클래스를 자동으로 만듭니다. .NET 애플리케이션에서 API, 구성 파일 또는 데이터 직렬화 작업 시 필수적입니다. 클래스를 수동으로 작성하거나 동적 형식을 사용하는 대신 생성기는 올바른 형식, 널 가능 지원 및 JsonPropertyName 특성이 있는 적절한 C# 클래스를 만들어 개발 시간을 절약하고 오류를 줄입니다.
생성기는 JSON 형식을 적절한 C# 형식에 매핑합니다: 문자열은 string 또는 DateTime(ISO-8601 날짜의 경우)이 되고, 정수는 long에 매핑되고, 부동 소수점 숫자는 double에 매핑되고, 부울은 bool에 매핑되며, 개체는 전용 클래스가 되고 배열은 목록<T>가 됩니다. null 값은 속성을 널 가능로 표시합니다(널 가능 참조가 활성화된 경우 ? 접미사 포함). 혼합 배열은 목록<object>를 사용하여 이기종 데이터를 보존합니다.
JsonPropertyName 특성을 사용하면 C# 속성이 PascalCase(파스칼 케이스) 명명(C# 규칙)을 사용할 수 있지만 JSON은 다른 명명(snake_case(스네이크 케이스) 또는 camelCase(카멜 케이스) 등)을 사용합니다. 특성은 직렬화/역직렬화 중 원본 JSON 키 이름을 보존합니다. JSON이 비 PascalCase(파스칼 케이스) 키를 사용하지만 코드에서 관용적인 C# 속성 이름을 원하는 경우 이 옵션을 활성화하세요.
널 가능 참조 형식(C# 8.0+)은 참조 형식이 null일 수 있을 때 ?를 추가하여 컴파일 타임 null 검사를 활성화합니다. 활성화되면 생성기는 JSON 샘플에 null 값이 포함된 경우 속성에 ?를 추가합니다. 이는 NullReferenceException 오류를 방지하고, 선택적 필드를 명시적으로 만들며, null 안전성에 대한 최신 C# 모범 사례를 따릅니다.
예, 생성기는 기본적으로 부분 클래스를 생성하므로(또는 활성화된 경우) 생성된 코드를 수정하지 않고 별도 파일에서 확장할 수 있습니다. 사용자 정의 메서드, 유효성 검사 로직, 도메인별 특성을 추가하거나 인터페이스를 구현할 수 있습니다. 이 분리는 생성된 코드를 깨끗하게 유지하고 JSON 구조가 변경될 때 클래스를 안전하게 재생성할 수 있게 합니다.
.NET 기본 JSON 직렬화 라이브러리 공식 문서
JsonPropertyName 특성 사용법
C# 8 이상에서 널 가능 참조형을 활용하는 방법
시스템.텍스트.Json 이 DateTime, DateOnly, 시간대 정보를 처리하는 방식
목록<T> 등 제네릭 컬렉션에 대한 공식 가이드
도구를 열어 이 기능을 사용해 보세요.