API Reference
EmailKeyValueRow
Row definition for EmailKeyValueTable.
Inheritance
- Object
- EmailKeyValueRow
Constructors
public EmailKeyValueRow() #Methods
public EmailKeyValueRow WithBool(Boolean value, String trueText = "Yes", String falseText = "No", EmailStatusTone trueTone = Success, EmailStatusTone falseTone = Danger) #EmailKeyValueRowRenders the value as a compact status (dot + label) without raw HTML.
Parameters
- value System.Boolean
- trueText System.String = "Yes"
- falseText System.String = "No"
- trueTone HtmlForgeX.Email.EmailStatusTone = Success
- falseTone HtmlForgeX.Email.EmailStatusTone = Danger
public EmailKeyValueRow WithBytes(Nullable<Int64> bytes, Int32 decimals = 2, EmailBytesUnitSystem unitSystem = Binary, CultureInfo culture = null) #EmailKeyValueRowFormats a byte-size value into a compact representation (e.g., "2.47 MB").
Parameters
- bytes System.Int64
- decimals System.Int32 = 2
- unitSystem HtmlForgeX.Email.EmailBytesUnitSystem = Binary
- culture System.Globalization.CultureInfo = null
WithBytes(System.Nullable{System.Int64} bytes, System.Int32 decimals, HtmlForgeX.Email.EmailBytesUnitSystem unitSystem, System.Globalization.CultureInfo culture) #Formats a byte-size value into a compact representation (e.g., "2.47 MB").
Parameters
- bytes System.Nullable{System.Int64}
- decimals System.Int32
- unitSystem HtmlForgeX.Email.EmailBytesUnitSystem
- culture System.Globalization.CultureInfo
public EmailKeyValueRow WithCompactNumber(Nullable<Int64> value, Int32 decimals = 1, EmailCompactNumberCase suffixCase = Lower, CultureInfo culture = null) #EmailKeyValueRowFormats a compact number (e.g., "1.2k", "3.4M").
Parameters
- value System.Int64
- decimals System.Int32 = 1
- suffixCase HtmlForgeX.Email.EmailCompactNumberCase = Lower
- culture System.Globalization.CultureInfo = null
WithCompactNumber(System.Nullable{System.Int64} value, System.Int32 decimals, HtmlForgeX.Email.EmailCompactNumberCase suffixCase, System.Globalization.CultureInfo culture) #Formats a compact number (nullable). When the value is null, clears the cell.
Parameters
- value System.Nullable{System.Int64}
- decimals System.Int32
- suffixCase HtmlForgeX.Email.EmailCompactNumberCase
- culture System.Globalization.CultureInfo
public EmailKeyValueRow WithDate(Nullable<DateTimeOffset> value, String format = "MMM d, yyyy", CultureInfo culture = null) #EmailKeyValueRowFormats a date using an email-friendly default.
Parameters
- value System.DateTime
- format System.String = "MMM d, yyyy"
- culture System.Globalization.CultureInfo = null
WithDate(System.Nullable{System.DateTime} value, System.String format, System.Globalization.CultureInfo culture) #Formats a date using an email-friendly default (nullable). When the value is null, clears the cell.
Parameters
- value System.Nullable{System.DateTime}
- format System.String
- culture System.Globalization.CultureInfo
WithDate(System.DateTimeOffset value, System.String format, System.Globalization.CultureInfo culture) #Formats a date using an email-friendly default.
Parameters
- value System.DateTimeOffset
- format System.String
- culture System.Globalization.CultureInfo
WithDate(System.Nullable{System.DateTimeOffset} value, System.String format, System.Globalization.CultureInfo culture) #Formats a date using an email-friendly default (nullable). When the value is null, clears the cell.
Parameters
- value System.Nullable{System.DateTimeOffset}
- format System.String
- culture System.Globalization.CultureInfo
public EmailKeyValueRow WithDateTime(Nullable<DateTimeOffset> value, String format = "MMM d, yyyy · h:mm tt", CultureInfo culture = null) #EmailKeyValueRowFormats a date+time using an email-friendly default.
Parameters
- value System.DateTime
- format System.String = "MMM d, yyyy · h:mm tt"
- culture System.Globalization.CultureInfo = null
WithDateTime(System.Nullable{System.DateTime} value, System.String format, System.Globalization.CultureInfo culture) #Formats a date+time using an email-friendly default (nullable). When the value is null, clears the cell.
Parameters
- value System.Nullable{System.DateTime}
- format System.String
- culture System.Globalization.CultureInfo
WithDateTime(System.DateTimeOffset value, System.String format, System.Globalization.CultureInfo culture) #Formats a date+time using an email-friendly default.
Parameters
- value System.DateTimeOffset
- format System.String
- culture System.Globalization.CultureInfo
WithDateTime(System.Nullable{System.DateTimeOffset} value, System.String format, System.Globalization.CultureInfo culture) #Formats a date+time using an email-friendly default (nullable). When the value is null, clears the cell.
Parameters
- value System.Nullable{System.DateTimeOffset}
- format System.String
- culture System.Globalization.CultureInfo
public EmailKeyValueRow WithDuration(Nullable<TimeSpan> duration, Int32 maxParts = 2) #EmailKeyValueRowFormats a duration into a compact representation (e.g., "1h 30m").
Parameters
- duration System.TimeSpan
- maxParts System.Int32 = 2
WithDuration(System.Nullable{System.TimeSpan} duration, System.Int32 maxParts) #Formats a duration into a compact representation (nullable). When the value is null, clears the cell.
Parameters
- duration System.Nullable{System.TimeSpan}
- maxParts System.Int32
public EmailKeyValueRow WithEmailAddress(String email, String text = null) #EmailKeyValueRowSets value as a mailto link (no raw HTML required).
Parameters
- email System.String
- text System.String = null
public EmailKeyValueRow WithEnum<TEnum>(Nullable<TEnum> value, Boolean humanize = true) #EmailKeyValueRowType Parameters
- TEnum
Parameters
- value TEnum
- humanize Boolean = true
WithEnum``1(``0 value, System.Boolean humanize) #Renders an enum value (optionally humanized) without manual formatting.
Parameters
- value ``0
- humanize System.Boolean
WithEnum``1(System.Nullable{``0} value, System.Boolean humanize) #Renders an enum value (nullable). When the value is null, clears the cell.
Parameters
- value System.Nullable{``0}
- humanize System.Boolean
public EmailKeyValueRow WithHash(String hash, Boolean breakAll = true) #EmailKeyValueRowRenders a hash/checksum in monospace (useful for SHA256/MD5 checksums).
Parameters
- hash System.String
- breakAll System.Boolean = true
public EmailKeyValueRow WithHashCompact(String hash, Int32 head = 12, Int32 tail = 8, String ellipsis = "…") #EmailKeyValueRowRenders a hash/checksum in monospace and truncates the middle for readability.
Parameters
- hash System.String
- head System.Int32 = 12
- tail System.Int32 = 8
- ellipsis System.String = "…"
public EmailKeyValueRow WithId(String id, Boolean breakAll = true) #EmailKeyValueRowRenders an ID-like value in monospace (order IDs, request IDs, etc.).
Parameters
- id System.String
- breakAll System.Boolean = true
public EmailKeyValueRow WithIdCompact(String id, Int32 head = 10, Int32 tail = 6, String ellipsis = "…") #EmailKeyValueRowRenders an ID-like value in monospace and truncates the middle for readability.
Parameters
- id System.String
- head System.Int32 = 10
- tail System.Int32 = 6
- ellipsis System.String = "…"
public EmailKeyValueRow WithIpAddress(String ipAddress) #EmailKeyValueRowRenders an IP address in monospace (typically no aggressive wrapping).
Parameters
- ipAddress System.String
public EmailKeyValueRow WithKey(String key) #EmailKeyValueRowSets key.
Parameters
- key System.String
public EmailKeyValueRow WithLink(String href, String text = null) #EmailKeyValueRowSets value link (href).
Parameters
- href System.String
- text System.String = null
public EmailKeyValueRow WithMoney(Nullable<Decimal> amount, String currencySymbol = "$", Int32 decimals = 2, CultureInfo culture = null) #EmailKeyValueRowFormats a currency value (e.g., "$1,234.50").
Parameters
- amount System.Decimal
- currencySymbol System.String = "$"
- decimals System.Int32 = 2
- culture System.Globalization.CultureInfo = null
WithMoney(System.Nullable{System.Decimal} amount, System.String currencySymbol, System.Int32 decimals, System.Globalization.CultureInfo culture) #Formats a currency value (nullable). When the value is null, clears the cell.
Parameters
- amount System.Nullable{System.Decimal}
- currencySymbol System.String
- decimals System.Int32
- culture System.Globalization.CultureInfo
public EmailKeyValueRow WithMonospace(Boolean breakAll = true) #EmailKeyValueRowRenders value as monospace.
Parameters
- breakAll System.Boolean = true
public EmailKeyValueRow WithNumber(Nullable<Decimal> value, Int32 decimals = 0, CultureInfo culture = null) #EmailKeyValueRowFormats a number (e.g., "1,234.5").
Parameters
- value System.Decimal
- decimals System.Int32 = 0
- culture System.Globalization.CultureInfo = null
WithNumber(System.Nullable{System.Decimal} value, System.Int32 decimals, System.Globalization.CultureInfo culture) #Formats a number (nullable). When the value is null, clears the cell.
Parameters
- value System.Nullable{System.Decimal}
- decimals System.Int32
- culture System.Globalization.CultureInfo
public EmailKeyValueRow WithPercent(Nullable<Decimal> percent, Int32 decimals = 0, CultureInfo culture = null) #EmailKeyValueRowFormats a percent (expects percent units, e.g. 12.3 => "12.3%").
Parameters
- percent System.Decimal
- decimals System.Int32 = 0
- culture System.Globalization.CultureInfo = null
WithPercent(System.Nullable{System.Decimal} percent, System.Int32 decimals, System.Globalization.CultureInfo culture) #Formats a percent (nullable). When the value is null, clears the cell.
Parameters
- percent System.Nullable{System.Decimal}
- decimals System.Int32
- culture System.Globalization.CultureInfo
public EmailKeyValueRow WithPhoneNumber(String phoneNumber, String text = null) #EmailKeyValueRowSets value as a tel link (no raw HTML required).
Parameters
- phoneNumber System.String
- text System.String = null
public EmailKeyValueRow WithRelativeTime(Nullable<DateTimeOffset> when, Nullable<DateTimeOffset> now = null) #EmailKeyValueRowFormats a timestamp relative to now (e.g., "2h ago", "in 3d").
Parameters
- when System.DateTimeOffset
- now System.Nullable{System.DateTimeOffset} = null
WithRelativeTime(System.Nullable{System.DateTimeOffset} when, System.Nullable{System.DateTimeOffset} now) #Formats a timestamp relative to now (nullable). When the value is null, clears the cell.
Parameters
- when System.Nullable{System.DateTimeOffset}
- now System.Nullable{System.DateTimeOffset}
public EmailKeyValueRow WithStatus(String label, EmailStatusTone tone = Neutral, String meta = "", String href = null) #EmailKeyValueRowRenders the value as a compact status (dot + label + optional meta) without raw HTML.
Parameters
- label System.String
- tone HtmlForgeX.Email.EmailStatusTone = Neutral
- meta System.String = ""
- href System.String = null
public EmailKeyValueRow WithTime(Nullable<DateTimeOffset> value, String format = "h:mm tt", CultureInfo culture = null) #EmailKeyValueRowFormats a time using an email-friendly default.
Parameters
- value System.DateTime
- format System.String = "h:mm tt"
- culture System.Globalization.CultureInfo = null
WithTime(System.Nullable{System.DateTime} value, System.String format, System.Globalization.CultureInfo culture) #Formats a time using an email-friendly default (nullable). When the value is null, clears the cell.
Parameters
- value System.Nullable{System.DateTime}
- format System.String
- culture System.Globalization.CultureInfo
WithTime(System.DateTimeOffset value, System.String format, System.Globalization.CultureInfo culture) #Formats a time using an email-friendly default.
Parameters
- value System.DateTimeOffset
- format System.String
- culture System.Globalization.CultureInfo
WithTime(System.Nullable{System.DateTimeOffset} value, System.String format, System.Globalization.CultureInfo culture) #Formats a time using an email-friendly default (nullable). When the value is null, clears the cell.
Parameters
- value System.Nullable{System.DateTimeOffset}
- format System.String
- culture System.Globalization.CultureInfo
public EmailKeyValueRow WithUrl(String url, String text = null) #EmailKeyValueRowSets value as a URL link (no raw HTML required).
Parameters
- url System.String
- text System.String = null
public EmailKeyValueRow WithValue(String value) #EmailKeyValueRowSets value.
Parameters
- value System.String
Inherited Methods
Properties
public String Href { get; set; } #Optional link for the value.
public Boolean ValueMonospace { get; set; } #When true, renders the value in monospace.
public Boolean ValueBreakAll { get; set; } #When true and ValueMonospace is enabled, allows breaking anywhere for long values.
public Nullable<EmailStatusTone> StatusTone { get; set; } #Optional semantic tone for status-like values (dot + label).
public String StatusMeta { get; set; } #Optional secondary status text shown after the label.
IsNullValue #True when the last typed helper received a null and cleared the value. Used by EmailKeyValueTable to optionally skip rows or show placeholders.