For this particular approach to building a document generation system, I am planning on the following:<\/p>\n
- \n
- The document generation process will first process the document template and generate a new C# program<\/strong>.<\/li>\n
- After generating the new program, the document generation process will compile the new program, and then run it<\/strong>, which will then generate all documents for this document generation run.<\/li>\n
- There are, of course, pros and cons to this approach. I\u2019ll mention some of them as I go along.<\/li>\n<\/ul>\n
The generated code will be a combination of:<\/p>\n
- \n
- Code to create the Open XML SDK package, and to create an in-memory clone of the template document.<\/li>\n
- LINQ to XML code to update the contents of the main document part in the package. I\u2019ll have more to say about this in the next post. I\u2019m going to write a pure functional transformation from am XML tree to C# code to create the tree. The generated code will use functional construction, not a DOM style approach.<\/li>\n
- Code extracted from the template document and inserted at appropriate places so that it generates the proper WordprocessingML markup. The code to extract the content of the content controls, and include the content control code in the appropriate places. This will be just a few lines of code.<\/li>\n<\/ul>\n
This sounds more complicated than it is. In upcoming posts, I\u2019ll walk through how the code works in detail.\u00a0 Also, when completed, this example will be super-easy to run.\u00a0 It will be educational to play around with code in the content controls to generate a wide variety of documents.<\/p>\n
I have further refined the C# code that the template designer will write inside of content controls. In addition to that refinement, I have added four more content controls where it doesn\u2019t matter where the template designer places them in the document. These content controls contain code that we need to make the process work \u2013 they don\u2019t contain code directly associated with generating content.<\/p>\n
The Generated Program Structure<\/h1>\n
Before discussing the code in the various content controls, I want to discuss the structure of the generated program. There will be a class named Generator<\/strong>, which will be generated in the code generation process. This class will have a couple of properties or fields, and will have one method (beyond the constructor). There will one instance of this class for each generated document.<\/p>\n
The code in the Value<\/strong>, Table<\/strong>, and Conditional<\/strong> content controls executes in the context of an instance of the Generator<\/strong> class. Therefore, the code can access instance fields and properties.<\/p>\n
New Version of the Template Document<\/h1>\n
First, I\u2019ll examine the new version of the template document. The titles of the content controls are the same, but the code inside is different from the last post. As before, there are the Value <\/strong>content controls that contain values to be inserted into the document.\u00a0 I agree with feedback that Svetlin provided<\/a> \u2013 the value derived from this content control will use the formatting of the underlying run or paragraph.\u00a0 No need to specify a style.<\/p>\n
The following code accesses an instance property of the Generator<\/strong> class.\u00a0 The instance property is Cust<\/strong>.<\/p>\n
![\"image\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/image_thumb5.png\" "\\"image\\"")
<\/a><\/p>\nThe Table<\/strong> content control looks about the same as in the last post, except that it is now written to access fields in the Generator<\/strong> object:<\/p>\n
![\"image\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/image_thumb6.png\" "\\"image\\"")
<\/a><\/p>\nSame thing with Conditional<\/strong> \u2013 it can access the Cust<\/strong> instance property.<\/p>\n
![\"image\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/image_thumb7.png\" "\\"image\\"")
<\/a><\/p>\nThe design of the Ask<\/strong> content control is the same as in the last iteration of this template document:<\/p>\n
![\"image\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/image_thumb8.png\" "\\"image\\"")
<\/a><\/p>\nThere are four new content controls in this template that enable the template designer to write the necessary code so that the document generation process can generate a C# program that is complete and can compile:<\/p>\n
- \n
- Using<\/li>\n
- Classes<\/li>\n
- GeneratorMembers<\/li>\n
- GeneratorMain<\/li>\n<\/ul>\n
The Using <\/strong>content control contains the using <\/strong>statements for the generated program. The generated program may be so simple that it only uses LINQ to XML, as in the example I\u2019m working up. However, it could be more interesting \u2013 it might access an OData feed. It might connect to any arbitrary database or web service. It can connect to any data source that you can get to with .NET. Therefore, we need the ability to specify the using <\/strong>statements for the generated program:<\/p>\n
![\"image\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/image_thumb9.png\" "\\"image\\"")
<\/a><\/p>\nThe Classes<\/strong> content control enables the template designer to define some classes that contain the data that the program reads from the data source.\u00a0 In this first example, there is a Customer <\/strong>class and an Order <\/strong>class:<\/p>\n
![\"image\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/image_thumb10.png\" "\\"image\\"")
<\/a><\/p>\nThe GeneratorMembers <\/strong>content control enables the template designer to specify members of the Generator <\/strong>class.\u00a0 This field contains the customer that a particular Generator <\/strong>object is generating a document for.<\/p>\n
![\"image\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/image_thumb11.png\" "\\"image\\"")
<\/a><\/p>\nLast, but not least, there will be the GeneratorMain <\/strong>content control, which contains the code that will go in the Main <\/strong>method in the generated program:<\/p>\n
- After generating the new program, the document generation process will compile the new program, and then run it<\/strong>, which will then generate all documents for this document generation run.<\/li>\n
![\"image\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/image_thumb12.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/image_thumb13.png\" "\\"image\\"")
<\/a><\/p>\n![\"Smile\"](\"https:\/\/www.ericwhite.com\/blog\/wp-content\/uploads\/2011\/02\/wlEmoticon-smile.png\")
<\/p>\n","protected":false},"excerpt":{"rendered":"