Merge pull request #49814 from wwlpublish/b01279e8c43c169068f94f2f4523fcd7cbf4b41707dff12424630d93fb4b1a7a-live

 Modules/M01-get-started-file-input-output

Author: JamesJBarnett

learn-pr/wwl-language/get-started-file-input-output/1-introduction.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-file-input-output.introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: "Introduction."
+  ms.date: 04/03/2025
+  author: wwlpublish
+  ms.author: cahowd
+  ms.topic: unit
+durationInMinutes: 3
+content: |
+  [!include[](includes/1-introduction.md)]

learn-pr/wwl-language/get-started-file-input-output/2-examine-text-file-formats-tools.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-file-input-output.examine-text-file-formats-tools
+title: Examine text file formats and tools
+metadata:
+  title: Examine text file formats and tools
+  description: "Examine text file formats and tools."
+  ms.date: 04/03/2025
+  author: wwlpublish
+  ms.author: cahowd
+  ms.topic: unit
+durationInMinutes: 8
+content: |
+  [!include[](includes/2-examine-text-file-formats-tools.md)]

learn-pr/wwl-language/get-started-file-input-output/3-manage-local-directories-files-directory-file-path-classes.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-file-input-output.manage-local-directories-files-directory-file-path-classes
+title: Manage local directories and files using the Directory, File, and Path classes
+metadata:
+  title: Manage local directories and files using the Directory, File, and Path classes
+  description: "Manage local directories and files using the Directory, File, and Path classes."
+  ms.date: 04/03/2025
+  author: wwlpublish
+  ms.author: cahowd
+  ms.topic: unit
+durationInMinutes: 9
+content: |
+  [!include[](includes/3-manage-local-directories-files-directory-file-path-classes.md)]

learn-pr/wwl-language/get-started-file-input-output/4-read-write-text-files-streamreader-streamwriter-classes.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-file-input-output.read-write-text-files-streamreader-streamwriter-classes
+title: Read and write text files using the StreamReader and StreamWriter classes
+metadata:
+  title: Read and write text files using the StreamReader and StreamWriter classes
+  description: "Read and write text files using the StreamReader and StreamWriter classes."
+  ms.date: 04/03/2025
+  author: wwlpublish
+  ms.author: cahowd
+  ms.topic: unit
+durationInMinutes: 10
+content: |
+  [!include[](includes/4-read-write-text-files-streamreader-streamwriter-classes.md)]

learn-pr/wwl-language/get-started-file-input-output/5-control-file-access-filestream-class.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-file-input-output.control-file-access-filestream-class
+title: Control file access using the FileStream class
+metadata:
+  title: Control file access using the FileStream class
+  description: "Control file access using the FileStream class."
+  ms.date: 04/03/2025
+  author: wwlpublish
+  ms.author: cahowd
+  ms.topic: unit
+durationInMinutes: 9
+content: |
+  [!include[](includes/5-control-file-access-filestream-class.md)]

learn-pr/wwl-language/get-started-file-input-output/6-examine-binaryreader-binarywriter-classes.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-file-input-output.examine-binaryreader-binarywriter-classes
+title: Examine the BinaryReader and BinaryWriter classes
+metadata:
+  title: Examine the BinaryReader and BinaryWriter classes
+  description: "Examine the BinaryReader and BinaryWriter classes."
+  ms.date: 04/03/2025
+  author: wwlpublish
+  ms.author: cahowd
+  ms.topic: unit
+durationInMinutes: 7
+content: |
+  [!include[](includes/6-examine-binaryreader-binarywriter-classes.md)]

learn-pr/wwl-language/get-started-file-input-output/7-exercise-create-manage-text-files.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-file-input-output.exercise-create-manage-text-files
+title: Exercise - Create and manage text files
+metadata:
+  title: Exercise - Create and manage text files
+  description: "Exercise - Create and manage text files."
+  ms.date: 04/03/2025
+  author: wwlpublish
+  ms.author: cahowd
+  ms.topic: unit
+durationInMinutes: 30
+content: |
+  [!include[](includes/7-exercise-create-manage-text-files.md)]

learn-pr/wwl-language/get-started-file-input-output/8-knowledge-check.yml

@@ -0,0 +1,69 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-file-input-output.knowledge-check
+title: Knowledge check
+metadata:
+  title: Knowledge check
+  description: "Knowledge check."
+  ms.date: 04/03/2025
+  author: wwlpublish
+  ms.author: cahowd
+  ms.topic: unit
+durationInMinutes: 3
+quiz:
+  title: "Check your knowledge"
+  questions:
+  - content: "What does the `Directory.GetFiles` method in C# return?"
+    choices:
+    - content: "It returns the size of the specified directory."
+      isCorrect: false
+      explanation: "Incorrect.` Directory.GetFiles` doesn't provide information about the size of a directory."
+    - content: "It returns the names of subdirectories within the specified directory."
+      isCorrect: false
+      explanation: "Incorrect. Returning subdirectories is the behavior of `Directory.GetDirectories`, not `Directory.GetFiles`."
+    - content: "It returns the names of files within the specified directory."
+      isCorrect: true
+      explanation: "Correct. `Directory.GetFiles` returns an array of full file names including paths."
+  - content: "What is the purpose of the `StreamReader` and `StreamWriter` classes in C#?"
+    choices:
+    - content: "They're used to establish network connections for data transmission."
+      isCorrect: false
+      explanation: "Incorrect. `StreamReader` and `StreamWriter` are used for handling text data in streams, not for establishing network connections."
+    - content: "They're used to read and write binary data from and to a stream."
+      isCorrect: false
+      explanation: "Incorrect. `StreamReader` and `StreamWriter` are designed for reading and writing text data, not binary data."
+    - content: "They're used to read characters from a byte stream and write characters to a stream in a specific encoding."
+      isCorrect: true
+      explanation: "Correct. The `StreamReader` class is used to read characters from a byte stream in a particular encoding, while the `StreamWriter` class is used to write characters to a stream in a specific encoding."
+  - content: "What is the purpose of the `FileStream.Seek` method in C#?"
+    choices:
+    - content: "It's used to write to a file."
+      isCorrect: false
+      explanation: "Incorrect. The `FileStream.Seek` method doesn't write to a file."
+    - content: "It's used to change the current position of the `FileStream` object."
+      isCorrect: true
+      explanation: "Correct. The `FileStream.Seek` method changes the current position of the `FileStream` object."
+    - content: "It's used to close a file."
+      isCorrect: false
+      explanation: "Incorrect. The `FileStream.Seek` method doesn't close a file."
+  - content: "What are some common use cases for the `BinaryReader` and `BinaryWriter` classes in .NET?"
+    choices:
+    - content: "They're used for creating and managing databases."
+      isCorrect: false
+      explanation: "Incorrect. While they can handle data, `BinaryReader` and `BinaryWriter` aren't designed for database management."
+    - content: "They're used for handling binary data such as configuration and multimedia files."
+      isCorrect: true
+      explanation: "Correct. `BinaryReader` and `BinaryWriter` are designed for reading and writing binary data, which includes configuration and multimedia files."
+    - content: "They're used for reading and writing text files."
+      isCorrect: false
+      explanation: "Incorrect. `BinaryReader` and `BinaryWriter` aren't typically used for text files."
+  - content: "What classes are used to create and manage directories and files in a C# app?"
+    choices:
+    - content: "`BinaryWriter` and `BinaryReader` classes."
+      isCorrect: false
+      explanation: "Incorrect. These classes are used for creating and reading binary files."
+    - content: "`Path`, `Directory`, and `File` classes."
+      isCorrect: true
+      explanation: "Correct. The Path, Directory, and File classes are used to create and manage directories and files."
+    - content: "`StreamWriter`, `StreamReader`, and `FileStream` classes."
+      isCorrect: false
+      explanation: "Incorrect. These classes are used for reading and writing CSV files and performing low-level file input and output operations."

learn-pr/wwl-language/get-started-file-input-output/9-summary.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-file-input-output.summary
+title: Summary
+metadata:
+  title: Summary
+  description: "Summary."
+  ms.date: 04/03/2025
+  author: wwlpublish
+  ms.author: cahowd
+  ms.topic: unit
+durationInMinutes: 2
+content: |
+  [!include[](includes/9-summary.md)]

learn-pr/wwl-language/get-started-file-input-output/includes/1-introduction.md

@@ -0,0 +1,22 @@
+File input and output (File I/O) are an important programming task that enables your applications to persist, retrieve, and exchange application data. In this module, you learn how to manage text files in C#, including how to create, read, write, and delete local text files and directories using classes in the `System.IO` namespace. You also learn how to work with structured and unstructured data types, and how to use common text file formats.
+
+Imagine you're signed up to help a non-profit company with a software project. Before the project kicks off, you decide to update your programming skills by developing a banking app. To practice your file management skills, you plan to implement file input and output operations within the app's Program.cs file. You plan to work you way through some basic directory and file management tasks and then finish up with more advanced tasks like storing and retrieving bank transactions.
+
+The topics covered in this module include:
+
+- Get started with file input and output.
+- Manage local directories, files, and paths.
+- Read and write text files using the `StreamReader` and `StreamWriter` classes.
+- Control file access using the `FileStream` class.
+- Examine the `BinaryReader` and `BinaryWriter` classes.
+
+After completing this module, you're able to:
+
+- Describe common file I/O operations, the difference between structured and unstructured data, common text file formats, and classes in the `System.IO` namespace.
+- Use the `Path`, `Directory`, and `File` classes to create, copy, move, delete, and enumerate local text files and directories.
+- Implement file I/O operations using the `StreamReader` and `StreamWriter` classes and CSV files.
+- Control file access using the `FileStream` class.
+- Read and write binary files using the `BinaryReader` and `BinaryWriter` classes.
+- Store and retrieve C# objects using file input and output operations.
+
+By the end of this module, you have a solid understanding of file I/O operations and how to implement local file I/O in your projects. You're able to create, read, write, delete, and enumerate files and directories. You also have a better understanding of the different types of file formats and how to work with them effectively.