DataTplFixSpecifyDataSource.cs
- //
- // This code is part of Document Solutions for Word demos.
- // Copyright (c) MESCIUS inc. All rights reserved.
- //
- using System;
- using System.IO;
- using System.Drawing;
- using System.Collections.Generic;
- using System.Linq;
- using System.Globalization;
- using GrapeCity.Documents.Word;
-
- namespace DsWordWeb.Demos
- {
- // This example shows how to deal with the 'data source with this name already exists' error.
- public class DataTplFixSpecifyDataSource
- {
- // Code demonstrating the problem:
- GcWordDocument Problem()
- {
- using var oceans = File.OpenRead(Path.Combine("Resources", "data", "oceans.json"));
- using var oceans1 = File.OpenRead(Path.Combine("Resources", "data", "oceans.json"));
- var doc = new GcWordDocument();
- doc.DataTemplate.DataSources.Add("ds", oceans);
- doc.DataTemplate.DataSources.Add("ds1", oceans1);
- // Incorrect: template tag is used without specifying the data source part.
- // It is allowed only if the template engine is able to resolve the tags.
- // But because in this case there are two data sources that both contain a field called 'name',
- // if causes an exception as the tag cannot be resolved:
- doc.Body.Paragraphs.Add("{{name}}");
- doc.DataTemplate.Process(CultureInfo.GetCultureInfo("en-US"));
- return doc;
- }
-
- // Code demonstrating the fix:
- GcWordDocument Fix()
- {
- using var oceans = File.OpenRead(Path.Combine("Resources", "data", "oceans.json"));
- using var oceans1 = File.OpenRead(Path.Combine("Resources", "data", "oceans.json"));
- var doc = new GcWordDocument();
- doc.DataTemplate.DataSources.Add("ds", oceans);
- doc.DataTemplate.DataSources.Add("ds1", oceans1);
- // Correct: use fully qualified data tags so there is no ambiguity:
- doc.Body.Paragraphs.Add("{{ds.name}}");
- doc.DataTemplate.Process(CultureInfo.GetCultureInfo("en-US"));
- return doc;
- }
-
- public GcWordDocument CreateDocx()
- {
- GcWordDocument doc;
- try
- {
- // This fails:
- doc = Problem();
- }
- catch (Exception ex)
- {
- // This works:
- doc = Fix();
- // Insert a brief explanation of the problem and the fix into the generated document:
- doc.Body.Paragraphs.Insert(
- $"The error \"{ex.Message}\" occurred because the data template engine could not unambiguously resolve the data tag " +
- $"that was not fully qualified. " +
- $"The fix is to use fully qualified data tags.",
- doc.Styles[BuiltInStyleId.BlockText],
- InsertLocation.Start);
- }
- return doc;
- }
- }
- }
-