Loops

To repeat document content for each item in a collection the loop syntax can be used: {{#<collection>}} .. content .. {{<collection>}} All document content between the start and end tag is rendered for each element in the collection.

{{#Items}} This text {{Items.Name}} is rendered for each element in the items collection {{/items}}

This can be used, for example, to bind a collection to a table. In this case, the start and end tag has to be placed in the row of the table

This template bound to a model:

            var template = DocxTemplate.Open("template.docx");
            var model = new
            {
                Items = new[]
                {
                    new { Name = "John", Position = "Developer" },
                    new { Name = "Alice", Position = "CEO" }
                }
            };
            template.BindModel("ds", model);
            template.Save("generated.docx");

will render a table row for each item in the collection

Conditional Blocks

Show or hide a given section depending on a condition: {{<condition>}} .. content .. {{/}} All document content between the start and end tag is rendered only if the condition is met

{{Item.Value >= 0}}Only visible if value is >= 0 {{/}}
{{Item.Value < 0}}Otherwise this text is shown{{/}}

Formatters

If no formatter is specified, the model value is converted into a text with "ToString".

This is not sufficient for all data types. That is why there are formatters that convert text or binary data into the desired representation

The formatter name is always case insensitive

String Formatters

• ToUpper, ToLower

FormatPatterns

Any type that implements IFormattable can be formatted with the net formatter strings

See: Standard date and time format strings Standard numeric format strings .. and many more

Examples: {{SomeDate}:format(d)} ----> "6/15/2009" (en-US) {{SomeDouble}:format(f2)} ----> "1234.42" (en-US)

Image Formatter

NOTE: for the Image formatter the nuget package DocxTemplater.Images is required

Because the image formatter is not standard, it must be added

var docTemplate = new DocxTemplate(fileStream);
docTemplate.RegisterFormatter(new ImageFormatter());

The image formatter replaces a placeholder with an image stored in a byte array

The placeholder can be placed in a TextBox so that the end user can easily adjust the image size in the template. The size of the image is then adapted to the size of the TextBox.

The stretching behavior can be configured