Add C# Examples for CameraView.CaptureImage, CameraView.StartCameraPreview and CameraView.StopCameraPreview (#553)

* Update email-validation-behavior.md

* Add .NET Hot Reload Docs

* Add C# Examples

---------

Co-authored-by: Brandon Minnick <13558917+brminnick@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald@verslu.is>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>

Author: 2 people

docs/maui/views/camera-view.md

@@ -400,6 +400,40 @@ The following example shows how to add a `Button` into the application and setup
 > [!NOTE]
 > In order to use the image that has been captured the `CameraView` provides the `MediaCaptured` event.
 
+The following example demonstrates how to use the `CaptureImage` method:
+
+> [!NOTE]
+> The C# code below uses the Camera field defined above in XAML (`<toolkit:CameraView x:Name="Camera" />`)
+
+```cs
+async void HandleCaptureButtonTapped(object? sender, EventArgs e)
+{
+    // Use the Camera field defined above in XAML (`<toolkit:CameraView x:Name="Camera" />`)
+    Camera.MediaCaptured += HandleCameraViewMediaCaptured;
+
+    try
+    {
+        var captureImageCTS = new CancellationTokenSource(TimeSpan.FromSeconds(3));
+        await Camera.CaptureImage(captureImageCTS.Token);
+    }
+    catch(Exception e)
+    {
+        // Handle Exception
+        Trace.WriteLine(e);
+    }
+    finally
+    {
+        Camera.MediaCaptured -= HandleCameraViewMediaCaptured;
+    }
+}
+
+void HandleCameraViewMediaCaptured(object? sender, MediaCapturedEventArgs e)
+{
+    Stream stream = e.Media;
+    // process media
+}
+```
+
 ## Start preview
 
 The `CameraView` provides the ability to programmatically start the preview from the camera. This is possible through both the `StartCameraPreview` method or the `StartCameraPreviewCommand`.
@@ -462,6 +496,30 @@ The following example shows how to add a `Button` into the application and setup
 </ContentPage>
 ```
 
+The following example demonstrates how to use the `StartCameraPreview` method:
+
+> [!NOTE]
+> The C# code below uses the Camera field defined above in XAML (`<toolkit:CameraView x:Name="Camera" />`)
+
+```cs
+async void HandleStartCameraPreviewButtonTapped(object? sender, EventArgs e)
+{
+
+    try
+    {
+        var startCameraPreviewTCS = new CancellationTokenSource(TimeSpan.FromSeconds(3));
+
+        // Use the Camera field defined above in XAML (`<toolkit:CameraView x:Name="Camera" />`)
+        await Camera.StartCameraPreview(startCameraPreviewTCS.Token);
+    }
+    catch(Exception e)
+    {
+        // Handle Exception
+        Trace.WriteLine(e);
+    }
+}
+```
+
 ## Stop preview
 
 The `CameraView` provides the ability to programmatically stop the preview from the camera. This is possible through both the `StopCameraPreview` method or the `StopCameraPreviewCommand`.
@@ -530,6 +588,28 @@ The following example shows how to add a `Button` into the application and setup
 </ContentPage>
 ```
 
+The following example demonstrates how to use the `StopCameraPreview` method:
+
+> [!NOTE]
+> The C# code below uses the Camera field defined above in XAML (`<toolkit:CameraView x:Name="Camera" />`)
+
+```cs
+void HandleStopCameraPreviewButtonTapped(object? sender, EventArgs e)
+{
+
+    try
+    {
+        // Use the Camera field defined above in XAML (`<toolkit:CameraView x:Name="Camera" />`)
+        Camera.StopCameraPreview();
+    }
+    catch(Exception e)
+    {
+        // Handle Exception
+        Trace.WriteLine(e);
+    }
+}
+```
+
 ## Examples
 
 You can find an example of this feature in action in the [.NET MAUI Community Toolkit Sample Application](https://github.com/CommunityToolkit/Maui/blob/main/samples/CommunityToolkit.Maui.Sample/Pages/Views/CameraView/CameraViewPage.xaml.cs).