Reinstate supplemental remarks (System/S-Z) (#12702)

Author: gewarren

snippets/cpp/System/String/.ctor/sbyte_ctor1.cpp

@@ -0,0 +1,20 @@
+// SByte_Ctor1.cpp : Defines the entry point for the console application.
+//
+
+//#include "stdafx.h"
+
+// <Snippet4>
+using namespace System;
+
+void main()
+{
+      char chars[] = { 'a', 'b', 'c', 'd', '\x00' };
+
+      char* charPtr = chars;
+      String^ value = gcnew String(charPtr);
+
+      Console::WriteLine(value);
+}
+// The example displays the following output:
+//      abcd
+// </Snippet4>

snippets/csharp/System/Double/Overview/Program.cs

@@ -0,0 +1 @@
+Example9.Run();

snippets/csharp/System/Double/Overview/Project.csproj

@@ -0,0 +1,8 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFrameworks>net10.0</TargetFrameworks>
+  </PropertyGroup>
+
+ </Project>

snippets/csharp/System/Double/Overview/precisionlist1.cs

@@ -0,0 +1,17 @@
+// <Snippet5>
+using System;
+
+public class Example9
+{
+    public static void Run()
+    {
+        double value1 = 1 / 3.0;
+        float sValue2 = 1 / 3.0f;
+        double value2 = (double)sValue2;
+        Console.WriteLine($"{value1:R} = {value2:R}: {value1.Equals(value2)}");
+    }
+}
+
+// The example displays the following output:
+//        0.33333333333333331 = 0.3333333432674408: False
+// </Snippet5>

snippets/csharp/System/Double/Overview/source.cs

@@ -213,6 +213,7 @@ public double Celsius {
 	}
 	//</snippet4>
 }
+
 namespace Snippets5 {
 	//<snippet5>
 	public class Temperature {
@@ -257,6 +258,7 @@ public double Celsius {
 	}
 	//</snippet5>
 }
+
 namespace Snippets6 {
 	//<snippet6>
 	public class Temperature {
@@ -301,6 +303,7 @@ public double Celsius {
 	}
 	//</snippet6>
 }
+
 namespace Snippets7 {
 	//<snippet7>
 	public class Temperature {
@@ -345,6 +348,7 @@ public double Celsius {
 	}
 	//</snippet7>
 }
+
 namespace Snippets8 {
 	//<snippet8>
 	public class Temperature {

snippets/csharp/System/FormatException/Overview/FormatExample2.cs

@@ -0,0 +1,77 @@
+// <Snippet2>
+using System;
+
+public class TestFormatter
+{
+   public static void Main()
+   {
+      int acctNumber = 79203159;
+      Console.WriteLine(String.Format(new CustomerFormatter(), "{0}", acctNumber));
+      Console.WriteLine(String.Format(new CustomerFormatter(), "{0:G}", acctNumber));
+      Console.WriteLine(String.Format(new CustomerFormatter(), "{0:S}", acctNumber));
+      Console.WriteLine(String.Format(new CustomerFormatter(), "{0:P}", acctNumber));
+      try {
+         Console.WriteLine(String.Format(new CustomerFormatter(), "{0:X}", acctNumber));
+      }
+      catch (FormatException e) {
+         Console.WriteLine(e.Message);
+      }
+   }
+}
+
+public class CustomerFormatter : IFormatProvider, ICustomFormatter
+{
+   public object GetFormat(Type formatType) 
+   {
+      if (formatType == typeof(ICustomFormatter))        
+         return this; 
+      else
+         return null;
+   }
+   
+   public string Format(string format, 
+	                     object arg, 
+	                     IFormatProvider formatProvider) 
+   {                       
+      if (! this.Equals(formatProvider))
+      {
+         return null;
+      }
+      else
+      {
+         if (String.IsNullOrEmpty(format)) 
+            format = "G";
+         
+         string customerString = arg.ToString();
+         if (customerString.Length < 8)
+            customerString = customerString.PadLeft(8, '0');
+         
+         format = format.ToUpper();
+         switch (format)
+         {
+            case "G":
+               return customerString.Substring(0, 1) + "-" +
+                                     customerString.Substring(1, 5) + "-" +
+                                     customerString.Substring(6);
+            case "S":                          
+               return customerString.Substring(0, 1) + "/" +
+                                     customerString.Substring(1, 5) + "/" +
+                                     customerString.Substring(6);
+            case "P":                          
+               return customerString.Substring(0, 1) + "." +
+                                     customerString.Substring(1, 5) + "." +
+                                     customerString.Substring(6);
+            default:
+               throw new FormatException( 
+                         String.Format("The '{0}' format specifier is not supported.", format));
+         }
+      }   
+   }
+}
+// The example displays the following output:
+//       7-92031-59
+//       7-92031-59
+//       7/92031/59
+//       7.92031.59
+//       The 'X' format specifier is not supported.
+// </Snippet2>

snippets/csharp/System/FormatException/Overview/Project.csproj

@@ -0,0 +1,8 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Library</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+ </Project>

snippets/csharp/System/FormatException/Overview/example2.cs

@@ -1,7 +1,7 @@
 // <Snippet2>
 using System;
 
-public class Example
+public class FormatExample2
 {
    public enum TemperatureScale
    { Celsius, Fahrenheit, Kelvin }

snippets/csharp/System/FormatException/Overview/example3.cs

@@ -1,6 +1,6 @@
 using System;
 
-public class Example
+public class FormatExample3
 {
    public static void Main()
    {

snippets/csharp/System/FormatException/Overview/format4.cs

@@ -1,18 +1,19 @@
 using System;
 
-public class Example
+public class FormatExample4
 {
-   public static void Main()
+   public static void Run()
    {
       // <Snippet4>
       string formatString = "    {0,10} ({0,8:X8})\n" + 
                             "And {1,10} ({1,8:X8})\n" + 
                             "  = {2,10} ({2,8:X8})";
       int value1 = 16932;
       int value2 = 15421;
-      string result = String.Format(formatString, 
+      string result = string.Format(formatString, 
                                     value1, value2, value1 & value2);
       Console.WriteLine(result);
+
       // The example displays the following output:
       //                16932 (00004224)
       //       And      15421 (00003C3D)