Saved Successfully.
On this page
WebCoreFragments C# Library

Fragment Data Classes

The WebCoreFragments namespace provides the core C# model classes that power all data-driven components in WebCore CMS. These classes represent the structured data returned from a Fragment table query and are consumed inside <wscript> Razor templates at render time.


class FragmentTable WebCoreFragments

FragmentTable is the top-level model object passed into every data-driven component template as Model. It wraps the full result set returned by the CMS query engine for a given Fragment definition, providing the list of rows and supporting metadata.

Properties
Property Type Description
rows List<FragmentRow> The ordered collection of data rows returned from the Fragment table. Check for null before iterating.
defId int The Fragment Definition ID that was queried. Matches the wc-defid attribute on the <webcore> component element.
defName string Human-readable name of the Fragment Definition (e.g. "product-services").
count int Total number of rows returned. Equivalent to Model.rows.Count.
lang string Active language code used to filter localised rows (default: "en").
country string Active country/region code used to filter localised rows (default: "ww").
Usage in a <wscript> Template
Razor / wscript 
@if (Model.rows != null) {
    <p>Showing @Model.count results</p>
    @foreach(WebCoreFragments.FragmentRow df in Model.rows) {
        <div class="item">@df.col("service-title")</div>
    }
}
Always null-check Model.rows before entering a @foreach loop. The CMS sets rows to null (not an empty list) when a component has no matching records.
class FragmentRow WebCoreFragments

FragmentRow represents a single record from the Fragment table. Each iteration of the @foreach loop yields one FragmentRow (conventionally named df). It carries the row's system fields and exposes its column values through the col() and fCol() accessor methods.

System Properties
Property Type Default Description
id int 0 Auto-incremented database row ID. Unique within the Fragment table.
lang string "en" Language code for this row. Supports multi-language Fragment tables where the same logical record has one row per language.
country string "ww" Country/region scope for this row. Use "ww" for worldwide (no regional restriction).
LastUpdate DateTime DateTime.Now Timestamp of the last time this row was saved in the CMS editor. Useful for cache-busting or "updated on" display logic.
Accessor Methods
Method Returns Description
col("column-name") string Returns the plain string value of the named column. Use for STRING, NUMBER, DATE, OPTION, FILE, IMAGE, and UNIQUEKEY column types.
fCol("column-name") FragmentCol Returns the full FragmentCol object for the named column. Required for HTML columns so you can call .value via @Html.Raw().
Examples
Razor / wscript Reading plain string columns 
@foreach(WebCoreFragments.FragmentRow df in Model.rows) {
    <h3>@df.col("service-title")</h3>
    <span>@df.col("service-charges")</span>
    <img src="@df.col("news-image")" class="img-fluid" alt="" />
}
Razor / wscript Reading an HTML column 
@foreach(WebCoreFragments.FragmentRow df in Model.rows) {
    <div class="content">
        @Html.Raw(df.fCol("service-details").value)
    </div>
}
Razor / wscript Grouped output using system fields 
@{ string grp = ""; }
@foreach(WebCoreFragments.FragmentRow df in Model.rows) {
    @if (df.col("section") != grp) {
        @{ grp = df.col("section"); }
        <h4 class="group-header">@grp</h4>
    }
    <div class="feature-row">
        <span>@df.col("feature-name")</span>
        <span>Last edited: @df.LastUpdate.ToString("dd MMM yyyy")</span>
    </div>
}
FragmentCol WebCoreFragments

FragmentCol is the low-level descriptor for a single column within a FragmentRow. It is returned by df.fCol("column-name") and exposes both the column's raw value and its full schema metadata. You will most commonly use FragmentCol to safely render HTML content via @Html.Raw(df.fCol("col").value), or to inspect column options for OPTION-type fields.

Properties
Property Type Description
name string The column's kebab-case identifier as defined in the Fragment Definition (e.g. "service-details").
type string The column's data type token. One of: STRING, HTML, NUMBER, DATE, OPTION, IMAGE, FILE, UNIQUEKEY.

powered by webcore cmx

webcore