Soenneker.Extensions.Object 4.0.4307

Soenneker.Extensions.Object

Reflection-based object projection, query/form encoding, diagnostics, and JSON HttpContent creation.

Installation

dotnet add package Soenneker.Extensions.Object

Build a query string

using Soenneker.Extensions.Object;

string query = new SearchRequest
{
    Page = 2,
    IncludeArchived = false
}.ToQueryString();

// ?page=2&includeArchived=false

ToQueryString() uses readable public instance properties, [JsonPropertyName] or web-default camelCase names, and percent-escapes both names and values. It honors [JsonIgnore] conditions, formats scalar values invariantly, and JSON-formats other values before escaping. A null object or an object with no included values returns an empty string.

ToQueryStringViaReflection() is the simpler legacy path: it uses CLR property names, optionally lowercases them, calls ToString() under the current culture, skips nulls, and escapes names and values. Both methods prepend ? when at least one pair is emitted.

Project properties

Dictionary<string, object?> values = model.ToDictionary();

ToDictionary() includes only readable, non-indexed public properties declared directly on the runtime type. [JsonPropertyName] controls keys; inherited properties are excluded. Values are not serialized or cloned. A null source returns a new empty dictionary.

Create request bodies

using HttpContent json = request.ToHttpContent();
using FormUrlEncodedContent form = request.ToFormUrlEncodedContent();

ToHttpContent() serializes with JsonUtil.WebOptions into application/json; null produces an empty JSON-typed body, not the literal null. ToHttpContentAndString() also returns the serialized text. The WithKey variants add x-api-key to the content headers. The caller owns and must dispose every returned content object.

TryToHttpContent(), TryToHttpContentAndString(), and TryToHttpContentWithKey() return null results and optionally log when conversion fails. They do not log the serialized body, but exception messages may still contain model details.

ToFormUrlEncodedContent() includes readable public properties, honors [JsonPropertyName], skips nulls, formats IFormattable values invariantly, and lets FormUrlEncodedContent perform encoding. Nested objects and collections are converted through ToString() rather than flattened.

Diagnostics and guards

• IsObjectNumeric() recognizes the numeric CLR types defined by the companion type extension; null throws.
• ThrowIfNull() throws ArgumentNullException and uses the calling member name unless a name is supplied.
• LogNullProperties() reports top-level null public properties.
• LogNullPropertiesRecursivelyAsJson() traverses application objects and collections, tracks reference cycles, and logs a JSON tree containing only null locations.
• ToReadableString() recursively renders public properties for human diagnostics.

Reflection getters and custom ToString() implementations can execute user code and throw. Diagnostic output can contain secrets or personal data, and ToReadableString() does not protect against reference cycles; use these helpers only with known model types and appropriate logging destinations.