Add Chapter 5 Regions

src/Chapter05.Tests/Listing05.04.DeclaringAMethod.Tests.cs

@@ -17,7 +17,7 @@ public void Main_InputInigoMontoya_WriteFullName()
             IntelliTect.TestTools.Console.ConsoleAssert.Expect(view,
             () =>
             {
-                Program.Main();
+                IntroducingMethods.Main();
             });
         }
     }

src/Chapter05.Tests/Listing05.16.ReturningAReference.Tests.cs

@@ -8,10 +8,10 @@ public class ProgramTests
         [TestMethod]
         public void Main_InputInigoMontoya_WriteFullName()
         {
-            string view = @"image\[*\]=Red
+            string expected = @"image\[*\]=Red
 image\[*\]=Black";
 
-            IntelliTect.TestTools.Console.ConsoleAssert.ExpectLike(view,
+            IntelliTect.TestTools.Console.ConsoleAssert.ExpectLike(expected,
             () =>
             {
                 Program.Main();

src/Chapter05/Listing05.01.GroupingStatementsIntoMethods.cs

@@ -1,5 +1,6 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_01
 {
+    #region INCLUDE
     public class LineCount
     {
         public static void Main()
@@ -12,7 +13,7 @@ public static void Main()
             lineCount = CountLines(files);
             DisplayLineCount(lineCount);
         }
-
+        #region EXCLUDE
         private static void DisplayLineCount(int lineCount)
         {
             throw new System.NotImplementedException();
@@ -32,7 +33,7 @@ private static void DisplayHelpText()
         {
             throw new System.NotImplementedException();
         }
-
-        // ...
+        #endregion
     }
+    #endregion
 }

src/Chapter05/Listing05.02.SimpleMethodCall.cs

@@ -1,5 +1,6 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_02
 {
+    #region INCLUDE
     public class HeyYou
     {
         public static void Main()
@@ -10,15 +11,14 @@ public static void Main()
             System.Console.WriteLine("Hey you!");
 
             System.Console.Write("Enter your first name: ");
-            // TODO: Update listing in Manuscript
             firstName = System.Console.ReadLine();
 
             System.Console.Write("Enter your last name: ");
-            // TODO: Update listing in Manuscript
             lastName = System.Console.ReadLine();
 
             System.Console.WriteLine(
                 $"Your full name is { firstName } { lastName }.");
         }
     }
+    #endregion
 }

src/Chapter05/Listing05.03.PassingAMethodReturnAsAParameterToAnotherMehtodCall.cs

@@ -1,12 +1,16 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_03
 {
+    #region INCLUDE
     public class Program
     {
         public static void Main()
         {
             System.Console.Write("Enter your first name: ");
             System.Console.WriteLine("Hello {0}!",
+            #region HIGHLIGHT
                 System.Console.ReadLine());
+            #endregion
         }
     }
+    #endregion
 }

src/Chapter05/Listing05.04.DeclaringAMethod.cs

@@ -1,6 +1,7 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_04
 {
-    public class Program
+    #region INCLUDE
+    public class IntroducingMethods
     {
         public static void Main()
         {
@@ -22,7 +23,6 @@ public static void Main()
         static string GetUserInput(string prompt)
         {
             System.Console.Write(prompt);
-            // TODO: Update listing in Manuscript
             return System.Console.ReadLine() ?? string.Empty;
         }
 
@@ -42,6 +42,6 @@ static string GetInitials(string firstName, string lastName)
         {
             return $"{ firstName[0] }. { lastName[0] }.";
         }
-
     }
+    #endregion
 }

src/Chapter05/Listing05.05.AReturnStatementBeforeTheEndOfAmethod.cs

@@ -1,11 +1,14 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_05
 {
+    #region INCLUDE
     public class Program
     {
+        #region EXCLUDE
         public static void Main()
         {
             System.Console.WriteLine(MyMethod());
         }
+        #endregion
 
         public static bool MyMethod()
         {
@@ -20,9 +23,12 @@ public static bool MyMethod()
             }
         }
 
+        #region EXCLUDE
         private static string ObtainCommand()
         {
             throw new System.NotImplementedException();
         }
+        #endregion
     }
+    #endregion
 }

src/Chapter05/Listing05.06.ReturningMultipleValuesViaTuples.cs

@@ -1,14 +1,16 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_06
 {
+    #region INCLUDE
     public class Program
     {
         static string GetUserInput(string prompt)
         {
             System.Console.Write(prompt);
-            // TODO: Update listing in Manuscript
             return System.Console.ReadLine() ?? string.Empty;
         }
+        #region HIGHLIGHT
         static (string First, string Last) GetName()
+        #endregion
         {
             string firstName, lastName;
             firstName = GetUserInput("Enter your first name: ");
@@ -17,8 +19,11 @@ static string GetUserInput(string prompt)
         }
         static public void Main()
         {
+            #region HIGHLIGHT
             (string First, string Last) name = GetName();
+            #endregion
             System.Console.WriteLine($"Hello { name.First } { name.Last }!");
         }
     }
+    #endregion
 }

src/Chapter05/Listing05.07.UsingDirectiveExample.cs

@@ -1,5 +1,6 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_07
 {
+    #region INCLUDE
     // The using directive imports all types from the 
     // specified namespace into the entire file
     using System;
@@ -10,7 +11,10 @@ public static void Main()
         {
             // No need to qualify Console with System
             // because of the using directive above
+            #region HIGHLIGHT
             Console.WriteLine("Hello, my name is Inigo Montoya");
+            #endregion
         }
     }
+    #endregion
 }

src/Chapter05/Listing05.08.SpecifyingTheUsingDirectiveInsideANamespaceDeclaration.cs

@@ -1,14 +1,20 @@
+#region INCLUDE
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_08
 {
+    #region HIGHLIGHT
     using System;
+    #endregion
 
     public class HelloWorld
     {
         public static void Main()
         {
             // No need to qualify Console with System
             // because of the using directive above
+            #region HIGHLIGHT
             Console.WriteLine("Hello, my name is Inigo Montoya");
+            #endregion
         }
     }
-}
+}
+#endregion

src/Chapter05/Listing05.09.UsingStaticDirective.cs

@@ -1,5 +1,6 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_09
 {
+    #region INCLUDE
     using static System.Console;
 
     public class HeyYou
@@ -12,15 +13,14 @@ public static void Main()
             WriteLine("Hey you!");
 
             Write("Enter your first name: ");
-            // TODO: Update listing in Manuscript
             firstName = ReadLine() ?? string.Empty;
 
             Write("Enter your last name: ");
-            // TODO: Update listing in Manuscript
             lastName = ReadLine() ?? string.Empty;
+
             WriteLine(
                 $"Your full name is { firstName } { lastName }.");
         }
     }
-
+    #endregion
 }

src/Chapter05/Listing05.10.DeclaringATypeAlias.cs

@@ -1,17 +1,23 @@
 #pragma warning disable CS0168 // Variable is declared but never used
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_10
 {
+    #region INCLUDE
     using System;
+    #region HIGHLIGHT
     using System.Threading;
     using CountDownTimer = System.Timers.Timer;
+    #endregion
 
     public class HelloWorld
     {
         public static void Main()
         {
+            #region HIGHLIGHT
             CountDownTimer timer;
+            #endregion
 
             // ...
         }
     }
+    #endregion
 }

src/Chapter05/Listing05.11.DeclaringATypeAliasWithTheSameName.cs

@@ -1,20 +1,26 @@
 #pragma warning disable CS0168 // Variable is declared but never used
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_11
 {
+    #region INCLUDE
     using System;
     using System.Threading;
 
+    #region HIGHLIGHT
     // Declare alias Timer to refer to System.Timers.Timer to
     // avoid code ambiguity with System.Threading.Timer
     using Timer = System.Timers.Timer;
+    #endregion
 
     public class HelloWorld
     {
         public static void Main()
         {
+            #region HIGHLIGHT
             Timer timer;
+            #endregion
 
             // ...
         }
     }
+    #endregion
 }

src/Chapter05/Listing05.12.PassingCommandLineArgumentsToMain.cs

@@ -1,15 +1,19 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_12
 {
-    // TODO: Update listing in Manuscript
+    #region INCLUDE
     using System;
     using System.Net;
 
     public class Program
     {
+        #region HIGHLIGHT
         public static int Main(string[] args)
+        #endregion
         {
+            #region HIGHLIGHT
             int result;
             switch(args.Length)
+            #endregion
             {
                 default:
                     // Exactly two arguments must be specified; give an error
@@ -22,12 +26,18 @@ public static int Main(string[] args)
                     break;
                 case 2:
                     WebClient webClient = new WebClient();
+                    #region HIGHLIGHT
                     webClient.DownloadFile(args[0], args[1]);
+                    #endregion
                     result = 0;
+                    #region HIGHLIGHT
                     break;
+                    #endregion
             }
-
+            #region HIGHLIGHT
             return result;
+            #endregion
         }
     }
+    #endregion
 }

src/Chapter05/Listing05.13.PassingVariablesByValue.cs

@@ -2,6 +2,7 @@ namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_13
 {
     using System;
 
+    #region INCLUDE
     public class Program
     {
         public static void Main()
@@ -28,4 +29,5 @@ static string Combine(
             return path;
         }
     }
+    #endregion
 }

src/Chapter05/Listing05.14.PassingVariablesByReference.cs

@@ -1,24 +1,30 @@
 namespace AddisonWesley.Michaelis.EssentialCSharp.Chapter05.Listing05_14
 {
+    #region INCLUDE
     public class Program
     {
         public static void Main()
         {
             // ...
             string first = "hello";
             string second = "goodbye";
+            #region HIGHLIGHT
             Swap(ref first, ref second);
+            #endregion
 
             System.Console.WriteLine(
                 $@"first = ""{ first }"", second = ""{ second }""");
             // ...
         }
 
+        #region HIGHLIGHT
         static void Swap(ref string x, ref string y)
+        #endregion
         {
             string temp = x;
             x = y;
             y = temp;
         }
     }
+    #endregion
 }