JsonSerializer.Serialize 메서드

정의

네임스페이스:

System.Text.Json

어셈블리:

System.Text.Json.dll

오버로드

Serialize(Stream, Object, Type, JsonSerializerContext)	제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)	제공된 작성기에 하나의 JSON 값(개체 또는 배열 포함)을 씁니다.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)	지정된 형식의 JSON 표현을 제공된 작성기에 씁니다.
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)	제공된 작성기에 하나의 JSON 값(개체 또는 배열 포함)을 씁니다.
Serialize(Stream, Object, Type, JsonSerializerOptions)	제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.
Serialize(Object, Type, JsonSerializerOptions)	지정된 형식의 값을 JSON 문자열로 변환합니다.
Serialize(Stream, Object, JsonTypeInfo)	제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.
Serialize(Object, JsonTypeInfo)	제공된 값을 String변환합니다.
Serialize(Object, Type, JsonSerializerContext)	제공된 값을 String변환합니다.
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)	제네릭 형식 매개 변수로 지정된 형식의 JSON 표현을 제공된 작성기에 씁니다.
Serialize<TValue>(TValue, JsonSerializerOptions)	제네릭 형식 매개 변수로 지정된 형식의 값을 JSON 문자열로 변환합니다.
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)	제공된 값을 String변환합니다.
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)	제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)	제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)	제공된 작성기에 하나의 JSON 값(개체 또는 배열 포함)을 씁니다.

Serialize(Stream, Object, Type, JsonSerializerContext)

Source:

JsonSerializer.Write.Stream.cs

제공된 값을 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 -> unit

Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext)

매개 변수

utf8Json

Stream

쓸 UTF-8 Stream.

value

Object

변환할 값입니다.

inputType

Type

변환할 value 형식입니다.

context

JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

예외

ArgumentException

inputType value호환되지 않습니다.

ArgumentNullException

utf8Json, inputType또는 contextnull.

NotSupportedException

inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Source:

JsonSerializer.Write.Utf8JsonWriter.cs

제공된 작성기에 하나의 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 -> unit

Public Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, context As JsonSerializerContext)

매개 변수

writer

Utf8JsonWriter

쓸 JSON 작성기입니다.

value

Object

변환하고 쓸 값입니다.

inputType

Type

변환할 value 형식입니다.

context

JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

예외

ArgumentException

inputType value호환되지 않습니다.

ArgumentNullException

writer 또는 inputTypenull.

NotSupportedException

inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

InvalidOperationException

제공된 contextGetTypeInfo(Type) 메서드는 변환할 형식에 대한 null 반환합니다.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Source:

JsonSerializer.Write.Utf8JsonWriter.cs

지정된 형식의 JSON 표현을 제공된 작성기에 씁니다.

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 -> unit

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

serialization 동작을 제어하는 옵션입니다.

예외

ArgumentException

inputType value 호환되지 않습니다.

ArgumentNullException

writer 또는 inputTypenull.

NotSupportedException

inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

설명

Utf8JsonWriter 인스턴스를 만드는 데 사용되는 JsonWriterOptions 충돌할 때 JsonSerializerOptions 우선합니다. 따라서 JsonWriterOptions.Indented, JsonWriterOptions.SkipValidation및 JsonWriterOptions.Encoder 작성하는 동안 사용됩니다.

자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

Source:

JsonSerializer.Write.Utf8JsonWriter.cs

제공된 작성기에 하나의 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 -> unit

Public Sub Serialize (writer As Utf8JsonWriter, value As Object, jsonTypeInfo As JsonTypeInfo)

매개 변수

writer

Utf8JsonWriter

쓸 작성기입니다.

value

Object

변환하고 쓸 값입니다.

jsonTypeInfo

JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

예외

ArgumentNullException

writer 또는 jsonTypeInfonull.

InvalidCastException

value jsonTypeInfo유형과 일치하지 않습니다.

Serialize(Stream, Object, Type, JsonSerializerOptions)

Source:

JsonSerializer.Write.Stream.cs

제공된 값을 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 -> unit

Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)

매개 변수

utf8Json

Stream

쓸 UTF-8 Stream.

value

Object

변환할 값입니다.

inputType

Type

변환할 value 형식입니다.

options

JsonSerializerOptions

변환 동작을 제어하는 옵션입니다.

예외

ArgumentException

inputType value호환되지 않습니다.

ArgumentNullException

utf8Json 또는 inputTypenull.

NotSupportedException

inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

Serialize(Object, Type, JsonSerializerOptions)

Source:

JsonSerializer.Write.String.cs

지정된 형식의 값을 JSON 문자열로 변환합니다.

public static string Serialize (object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

static member Serialize : obj * Type * System.Text.Json.JsonSerializerOptions -> string

Public Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String

매개 변수

value

Object

변환할 값입니다.

inputType

Type

변환할 value 형식입니다.

options

JsonSerializerOptions

변환 동작을 제어하는 옵션입니다.

반환

String

값의 JSON 문자열 표현입니다.

예외

ArgumentException

inputType value호환되지 않습니다.

ArgumentNullException

inputType null.

NotSupportedException

inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

설명

구현에서 UTF-8을 내부적으로 사용하기 때문에 String 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) 및 SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)참조하세요.

자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.

Serialize(Stream, Object, JsonTypeInfo)

Source:

JsonSerializer.Write.Stream.cs

제공된 값을 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 -> unit

Public Sub Serialize (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo)

매개 변수

utf8Json

Stream

쓸 UTF-8 Stream.

value

Object

변환할 값입니다.

jsonTypeInfo

JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

예외

ArgumentNullException

utf8Json null.

InvalidCastException

value jsonTypeInfo유형과 일치하지 않습니다.

Serialize(Object, JsonTypeInfo)

Source:

JsonSerializer.Write.String.cs

제공된 값을 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 -> string

Public Function Serialize (value As Object, jsonTypeInfo As JsonTypeInfo) As String

매개 변수

value

Object

변환할 값입니다.

jsonTypeInfo

JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

반환

String

값의 String 표현입니다.

예외

ArgumentNullException

jsonTypeInfo null.

InvalidCastException

value jsonTypeInfo유형과 일치하지 않습니다.

설명

구현에서 UTF-8을 내부적으로 사용하기 때문에 String 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. SerializeToUtf8Bytes(Object, JsonTypeInfo) 및 SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)참조하세요.

Serialize(Object, Type, JsonSerializerContext)

Source:

JsonSerializer.Write.String.cs

제공된 값을 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 -> string

Public Function Serialize (value As Object, inputType As Type, context As JsonSerializerContext) As String

매개 변수

value

Object

변환할 값입니다.

inputType

Type

변환할 value 형식입니다.

context

JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

반환

String

값의 String 표현입니다.

예외

NotSupportedException

inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

InvalidOperationException

제공된 contextGetTypeInfo(Type) 메서드는 변환할 형식에 대한 null 반환합니다.

ArgumentNullException

inputType 또는 contextnull.

설명

구현은 내부적으로 UTF-8을 사용하기 때문에 String 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) 및 SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)참조하세요.

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

Source:

JsonSerializer.Write.Utf8JsonWriter.cs

제네릭 형식 매개 변수로 지정된 형식의 JSON 표현을 제공된 작성기에 씁니다.

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 -> unit

Public Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

writer

Utf8JsonWriter

쓸 JSON 작성기입니다.

value

TValue

변환하고 쓸 값입니다.

options

JsonSerializerOptions

serialization 동작을 제어하는 옵션입니다.

예외

ArgumentNullException

writer null.

NotSupportedException

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

설명

Utf8JsonWriter 인스턴스를 만드는 데 사용되는 JsonWriterOptions 충돌할 때 JsonSerializerOptions 우선합니다. 따라서 JsonWriterOptions.Indented, JsonWriterOptions.SkipValidation및 JsonWriterOptions.Encoder 작성하는 동안 사용됩니다.

자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.

Serialize<TValue>(TValue, JsonSerializerOptions)

Source:

JsonSerializer.Write.String.cs

제네릭 형식 매개 변수로 지정된 형식의 값을 JSON 문자열로 변환합니다.

public static string Serialize<TValue> (TValue value, System.Text.Json.JsonSerializerOptions? options = default);

static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> string

Public Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

value

TValue

변환할 값입니다.

options

JsonSerializerOptions

serialization 동작을 제어하는 옵션입니다.

반환

String

값의 JSON 문자열 표현입니다.

예외

NotSupportedException

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

설명

구현에서 UTF-8을 내부적으로 사용하기 때문에 String 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) 및 SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)참조하세요.

자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.

Serialize<TValue>(TValue, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Write.String.cs

제공된 값을 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> -> string

Public Function Serialize(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As String

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

value

TValue

변환할 값입니다.

jsonTypeInfo

JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

반환

String

값의 String 표현입니다.

예외

NotSupportedException

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

ArgumentNullException

jsonTypeInfo null.

설명

구현에서 UTF-8을 내부적으로 사용하기 때문에 String 사용하는 것은 UTF-8 인코딩을 사용하는 것만큼 효율적이지 않습니다. SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) 및 SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)참조하세요.

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Source:

JsonSerializer.Write.Stream.cs

제공된 값을 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 -> unit

Public Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing)

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

utf8Json

Stream

쓸 UTF-8 Stream.

value

TValue

변환할 값입니다.

options

JsonSerializerOptions

변환 동작을 제어하는 옵션입니다.

예외

ArgumentNullException

utf8Json null.

NotSupportedException

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Write.Stream.cs

제공된 값을 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> -> unit

Public Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

utf8Json

Stream

쓸 UTF-8 Stream.

value

TValue

변환할 값입니다.

jsonTypeInfo

JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

예외

ArgumentNullException

utf8Json null.

NotSupportedException

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Write.Utf8JsonWriter.cs

제공된 작성기에 하나의 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> -> unit

Public Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

writer

Utf8JsonWriter

쓸 작성기입니다.

value

TValue

변환하고 쓸 값입니다.

jsonTypeInfo

JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

예외

ArgumentNullException

writer 또는 jsonTypeInfonull.

NotSupportedException

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.