JsonSerializer.Serialize 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)
제공된 작성기에 하나의 JSON 값(개체 또는 배열 포함)을 씁니다.
public:
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> unitPublic Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, context As JsonSerializerContext)매개 변수
- writer
- Utf8JsonWriter
쓰는 데 사용할 JSON 기록기입니다.
- value
- Object
변환하고 쓸 값입니다.
- inputType
- Type
변환할 value의 형식입니다.
- context
- JsonSerializerContext
직렬화 가능한 형식에 대한 메타데이터 공급자입니다.
예외
inputType이 value과 호환되지 않는 경우.
writer 또는 inputType가 null인 경우
inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
제공된 context 의 메서드는 GetTypeInfo(Type) 변환할 형식에 대해 를 반환합니다null.
적용 대상
Serialize(Stream, Object, Type, JsonSerializerContext)
제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 에 씁니다 Stream.
public:
static void Serialize(System::IO::Stream ^ utf8Json, System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static void Serialize (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> unitPublic Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext)매개 변수
- value
- Object
변환할 값입니다.
- inputType
- Type
변환할 value의 형식입니다.
- context
- JsonSerializerContext
직렬화 가능한 형식에 대한 메타데이터 공급자입니다.
예외
inputType이 value과 호환되지 않는 경우.
utf8Json, inputType 또는 context가 null입니다.
inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
적용 대상
Serialize(Stream, Object, Type, JsonSerializerOptions)
제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 에 씁니다 Stream.
public static void Serialize (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions -> unitPublic Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)매개 변수
- value
- Object
변환할 값입니다.
- inputType
- Type
변환할 value의 형식입니다.
- options
- JsonSerializerOptions
변환 동작을 컨트롤하는 옵션입니다.
예외
inputType이 value과 호환되지 않는 경우.
utf8Json 또는 inputType가 null인 경우
inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
적용 대상
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)
제공된 작성기에 하나의 JSON 값(개체 또는 배열 포함)을 씁니다.
public:
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Serialize : System.Text.Json.Utf8JsonWriter * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> unitPublic Sub Serialize (writer As Utf8JsonWriter, value As Object, jsonTypeInfo As JsonTypeInfo)매개 변수
- writer
- Utf8JsonWriter
쓸 작성기입니다.
- value
- Object
변환하고 쓸 값입니다.
- jsonTypeInfo
- JsonTypeInfo
변환할 형식에 대한 메타데이터입니다.
예외
writer 또는 jsonTypeInfo가 null인 경우
value 는 형식 jsonTypeInfo과 일치하지 않습니다.
적용 대상
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)
지정된 형식의 JSON 표현을 제공된 기록기에 씁니다.
public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.JsonSerializerOptions -> unitPublic Shared Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)Public Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)매개 변수
- writer
- Utf8JsonWriter
쓰는 데 사용할 JSON 기록기입니다.
- value
- Object
변환하고 쓸 값입니다.
- inputType
- Type
변환할 value의 형식입니다.
- options
- JsonSerializerOptions
직렬화 동작을 컨트롤하는 옵션입니다.
예외
inputType이 value과 호환되지 않는 경우
writer 또는 inputType가 null인 경우
inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
설명
JsonWriterOptions 의 instance 만드는 데 사용되는 는 Utf8JsonWriter 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , JsonWriterOptions.Indented, JsonWriterOptions.SkipValidation및 JsonWriterOptions.Encoder 는 작성하는 동안 사용됩니다.
자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.
적용 대상
Serialize(Object, Type, JsonSerializerOptions)
지정된 형식의 값을 JSON 문자열로 변환합니다.
public static string Serialize (object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);public static string Serialize (object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : obj * Type * System.Text.Json.JsonSerializerOptions -> stringPublic Shared Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As StringPublic Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String매개 변수
- value
- Object
변환할 값입니다.
- inputType
- Type
변환할 value의 형식입니다.
- options
- JsonSerializerOptions
변환 동작을 컨트롤하는 옵션입니다.
반환
값의 JSON 문자열 표현입니다.
예외
inputType이 value과 호환되지 않는 경우.
inputType이(가) null인 경우
inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
설명
String 구현이 내부적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) 및 SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)도 참조하세요.
자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.
적용 대상
Serialize(Stream, Object, JsonTypeInfo)
제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 에 씁니다 Stream.
public:
static void Serialize(System::IO::Stream ^ utf8Json, System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static void Serialize (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Serialize : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> unitPublic Sub Serialize (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo)매개 변수
- value
- Object
변환할 값입니다.
- jsonTypeInfo
- JsonTypeInfo
변환할 형식에 대한 메타데이터입니다.
예외
utf8Json은 null입니다.
value 는 형식 jsonTypeInfo과 일치하지 않습니다.
적용 대상
Serialize(Object, JsonTypeInfo)
제공된 값을 로 String변환합니다.
public:
static System::String ^ Serialize(System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static string Serialize (object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Serialize : obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> stringPublic Function Serialize (value As Object, jsonTypeInfo As JsonTypeInfo) As String매개 변수
- value
- Object
변환할 값입니다.
- jsonTypeInfo
- JsonTypeInfo
변환할 형식에 대한 메타데이터입니다.
반환
String 값의 표현입니다.
예외
jsonTypeInfo은 null입니다.
value 는 형식 jsonTypeInfo과 일치하지 않습니다.
설명
String 구현이 내부적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. SerializeToUtf8Bytes(Object, JsonTypeInfo) 및 SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)도 참조하세요.
적용 대상
Serialize(Object, Type, JsonSerializerContext)
제공된 값을 로 변환합니다 String.
public:
static System::String ^ Serialize(System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static string Serialize (object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);static member Serialize : obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> stringPublic Function Serialize (value As Object, inputType As Type, context As JsonSerializerContext) As String매개 변수
- value
- Object
변환할 값입니다.
- inputType
- Type
변환할 value의 형식입니다.
- context
- JsonSerializerContext
직렬화 가능한 형식에 대한 메타데이터 공급자입니다.
반환
String 값의 표현입니다.
예외
inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
제공된 context 의 메서드는 GetTypeInfo(Type) 변환할 형식에 대해 를 반환합니다null.
inputType 또는 context가 null인 경우
설명
String 구현에서 내부적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. 및 SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)도 참조하세요SerializeToUtf8Bytes(Object, Type, JsonSerializerContext).
적용 대상
Serialize<TValue>(TValue, JsonSerializerOptions)
제네릭 형식 매개 변수에 지정된 형식의 값을 JSON 문자열로 변환합니다.
public static string Serialize<TValue> (TValue value, System.Text.Json.JsonSerializerOptions? options = default);public static string Serialize<TValue> (TValue value, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> stringPublic Shared Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As StringPublic Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String형식 매개 변수
- TValue
직렬화할 값의 형식입니다.
매개 변수
- value
- TValue
변환할 값입니다.
- options
- JsonSerializerOptions
직렬화 동작을 컨트롤하는 옵션입니다.
반환
값의 JSON 문자열 표현입니다.
예외
TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
설명
String 구현에서 내부적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) 및 SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)도 참조하세요.
자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.
적용 대상
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
제공된 값을 로 변환합니다 String.
public:
generic <typename TValue>
static System::String ^ Serialize(TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static string Serialize<TValue> (TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Serialize : 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> stringPublic Function Serialize(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As String형식 매개 변수
- TValue
직렬화할 값의 형식입니다.
매개 변수
- value
- TValue
변환할 값입니다.
- jsonTypeInfo
- JsonTypeInfo<TValue>
변환할 형식에 대한 메타데이터입니다.
반환
String 값의 표현입니다.
예외
TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
jsonTypeInfo은 null입니다.
설명
String 구현에서 내부적으로 UTF-8을 사용하기 때문에 를 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) 및 SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)도 참조하세요.
적용 대상
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)
제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 에 Stream씁니다.
public static void Serialize<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default);static member Serialize : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions -> unitPublic Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing)형식 매개 변수
- TValue
직렬화할 값의 형식입니다.
매개 변수
- value
- TValue
변환할 값입니다.
- options
- JsonSerializerOptions
변환 동작을 컨트롤하는 옵션입니다.
예외
utf8Json이(가) null인 경우
TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
적용 대상
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 에 Stream씁니다.
public:
generic <typename TValue>
static void Serialize(System::IO::Stream ^ utf8Json, TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static void Serialize<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Serialize : System.IO.Stream * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> unitPublic Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))형식 매개 변수
- TValue
직렬화할 값의 형식입니다.
매개 변수
- value
- TValue
변환할 값입니다.
- jsonTypeInfo
- JsonTypeInfo<TValue>
변환할 형식에 대한 메타데이터입니다.
예외
utf8Json이(가) null인 경우
TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
적용 대상
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
제네릭 형식 매개 변수에 지정된 형식의 JSON 표현을 제공된 기록기에 씁니다.
public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.JsonSerializerOptions? options = default);public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.JsonSerializerOptions -> unitPublic Shared Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)Public Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)형식 매개 변수
- TValue
직렬화할 값의 형식입니다.
매개 변수
- writer
- Utf8JsonWriter
쓰는 데 사용할 JSON 기록기입니다.
- value
- TValue
변환하고 쓸 값입니다.
- options
- JsonSerializerOptions
직렬화 동작을 컨트롤하는 옵션입니다.
예외
writer이(가) null인 경우
TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
설명
JsonWriterOptions 의 instance 만드는 데 사용되는 는 Utf8JsonWriter 충돌할 때 보다 우선 JsonSerializerOptions 합니다. 따라서 , JsonWriterOptions.IndentedJsonWriterOptions.SkipValidation, 및 JsonWriterOptions.Encoder 는 작성하는 동안 사용됩니다.
자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.
적용 대상
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
제공된 작성기에 하나의 JSON 값(개체 또는 배열 포함)을 씁니다.
public:
generic <typename TValue>
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> unitPublic Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))형식 매개 변수
- TValue
직렬화할 값의 형식입니다.
매개 변수
- writer
- Utf8JsonWriter
쓸 작성기입니다.
- value
- TValue
변환하고 쓸 값입니다.
- jsonTypeInfo
- JsonTypeInfo<TValue>
변환할 형식에 대한 메타데이터입니다.
예외
writer 또는 jsonTypeInfo가 null인 경우
TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
적용 대상
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기