菜单
Use when configuring System.Text.Json for ASP.NET Core — JsonOptions.Default with camelCase/no-nulls/no-cycles, ConditionalStringEnumConverter for [StringEnum] enums, MultiFormatDateTimeConverter for flexible date parsing, and PolymorphicJsonConverterFactory for $type discriminator.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when representing optional values explicitly — Maybe<T> as a null-safe container, Maybe.From()/FromTry() for creation, HasValue/HasNoValue, Map/Bind chaining, TapNone for None-side effects, Match for consumption, and ToMaybeResult() to bridge into the Result pattern.
Use when handling operation outcomes without exceptions — Result and Result<T> for success/failure, railway-oriented chaining with Then/ThenAsync/Ensure, Match for consumption, and Result.And/Or for combining multiple results.
Use when composing business validation logic — define rules as classes, Func fields, or inline lambdas; combine with .And()/.Or()/.Linear()/.Next(); evaluate with RuleEngine.Evaluate(); branch with RuleEngine.If().
Use when modeling partial success — These<TError, TValue> holds Left (error only), Right (value only), or Both (error + value), enabling scenarios where a result can partially succeed while carrying warnings. Use FromResult to bridge from Result<T>, ToResult/ToResultLenient to bridge back, and Partition to split collections.
Use when you need testable time — IDateTimeProvider wraps clock access so production code uses DateTimeProvider while tests use the built-in FakeDateTimeProvider to freeze/advance/set the clock; also provides .ToDateOnly() and .ToTimeOnly() DateTime extension methods.
Use when adding cross-cutting pipeline behaviors to CQRS handlers — ValidationBehavior (CSharpEssentials.Validation, throws EnhancedValidationException), LoggingBehavior (ILoggableRequest), ExceptionHandlingBehavior (auto-converts exceptions to Result.Failure for Result-returning handlers), CachingBehavior (ICacheable with IDistributedCache), and TransactionScopeBehavior (ITransactionalRequest).
| name | csharpessentials-json |
| description | Use when configuring System.Text.Json for ASP.NET Core — JsonOptions.Default with camelCase/no-nulls/no-cycles, ConditionalStringEnumConverter for [StringEnum] enums, MultiFormatDateTimeConverter for flexible date parsing, and PolymorphicJsonConverterFactory for $type discriminator. |
Pre-configured System.Text.Json options and converters for common ASP.NET Core patterns.
dotnet add package CSharpEssentials.Json
using CSharpEssentials.Json;
Pre-configured profile: camelCase property names, ignore null values, handle circular references.
// In ASP.NET Core
builder.Services.AddControllers()
.AddJsonOptions(o => o.JsonSerializerOptions.ApplyDefaults());
// Standalone serialization
var json = JsonSerializer.Serialize(obj, JsonOptions.Default);
var obj = JsonSerializer.Deserialize<MyType>(json, JsonOptions.Default);
Serializes enums marked with [StringEnum] (from CSharpEssentials.Enums) as strings, and all other enums as integers.
// In setup
options.Converters.Add(new ConditionalStringEnumConverter());
// [StringEnum] enum → "Shipped" in JSON
// Regular enum → 2 in JSON
Deserializes DateTime / DateTimeOffset from multiple input formats (ISO 8601, custom patterns). Useful when consuming third-party APIs with inconsistent date formats.
options.Converters.Add(new MultiFormatDateTimeConverter());
Enables polymorphic deserialization using a $type discriminator field.
options.Converters.Add(new PolymorphicJsonConverterFactory());
// JSON: { "$type": "Circle", "radius": 5 }
// Deserializes to Circle : Shape
ApplyDefaults() in one place — do not configure JsonSerializerOptions in multiple locationsConditionalStringEnumConverter requires enums to be decorated with [StringEnum] from CSharpEssentials.EnumsPolymorphicJsonConverterFactory requires the discriminator field to be named $type