Repository navigation
Home
George Njeri (Swagfin) edited this page Mar 6, 2026
·
8 revisions
Fast, readable object-to-template mapping for .NET applications.
ObjectSemantics.NET helps you build email, SMS, receipt, invoice, and notification templates from your domain objects with minimal code.
| Guide | Purpose |
|---|---|
| Getting Started | Install, map first template, use options |
| Template Syntax | Placeholders, nested paths, loops, if/else, formatting |
| Calculations |
sum, avg, count, min, max, calc
|
| Recipes | Real-world email/message patterns |
| Troubleshooting | Fix unresolved values, empty outputs, formatting issues |
using ObjectSemantics.NET;
public class QuickCustomer
{
public string Name { get; set; }
}
public class QuickOrder
{
public string Number { get; set; }
public QuickCustomer Customer { get; set; }
public decimal Total { get; set; }
}
var order = new QuickOrder
{
Number = "ORD-1001",
Customer = new QuickCustomer { Name = "Jane Doe" },
Total = 2900m
};
string template = "Order {{ Number }} for {{ Customer.Name }} is {{ Total:N2 }}";
string result = order.Map(template);
// Order ORD-1001 for Jane Doe is 2,900.00- Map direct properties:
{{ Name }} - Map nested properties:
{{ Customer.BankingDetail.BankName }} - Loop collections:
{{ #foreach(Items) }}...{{ #endforeach }} - Evaluate conditions:
{{ #if(IsPaid == true) }}...{{ #endif }} - Format values:
{{ Amount:N2 }},{{ Name:uppercase }} - Run calculations:
{{ __sum(Payments.Amount):N2 }},{{ __calc(PaidAmount - CreditLimit):N2 }}
- Regular unknown placeholders stay unresolved so template authors can see them, for example:
{{ UnknownProp }}. - Calculation expressions (
sum/avg/count/min/max/calc) return empty on invalid or unknown paths. - Null sources/properties in calculation paths return zero.