Reinstate supplemental remarks (System.R*)

snippets/csharp/System.Resources/MissingManifestResourceException/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.Resources/MissingManifestResourceException/Overview/showdate.cs

@@ -0,0 +1,42 @@
+// <Snippet2>
+using System;
+using System.Globalization;
+using System.Resources;
+using System.Threading;
+
+[assembly: NeutralResourcesLanguage("en")]
+
+public class ShowDateEx
+{
+    public static void Main()
+    {
+        string[] cultureNames = { "en-US", "fr-FR", "ru-RU", "sv-SE" };
+        ResourceManager rm = new ResourceManager("DateStrings",
+                                                 typeof(Example).Assembly);
+
+        foreach (var cultureName in cultureNames)
+        {
+            CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName);
+            Thread.CurrentThread.CurrentCulture = culture;
+            Thread.CurrentThread.CurrentUICulture = culture;
+
+            Console.WriteLine($"Current UI Culture: {CultureInfo.CurrentUICulture.Name}");
+            string dateString = rm.GetString("DateStart");
+            Console.WriteLine($"{dateString} {DateTime.Now:M}.\n");
+        }
+    }
+}
+
+// The example displays output similar to the following:
+//       Current UI Culture: en-US
+//       Today is February 03.
+//       
+//       Current UI Culture: fr-FR
+//       Aujourd'hui, c'est le 3 février
+//       
+//       Current UI Culture: ru-RU
+//       Сегодня февраля 03.
+//       
+//       Current UI Culture: sv-SE
+//       Today is den 3 februari.
+// </Snippet2>

snippets/csharp/System.Resources/MissingManifestResourceException/Overview/showdate1.cs

@@ -0,0 +1,39 @@
+// <Snippet2>
+using System;
+using System.Globalization;
+using System.Resources;
+using System.Threading;
+
+public class ShowTimeExample
+{
+   public static void Main()
+   {
+      string[] cultureNames = [ "en-US", "fr-FR", "ru-RU", "sv-SE" ];
+      ResourceManager rm = new ResourceManager("DateStrings",
+                                               typeof(Example).Assembly);
+
+      foreach (var cultureName in cultureNames) {
+         CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName);
+         Thread.CurrentThread.CurrentCulture = culture;
+         Thread.CurrentThread.CurrentUICulture = culture;
+
+         Console.WriteLine($"Current UI Culture: {CultureInfo.CurrentUICulture.Name}");
+         string dateString = rm.GetString("DateStart");
+         Console.WriteLine($"{dateString} {DateTime.Now:M}.\n");
+      }
+   }
+}
+
+// The example displays output similar to the following:
+//       Current UI Culture: en-US
+//       Today is February 03.
+//
+//       Current UI Culture: fr-FR
+//       Aujourd'hui, c'est le 3 février
+//
+//       Current UI Culture: ru-RU
+//       Сегодня февраля 03.
+//
+//       Current UI Culture: sv-SE
+//       Today is den 3 februari.
+// </Snippet2>

snippets/csharp/System.Resources/MissingManifestResourceException/Overview/showdate2.cs

@@ -0,0 +1,32 @@
+// <Snippet3>
+using System;
+using System.Globalization;
+using System.Resources;
+using System.Threading;
+
+public class Example2
+{
+    public static void Main()
+    {
+        Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("ru-RU");
+        Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("ru-RU");
+
+        string[] cultureNames = [ "fr-FR", "sv-SE" ];
+        ResourceManager rm = new ResourceManager("DateStrings",
+                                                 typeof(Example).Assembly);
+
+        foreach (var cultureName in cultureNames)
+        {
+            CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName);
+            string dateString = rm.GetString("DateStart", culture);
+            Console.WriteLine($"{culture.DisplayName}: {dateString} {DateTime.Now.ToString("M", culture)}.");
+            Console.WriteLine();
+        }
+    }
+}
+
+// The example displays output similar to the following:
+//       French (France): Aujourd'hui, c'est le 7 février.
+//
+//       Swedish (Sweden): Today is den 7 februari.
+// </Snippet3>

snippets/csharp/System.Resources/MissingManifestResourceException/Overview/showtime.cs

@@ -0,0 +1,18 @@
+// <Snippet1>
+using System;
+using System.Resources;
+
+public class ShowTimeEx
+{
+    public static void Main()
+    {
+        ResourceManager rm = new ResourceManager("Strings",
+                                 typeof(Example).Assembly);
+        string timeString = rm.GetString("TimeHeader");
+        Console.WriteLine($"{timeString} {DateTime.Now:T}");
+    }
+}
+
+// The example displays output like the following:
+//        The current time is 2:03:14 PM
+// </Snippet1>

snippets/csharp/System.Resources/NeutralResourcesLanguageAttribute/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.Resources/NeutralResourcesLanguageAttribute/Overview/example.cs

@@ -0,0 +1,30 @@
+// <Snippet1>
+using System;
+using System.Globalization;
+using System.Reflection;
+using System.Resources;
+using System.Threading;
+
+[assembly: NeutralResourcesLanguageAttribute("en")]
+public class Example
+{
+    public static void Main()
+    {
+        // Select the current culture randomly to test resource fallback.
+        string[] cultures = { "de-DE", "en-us", "fr-FR" };
+        Random rnd = new Random();
+        int index = rnd.Next(0, cultures.Length);
+        Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultures[index]);
+        Console.WriteLine($"The current culture is {CultureInfo.CurrentUICulture.Name}");
+
+        // Retrieve the resource.
+        ResourceManager rm = new ResourceManager("ExampleResources",
+                                                 typeof(Example).Assembly);
+        string greeting = rm.GetString("Greeting");
+
+        Console.Write("Enter your name: ");
+        string name = Console.ReadLine();
+        Console.WriteLine($"{greeting} {name}!");
+    }
+}
+// </Snippet1>

snippets/csharp/System.Resources/ResourceManager/.ctor/Project.csproj

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

snippets/csharp/System.Resources/ResourceManager/.ctor/ctor1.cs

@@ -0,0 +1,15 @@
+using System;
+using System.Resources;
+
+public class Example
+{
+   public static void Main()
+   {
+      // <Snippet2>
+      ResourceManager rm = new ResourceManager(typeof(Resource1));
+      // </Snippet2>
+   }
+}
+
+internal class Resource1
+{ }

snippets/csharp/System.Resources/ResourceManager/.ctor/example.cs

@@ -0,0 +1,23 @@
+// <Snippet1>
+using System;
+using System.Reflection;
+using System.Resources;
+
+public class Example1
+{
+    public static void Main()
+    {
+        // Retrieve the resource.
+        ResourceManager rm = new ResourceManager("ExampleResources",
+                                 typeof(Example).Assembly);
+        string greeting = rm.GetString("Greeting");
+
+        Console.Write("Enter your name: ");
+        string name = Console.ReadLine();
+        Console.WriteLine($"{greeting} {name}!");
+    }
+}
+// The example produces output similar to the following:
+//       Enter your name: John
+//       Hello John!
+// </Snippet1>

snippets/csharp/System.Resources/ResourceManager/.ctor/greet.cs

@@ -0,0 +1,51 @@
+// <Snippet3>
+using System;
+using System.Resources;
+using System.Globalization;
+using System.Threading;
+
+[assembly: NeutralResourcesLanguage("en")]
+
+public class Example2
+{
+    public static void Main()
+    {
+        string[] cultureNames = [ "en-US", "fr-FR", "ru-RU", "sv-SE" ];
+        DateTime noon = new DateTime(DateTime.Now.Year, DateTime.Now.Month,
+                                     DateTime.Now.Day, 12, 0, 0);
+        DateTime evening = new DateTime(DateTime.Now.Year, DateTime.Now.Month,
+                                        DateTime.Now.Day, 18, 0, 0);
+
+        ResourceManager rm = new ResourceManager(typeof(GreetingResources));
+
+        foreach (var cultureName in cultureNames)
+        {
+            Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultureName);
+            Console.WriteLine($"The current UI culture is {CultureInfo.CurrentUICulture.Name}");
+            if (DateTime.Now < noon)
+                Console.WriteLine($"{rm.GetString("Morning")}!");
+            else if (DateTime.Now < evening)
+                Console.WriteLine($"{rm.GetString("Afternoon")}!");
+            else
+                Console.WriteLine($"{rm.GetString("Evening")}!");
+            Console.WriteLine();
+        }
+    }
+
+    internal class GreetingResources
+    {
+    }
+}
+// The example displays output like the following:
+//       The current UI culture is en-US
+//       Good afternoon!
+//
+//       The current UI culture is fr-FR
+//       Bonjour!
+//
+//       The current UI culture is ru-RU
+//       Добрый день!
+//
+//       The current UI culture is sv-SE
+//       Good afternoon!
+// </Snippet3>

snippets/csharp/System.Resources/ResourceManager/GetObject/Project.csproj

@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Library</OutputType>
+    <TargetFrameworks>net48</TargetFrameworks>
+    <LangVersion>12</LangVersion>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Reference Include="System.Windows.Forms" />
+  </ItemGroup>
+
+ </Project>

snippets/csharp/System.Resources/ResourceManager/GetObject/createresources.cs

@@ -0,0 +1,64 @@
+// <Snippet2>
+using System;
+using System.Resources;
+
+public class CreateResource
+{
+   public static void Main()
+   {
+      Numbers en = new Numbers("one", "two", "three", "four", "five",
+                               "six", "seven", "eight", "nine", "ten");
+      CreateResourceFile(en, "en");
+      Numbers fr = new Numbers("un", "deux", "trois", "quatre", "cinq", 
+                               "six", "sept", "huit", "neuf", "dix");
+      CreateResourceFile(fr, "fr");
+      Numbers pt = new Numbers("um", "dois", "três", "quatro", "cinco", 
+                               "seis", "sete", "oito", "nove", "dez");
+      CreateResourceFile(pt, "pt"); 
+      Numbers ru = new Numbers("один", "два", "три", "четыре", "пять", 
+                               "шесть", "семь", "восемь", "девять", "десять");                                                       
+      CreateResourceFile(ru, "ru");
+   }
+
+   public static void CreateResourceFile(Numbers n, string lang)
+   {
+      string filename = @".\NumberResources" + 
+                        (lang != "en" ? "." + lang : "" ) +
+                        ".resx";
+      ResXResourceWriter rr = new ResXResourceWriter(filename);
+      rr.AddResource("Numbers", n);
+      rr.Generate();
+      rr.Close();    
+   }
+}
+// </Snippet2>
+
+[Serializable] public class Numbers
+{
+   public readonly string One;
+   public readonly string Two;
+   public readonly string Three;
+   public readonly string Four;
+   public readonly string Five;
+   public readonly string Six;
+   public readonly string Seven;
+   public readonly string Eight;
+   public readonly string Nine;
+   public readonly string Ten;
+
+   public Numbers(string one, string two, string three, string four, 
+                  string five, string six, string seven, string eight,
+                  string nine, string ten)
+   {                     
+      this.One = one;
+      this.Two = two;
+      this.Three = three;
+      this.Four = four;
+      this.Five = five;
+      this.Six = six;
+      this.Seven = seven;
+      this.Eight = eight;
+      this.Nine = nine;
+      this.Ten = ten;                                    
+   }                  
+}

snippets/csharp/System.Resources/ResourceManager/GetObject/numberinfo.cs

@@ -0,0 +1,33 @@
+// <Snippet1>
+using System;
+
+[Serializable] public class Numbers2
+{
+   public readonly string One;
+   public readonly string Two;
+   public readonly string Three;
+   public readonly string Four;
+   public readonly string Five;
+   public readonly string Six;
+   public readonly string Seven;
+   public readonly string Eight;
+   public readonly string Nine;
+   public readonly string Ten;
+
+   public Numbers2(string one, string two, string three, string four, 
+                  string five, string six, string seven, string eight,
+                  string nine, string ten)
+   {                     
+      this.One = one;
+      this.Two = two;
+      this.Three = three;
+      this.Four = four;
+      this.Five = five;
+      this.Six = six;
+      this.Seven = seven;
+      this.Eight = eight;
+      this.Nine = nine;
+      this.Ten = ten;                                    
+   }                  
+}
+// </Snippet1>