Merge pull request #34174 from wwlpublish/d4c4770ba475142d0bf6d08265e84974-live

v-ccolin · web-flow · commit 5c46a001c209 · 2023-04-26T08:20:47.000+01:00
Modules/M02-convert-data-types-using-casting-conversion-techniques-c-sharp
diff --git a/learn-pr/wwl-language/csharp-convert-cast/1-introduction.yml b/learn-pr/wwl-language/csharp-convert-cast/1-introduction.yml
@@ -4,7 +4,7 @@ title: Introduction
 metadata:
   title: Introduction
   description: "Introduction"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-language/csharp-convert-cast/2-exercise-data-type-conversion.yml b/learn-pr/wwl-language/csharp-convert-cast/2-exercise-data-type-conversion.yml
@@ -4,7 +4,7 @@ title: Exercise - Explore data type casting and conversion
 metadata:
   title: Exercise - Explore data type casting and conversion
   description: "Exercise - Explore data type casting and conversion"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-language/csharp-convert-cast/3-exercise-tryparse.yml b/learn-pr/wwl-language/csharp-convert-cast/3-exercise-tryparse.yml
@@ -4,7 +4,7 @@ title: Exercise - Examine the TryParse() method
 metadata:
   title: Exercise - Examine the TryParse() method
   description: "Exercise - Examine the TryParse() method"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-language/csharp-convert-cast/4-challenge.yml b/learn-pr/wwl-language/csharp-convert-cast/4-challenge.yml
@@ -4,7 +4,7 @@ title: Exercise - Complete a challenge to combine string array values as strings
 metadata:
   title: Exercise - Complete a challenge to combine string array values as strings and as integers
   description: "Exercise - Complete a challenge to combine string array values as strings and as integers"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-language/csharp-convert-cast/5-solution.yml b/learn-pr/wwl-language/csharp-convert-cast/5-solution.yml
@@ -4,7 +4,7 @@ title: 'Review a solution for combining string array values as strings and as in
 metadata:
   title: Review a solution for combining string array values as strings and as integers challenge
   description: "Review a solution for combining string array values as strings and as integers challenge"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-language/csharp-convert-cast/6-challenge-2.yml b/learn-pr/wwl-language/csharp-convert-cast/6-challenge-2.yml
@@ -4,7 +4,7 @@ title: Exercise - Complete a challenge to output math operations as specific num
 metadata:
   title: Exercise - Complete a challenge to output math operations as specific number types
   description: "Exercise - Complete a challenge to output math operations as specific number types"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-language/csharp-convert-cast/7-solution-2.yml b/learn-pr/wwl-language/csharp-convert-cast/7-solution-2.yml
@@ -4,7 +4,7 @@ title: Review a solution for the output math operations as specific number types
 metadata:
   title: Review a solution for the output math operations as specific number types challenge
   description: "Review a solution for the output math operations as specific number types challenge"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-language/csharp-convert-cast/8-knowledge-check.yml b/learn-pr/wwl-language/csharp-convert-cast/8-knowledge-check.yml
@@ -4,7 +4,7 @@ title: Knowledge check
 metadata:
   title: Knowledge check
   description: "Knowledge check"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-language/csharp-convert-cast/9-summary.yml b/learn-pr/wwl-language/csharp-convert-cast/9-summary.yml
@@ -4,7 +4,7 @@ title: Summary
 metadata:
   title: Summary
   description: "Summary"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
diff --git a/learn-pr/wwl-language/csharp-convert-cast/includes/1-introduction.md b/learn-pr/wwl-language/csharp-convert-cast/includes/1-introduction.md
@@ -23,3 +23,4 @@ In this module, you'll:
 - Experience using data types like `string`, `int`, `decimal`, `float`, and so on
 - Experience using arrays and the `foreach` iteration statement
 - Experience using string interpolation to combine variable and literal values for output
+- Experience using Visual Studio Code to develop, build, and run C# code
diff --git a/learn-pr/wwl-language/csharp-convert-cast/includes/2-exercise-data-type-conversion.md b/learn-pr/wwl-language/csharp-convert-cast/includes/2-exercise-data-type-conversion.md
@@ -1,3 +1,5 @@
+
+
 There are multiple techniques to perform a data type conversion. The technique you choose depends on your answer to two important questions:
 
 - Is it possible, depending on the value, that attempting to change the value's data type would throw an exception at run time?
@@ -54,7 +56,7 @@ This module includes hands-on activities that guide you through the process of b
 
 The C# compiler attempts to accommodate your code, but doesn't compile operations that could result in an exception. When you understand the C# compiler's primary concern, understanding why it functions a certain way is easier.
 
-### Write code that attempts to add an int and a string and save the result in an int
+### Write code that attempts to add an `int` and a `string` and save the result in an `int`
 
 1. Ensure that you have Visual Studio Code open and Program.cs displayed in the Editor panel.
 
@@ -280,7 +282,7 @@ Most of the numeric data types have a `Parse()` method, which converts a string
     Console.WriteLine(sum);
     ```
 
-1. Save your code file, and then use Visual Studio Code to run your code. When you run the code, the output should display a sum of the two values:
+1. Save your code file, and then use Visual Studio Code to run your code. When you run the code, the output should display a concatenation of the two values:
 
     ```Output
     12
@@ -307,18 +309,17 @@ The `Convert` class has many helper methods to convert a value from one type int
 
     You should see the following output:
 
-    
     ```Output
     35
     ```
-    
+
     > [!NOTE]
     > Why is the method name `ToInt32()`? Why not `ToInt()`? `System.Int32` is the name of the underlying data type in the .NET Class Library that the C# programming language maps to the keyword `int`. Because the `Convert` class is also part of the .NET Class Library, it is called by its full name, not its C# name. By defining data types as part of the .NET Class Library, multiple .NET languages like Visual Basic, F#, IronPython, and others can share the same data types and the same classes in the .NET Class Library.
-    
+
     The `ToInt32()` method has 19 overloaded versions allowing it to accept virtually every data type.
-    
+
     you used the `Convert.ToInt32()` method with a string here, but you should probably use `TryParse()` when possible.
-    
+
     So, when should you use the `Convert` class? The `Convert` class is best for converting fractional numbers into whole numbers (`int`) because it rounds up the way you would expect.
 
 ## Compare casting and converting a `decimal` into an `int`
@@ -354,7 +355,7 @@ When you're converting using `Convert.ToInt32()`, the literal float value is pro
 
 You covered several important concepts of data conversion and casting:
 
-- Prevent a runtime error while perform a data conversion
+- Prevent a runtime error while performing a data conversion
 - Perform an explicit cast to tell the compiler you understand the risk of losing data
 - Rely on the compiler to perform an implicit cast when performing an expanding conversion
 - Use the `()` cast operator and the data type to perform a cast (for example, `(int)myDecimal`)
diff --git a/learn-pr/wwl-language/csharp-convert-cast/includes/3-exercise-tryparse.md b/learn-pr/wwl-language/csharp-convert-cast/includes/3-exercise-tryparse.md
@@ -1,5 +1,6 @@
 
 
+
 When working with data, sometimes, you need to convert string data into a numeric data type. As you learned in the previous unit, because the string data type can hold a non-numeric value, it's possible that performing a conversion from a `string` into a numeric data type causes a runtime error.
 
 For example, the following code:
@@ -173,4 +174,4 @@ The `TryParse()` method is a valuable tool. Here are few quick ideas to remember
 - Use `TryParse()` when converting a string into a numeric data type.
 - `TryParse()` returns `true` if the conversion is successful, `false` if it's unsuccessful.
 - Out parameters provide a secondary means of a method returning a value. In this case, the out parameter returns the converted value.
-- Use the keyword `out` when passing in an argument to a method that has defined an out parameter.
+- Use the keyword `out` when passing in an argument to a method that has defined an out parameter.
diff --git a/learn-pr/wwl-language/csharp-convert-cast/includes/4-challenge.md b/learn-pr/wwl-language/csharp-convert-cast/includes/4-challenge.md
@@ -1,5 +1,6 @@
 
 
+
 Code challenges reinforce what you've learned and help you gain some confidence before continuing.
 
 This module features two code challenges. This first challenge forces you to split up the data depending on its type and either concatenate or add the data accordingly.
diff --git a/learn-pr/wwl-language/csharp-convert-cast/includes/5-solution.md b/learn-pr/wwl-language/csharp-convert-cast/includes/5-solution.md
@@ -1,5 +1,6 @@
 
 
+
 The following code is one possible solution for the challenge from the previous unit.
 
 ```csharp
diff --git a/learn-pr/wwl-language/csharp-convert-cast/includes/6-challenge-2.md b/learn-pr/wwl-language/csharp-convert-cast/includes/6-challenge-2.md
@@ -1,5 +1,6 @@
 
 
+
 Here's a second chance to use what you've learned about casting and conversion to solve a coding challenge.
 
 The following challenge helps you to understand the implications of casting values considering the impact of narrowing and widening conversions.
diff --git a/learn-pr/wwl-language/csharp-convert-cast/includes/7-solution-2.md b/learn-pr/wwl-language/csharp-convert-cast/includes/7-solution-2.md
@@ -1,5 +1,6 @@
 
 
+
 The following code is one possible solution for the challenge from the previous unit.
 
 ```csharp
diff --git a/learn-pr/wwl-language/csharp-convert-cast/includes/9-summary.md b/learn-pr/wwl-language/csharp-convert-cast/includes/9-summary.md
@@ -1,5 +1,6 @@
 
 
+
 Your goal was to use several different techniques to change the data type of a given value.
 
 You used *implicit conversion*, relying on the C# compiler to perform *widening conversions*. When the compiler was unable to perform an implicit conversion, you used *explicit conversions*. You used the `ToString()` method to explicitly convert a numeric data type into a `string`.
@@ -12,5 +13,6 @@ Without this wealth of options, it would be difficult to work in a typed program
 
 ## Resources
 
+- [Casting and type conversions (C# programming guide)](/dotnet/csharp/programming-guide/types/casting-and-type-conversions)
 - [Built-in types (C# reference)](/dotnet/csharp/language-reference/builtin-types/built-in-types)
 - [Default values of C# types (C# reference)](/dotnet/csharp/language-reference/builtin-types/default-values)
diff --git a/learn-pr/wwl-language/csharp-convert-cast/index.yml b/learn-pr/wwl-language/csharp-convert-cast/index.yml
@@ -3,7 +3,7 @@ uid: learn.languages.csharp-convert-cast
 metadata:
   title: Convert data types using casting and conversion techniques in C#
   description: "Convert data types using casting and conversion techniques in C#"
-  ms.date: 02/24/2023
+  ms.date: 04/26/2023
   author: wwlpublish
   ms.author: eric
   ms.topic: interactive-tutorial
@@ -16,9 +16,10 @@ abstract: |
   - Guard against the loss of data when performing a cast or conversion operation.
   - Use the `TryParse()` method to safely convert a string into a numeric data type.
 prerequisites: |
-  - Experience using data types like `string`, `int`, `decimal`, `float`, and so on
-  - Experience using arrays and the `foreach` iteration statement
-  - Experience using *string interpolation* to combine *variable* and *literal* values for output
+  *   Experience using data types like `string`, `int`, `decimal`, `float`, and so on
+  *   Experience using arrays and the `foreach` iteration statement
+  *   Experience using _string interpolation_ to combine _variable_ and _literal_ values for output
+  *   Experience using Visual Studio Code to develop, build, and run C# code
 iconUrl: /training/achievements/csharp-convert-cast.svg
 levels:
 - beginner
