ES-1042617 Sample changes

Author: DharanyaSakthivel-SF4210

Bookmarks/Get-an-instance-of-bookmark/.NET/Get-an-instance-of-bookmark/Program.cs

@@ -16,7 +16,7 @@ static void Main(string[] args)
                 {
                     //Gets the bookmark instance by using FindByName method of BookmarkCollection with bookmark name.
                     Bookmark bookmark = document.Bookmarks.FindByName("Northwind");
-                    //Accesses the bookmark start’s owner paragraph by using bookmark and changes its back color.
+                    //Accesses the bookmark start's owner paragraph by using the bookmark and changes its back color.
                     bookmark.BookmarkStart.OwnerParagraph.ParagraphFormat.BackColor = Color.AliceBlue;
                     //Creates file stream.
                     using (FileStream outputFileStream = new FileStream(Path.GetFullPath(@"Output/Output.docx"), FileMode.Create, FileAccess.ReadWrite))

Bookmarks/Insert-paragraph-item-into-bookmark/.NET/Insert-paragraph-item-into-bookmark/Program.cs

@@ -24,6 +24,8 @@ static void Main(string[] args)
                     picture.LoadImage(imageStream);
                     picture.WidthScale = 50;
                     picture.HeightScale = 50;
+					//Disposes the image stream
+                    imageStream.Dispose();
                     //Creates file stream.
                     using (FileStream outputFileStream = new FileStream(Path.GetFullPath(@"Output/Output.docx"), FileMode.Create, FileAccess.ReadWrite))
                     {

Bookmarks/Replace-content-with-document-part/.NET/Replace-content-with-document-part/Program.cs

@@ -29,7 +29,7 @@ static void Main(string[] args)
                             bookmarkNavigator = new BookmarksNavigator(document);
                             //Moves the virtual cursor to the location before the end of the bookmark "NorthwindDB".
                             bookmarkNavigator.MoveToBookmark("NorthwindDB");
-                            //Replaces the bookmark content with word body part.
+                            //Replaces the bookmark content with WordDocumentPart.
                             bookmarkNavigator.ReplaceContent(wordDocumentPart);
                             //Close the WordDocumentPart instance.
                             wordDocumentPart.Close();

Fields/Cross-reference/.NET/Cross-reference/Program.cs

@@ -28,7 +28,7 @@ static void Main(string[] args)
                 //Gets the collection of bookmark start in the word document.
                 List<Entity> items = document.GetCrossReferenceItems(ReferenceType.Bookmark);
                 paragraph.AppendText("Bookmark Cross Reference starts here ");
-                //Appends the cross reference for bookmark “Title” with ContentText as reference kind.
+                //Appends the cross reference for bookmark "Title" with ContentText as reference kind.
                 paragraph.AppendCrossReference(ReferenceType.Bookmark, ReferenceKind.ContentText, items[0], true, false, false, string.Empty);
                 //Updates the document Fields.
                 document.UpdateDocumentFields();

Fields/Hide-SEQ-field-result/.NET/Hide-SEQ-field-result/Program.cs

@@ -14,7 +14,7 @@ static void Main(string[] args)
 				//Accesses sequence field in the document.
 				WTable table = document.LastSection.Body.ChildEntities[1] as WTable;
 				WSeqField field = ((table[2, 1].ChildEntities[0] as WParagraph).ChildEntities[0] as WSeqField);
-				//Enables a flag to to hide the sequence field result .
+				//Enables a flag to hide the sequence field result.
 				field.HideResult = true;
 				//Accesses sequence field in the document.
 				field = ((table[4, 1].ChildEntities[0] as WParagraph).ChildEntities[0] as WSeqField);

Mail-Merge/Event-for-image-mail-merge-field/.NET/Event-for-image-mail-merge-field/Program.cs

@@ -18,7 +18,7 @@ static void Main(string[] args)
                     //Specifies the field names and field values.
                     string[] fieldNames = new string[] { "Logo" };
                     string[] fieldValues = new string[] { "Logo.png" };
-                    //Executes the mail merge with groups.
+                    //Executes the mail merge.
                     document.MailMerge.Execute(fieldNames, fieldValues);
                     //Creates file stream.
                     using (FileStream outputStream = new FileStream(Path.GetFullPath(@"Output/Result.docx"), FileMode.Create, FileAccess.ReadWrite))

Mail-Merge/Event-to-bind-data-for-unmerged-fields/.NET/Event-to-bind-data-for-unmerged-fields/Program.cs

@@ -15,9 +15,9 @@ static void Main(string[] args)
                 //Opens the template document.
                 using (WordDocument document = new WordDocument(fileStream, FormatType.Docx))
                 {
-                    //Sets “ClearFields” to true to remove empty mail merge fields from document.
+                    //Sets “ClearFields” to false to keep empty mail merge fields in the document.
                     document.MailMerge.ClearFields = false;
-                    //Uses the mail merge event to clear the unmerged field while perform mail merge execution.
+                    //Uses the mail merge event to clear the unmerged field while performing mail merge execution.
                     document.MailMerge.BeforeClearField += new BeforeClearFieldEventHandler(BeforeClearFieldEvent);
                     //Execute mail merge.
                     document.MailMerge.ExecuteGroup(GetDataTable());

Mail-Merge/Event-to-bind-data-for-unmerged-group/.NET/Event-to-bind-data-for-unmerged-group/Program.cs

@@ -15,13 +15,13 @@ static void Main(string[] args)
                 //Opens the template document.
                 using (WordDocument document = new WordDocument(fileStream, FormatType.Docx))
                 {
-					//Sets “ClearFields” to true to remove empty mail merge fields from document.
+					//Sets “ClearFields” to false to keep empty mail merge fields in the document.
 					document.MailMerge.ClearFields = false;
 					//Uses the mail merge event to clear the unmerged group field while perform mail merge execution.
 					document.MailMerge.BeforeClearGroupField += new BeforeClearGroupFieldEventHandler(BeforeClearFields);
-					//Gets the employee details as “IEnumerable” collection.
+					//Gets the employee details as IEnumerable collection.
 					List<Employees> employeeList = GetEmployees();
-					//Creates an instance of “MailMergeDataTable” by specifying mail merge group name and “IEnumerable” collection.
+					//Creates an instance of MailMergeDataTable by specifying mail merge group name and IEnumerable collection.
 					MailMergeDataTable dataTable = new MailMergeDataTable("Employees", employeeList);
 					//Performs Mail merge
 					document.MailMerge.ExecuteNestedGroup(dataTable);
@@ -47,6 +47,7 @@ private static void BeforeClearFields(object sender, BeforeClearGroupFieldEventA
                 string[] groupName = args.GroupName.Split(':');
                 if (groupName[groupName.Length - 1] == "Orders")
                 {
+					//Gets the field names in the group
                     string[] fields = args.FieldNames;
                     List<OrderDetails> orderList = GetOrders();
                     //Binds the data to the unmerged fields in group as alternative values.

Mail-Merge/Exception-field-not-in-data source/.NET/Exception-field-not-in-data source/Program.cs

@@ -15,7 +15,7 @@ static void Main(string[] args)
                 //Opens the template document.
                 using (WordDocument document = new WordDocument(fileStream, FormatType.Docx))
                 {
-                    //Sets “ClearFields” to true to remove empty mail merge fields from document.
+                    //Sets “ClearFields” to false to keep empty mail merge fields in the document.
                     document.MailMerge.ClearFields = false;
                     //Uses the mail merge event to throw exception if the field is not in the data source.
                     document.MailMerge.BeforeClearField += new BeforeClearFieldEventHandler(BeforeClearFieldEvent);

Mail-Merge/Keep-unmerged-merge-fields/.NET/Keep-unmerged-merge-fields/Program.cs

@@ -13,7 +13,7 @@ static void Main(string[] args)
                 //Opens the template document.
                 using (WordDocument document = new WordDocument(fileStream, FormatType.Docx))
                 {
-                    //Sets “ClearFields” to true to remove empty mail merge fields from document.
+                    //Sets “ClearFields” to false to keep empty mail merge fields in the document.
                     document.MailMerge.ClearFields = false;
                     string[] fieldNames = new string[] { "EmployeeName", "EmployeeId", "City" };
                     string[] fieldValues = new string[] { "John", "101", "London" };