JsonSerializer.Serialize メソッド

定義

オーバーロード

Serialize(Object, Type, JsonSerializerOptions)

指定した型の値を JSON 文字列に変換します。

Serialize(Object, Type, JsonSerializerContext)

指定した値を に変換します String

Serialize(Stream, Object, Type, JsonSerializerOptions)

指定された値を UTF-8 でエンコードされた JSON テキストに変換し、 に書き込む Stream

Serialize(Stream, Object, Type, JsonSerializerContext)

指定された値を UTF-8 でエンコードされた JSON テキストに変換し、 に書き込む Stream

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

指定された型の JSON 表現を指定されたライターに書き込みます。

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

指定されたライターに 1 つの 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, JsonSerializerOptions)

ジェネリック型パラメーターで指定された型の JSON 表現を指定されたライターに書き込みます。

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

指定されたライターに 1 つの 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 -> string
Public Shared Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As 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 文字列表現。

例外

inputTypevalue と互換性がありません。

inputTypenullです。

inputType またはそのシリアル化可能なメンバーに対して互換性のある JsonConverter はありません。

注釈

実装では内部的に UTF-8 が使用されるので、 の使用は UTF-8 エンコードを使用するほど String 効率的ではありません。 SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) および SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken) も参照してください。

詳細については、「JSON をシリアル化および逆シリアル化する方法」を参照してください。

適用対象

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 -> string
Public Function Serialize (value As Object, inputType As Type, context As JsonSerializerContext) As String

パラメーター

value
Object

変換する値。

inputType
Type

変換対象の value の型。

context
JsonSerializerContext

シリアル化可能な型のメタデータ プロバイダー。

戻り値

String

String の表現。

例外

inputType またはそのシリアル化可能なメンバーに対して互換性のある JsonConverter はありません。

指定 GetTypeInfo(Type) された の メソッド context は、変換 null する型に対して を返します。

inputType または contextnull です。

注釈

実装では内部的に UTF-8 が使用されるので、 の使用は UTF-8 エンコードを使用するほど効率的 String ではありません。 および も SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) 参照してください SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)

適用対象

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 -> unit
Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)

パラメーター

utf8Json
Stream

書き込 Stream みする UTF-8。

value
Object

変換する値。

inputType
Type

変換対象の value の型。

options
JsonSerializerOptions

変換動作を制御するオプション。

例外

inputTypevalue と互換性がありません。

utf8Json または inputTypenull です。

または シリアル化可能 JsonConverterinputType メンバーに互換性がありません。

適用対象

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 -> unit
Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext)

パラメーター

utf8Json
Stream

書き込 Stream みする UTF-8。

value
Object

変換する値。

inputType
Type

変換対象の value の型。

context
JsonSerializerContext

シリアル化可能な型のメタデータ プロバイダー。

例外

inputTypevalue と互換性がありません。

utf8JsoninputType、または contextnull です。

または シリアル化可能 JsonConverterinputType メンバーに互換性がありません。

適用対象

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

シリアル化動作を制御するオプション。

例外

inputTypevalue と互換性がありません

writer または inputTypenull です。

inputType またはそのシリアル化可能なメンバーに対して互換性のある JsonConverter はありません。

注釈

JsonWriterOptions インスタンスを作成するために使用される は Utf8JsonWriter 、競合する場合に JsonSerializerOptions よりも優先されます。 そのため JsonWriterOptions.Indented 、、、 JsonWriterOptions.SkipValidation および は JsonWriterOptions.Encoder 書き込み中に使用されます。

詳細については、「JSON をシリアル化および逆シリアル化する方法」を参照してください。

適用対象

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

指定されたライターに 1 つの 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

シリアル化可能な型のメタデータ プロバイダー。

例外

inputTypevalue と互換性がありません。

writer または inputTypenull です。

inputType またはそのシリアル化可能なメンバーに対して互換性のある JsonConverter はありません。

指定 GetTypeInfo(Type) された の メソッド context は、変換 null する型に対して を返します。

適用対象

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 -> string
Public Shared Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String
Public Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String

型パラメーター

TValue

シリアル化する値の型。

パラメーター

value
TValue

変換する値。

options
JsonSerializerOptions

シリアル化動作を制御するオプション。

戻り値

String

値の JSON 文字列表現。

例外

TValue またはそのシリアル化可能なメンバーに対して互換性のある JsonConverter はありません。

注釈

実装では内部的に UTF-8 が使用されるので、 の使用は UTF-8 エンコードを使用するほど String 効率的ではありません。 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> -> string
Public Function Serialize(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As String

型パラメーター

TValue

シリアル化する値の型。

パラメーター

value
TValue

変換する値。

jsonTypeInfo
JsonTypeInfo<TValue>

変換する型に関するメタデータ。

戻り値

String

String の表現。

例外

TValue またはそのシリアル化可能なメンバーに対して互換性のある JsonConverter はありません。

jsonTypeInfonullです。

注釈

実装では内部的に UTF-8 が使用されるので、 の使用は UTF-8 エンコードを使用するほど String 効率的ではありません。 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 -> unit
Public Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing)

型パラメーター

TValue

シリアル化する値の型。

パラメーター

utf8Json
Stream

書き込 Stream みする UTF-8。

value
TValue

変換する値。

options
JsonSerializerOptions

変換動作を制御するオプション。

例外

utf8Jsonnullです。

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> -> unit
Public Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))

型パラメーター

TValue

シリアル化する値の型。

パラメーター

utf8Json
Stream

書き込 Stream みする UTF-8。

value
TValue

変換する値。

jsonTypeInfo
JsonTypeInfo<TValue>

変換する型に関するメタデータ。

例外

utf8Jsonnullです。

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

シリアル化動作を制御するオプション。

例外

writernullです。

TValue またはそのシリアル化可能なメンバーに対して互換性のある JsonConverter はありません。

注釈

JsonWriterOptions インスタンスを作成するために使用される は Utf8JsonWriter 、競合する場合に JsonSerializerOptions よりも優先されます。 そのため JsonWriterOptions.Indented 、、、 JsonWriterOptions.SkipValidation および は JsonWriterOptions.Encoder 書き込み中に使用されます。

詳細については、「JSON をシリアル化および逆シリアル化する方法」を参照してください。

適用対象

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

指定されたライターに 1 つの 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

シリアル化する値の型。

パラメーター

writer
Utf8JsonWriter

書き込むライター。

value
TValue

変換して書き込む値。

jsonTypeInfo
JsonTypeInfo<TValue>

変換する型に関するメタデータ。

例外

writer または jsonTypeInfonull です。

TValue またはそのシリアル化可能なメンバーに対して互換性のある JsonConverter はありません。

適用対象