Merge remote-tracking branch 'dotnet/main' into runtime-120508

Author: tannergooding

_zip/missingapi.yml

@@ -63,6 +63,10 @@ references:
   name: ChatMessage
   fullname: OpenAI.Chat.ChatMessage
   href: https://github.com/openai/openai-dotnet/blob/main/api/OpenAI.netstandard2.0.cs
+- uid: OpenAI.Chat.ChatResponseFormat
+  name: ChatResponseFormat
+  fullname: OpenAI.Chat.ChatResponseFormat
+  href: https://github.com/openai/openai-dotnet/blob/main/api/OpenAI.netstandard2.0.cs
 - uid: OpenAI.Chat.ChatTool
   name: ChatTool
   fullname: OpenAI.Chat.ChatTool
@@ -123,6 +127,10 @@ references:
   name: ResponseItem
   fullname: OpenAI.Responses.ResponseItem
   href: https://github.com/openai/openai-dotnet/blob/main/api/OpenAI.netstandard2.0.cs
+- uid: OpenAI.Responses.ResponseTextFormat
+  name: ResponseTextFormat
+  fullname: OpenAI.Responses.ResponseTextFormat
+  href: https://github.com/openai/openai-dotnet/blob/main/api/OpenAI.netstandard2.0.cs
 - uid: OpenAI.Responses.ResponseTool
   name: ResponseTool
   fullname: OpenAI.Responses.ResponseTool

snippets/csharp/System.IO/Directory/EnumerateFiles/program.cs

@@ -3,15 +3,14 @@
 using System.IO;
 using System.Linq;
 
-class Program
+partial class Example2
 {
-    static void Main(string[] args)
+    static void SearchOptionExample()
     {
         try
         {
             // Set a variable to the My Documents path.
-            string docPath =
-            Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
+            string docPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
 
             var files = from file in Directory.EnumerateFiles(docPath, "*.txt", SearchOption.AllDirectories)
                         from line in File.ReadLines(file)
@@ -26,7 +25,8 @@ where line.Contains("Microsoft")
             {
                 Console.WriteLine($"{f.File}\t{f.Line}");
             }
-            Console.WriteLine($"{files.Count().ToString()} files found.");
+
+            Console.WriteLine($"{files.Count()} files found.");
         }
         catch (UnauthorizedAccessException uAEx)
         {

snippets/csharp/System.IO/Directory/EnumerateFiles/program1.cs

@@ -4,22 +4,22 @@
 using System.Linq;
 using System.IO;
 
-class Program
+partial class Example2
 {
-    static void Main(string[] args)
+    static void OneStringExample()
     {
         try
         {
             // LINQ query for all files containing the word 'Europe'.
-            var files = from file in
-                Directory.EnumerateFiles(@"\\archives1\library\")
-                where file.ToLower().Contains("europe")
-                select file;
+            var files = from file in Directory.EnumerateFiles(@"\\archives1\library\")
+                        where file.ToLower().Contains("europe")
+                        select file;
 
             foreach (var file in files)
             {
                 Console.WriteLine("{0}", file);
             }
+
             Console.WriteLine("{0} files found.", files.Count<string>().ToString());
         }
         catch (UnauthorizedAccessException UAEx)

snippets/csharp/System.IO/Directory/EnumerateFiles/program2.cs

@@ -3,24 +3,25 @@
 using System.Linq;
 using System.IO;
 
-class Program
+partial class Example2
 {
-    static void Main(string[] args)
+    static void TwoStringsExample()
     {
         try
         {
             // LINQ query for all .txt files containing the word 'Europe'.
             var files = from file in Directory.EnumerateFiles(@"\\archives1\library\", "*.txt")
-                where file.ToLower().Contains("europe")
-                select file;
+                        where file.ToLower().Contains("europe")
+                        select file;
 
             foreach (var file in files)
             {
                 Console.WriteLine("{0}", file);
             }
+
             Console.WriteLine("{0} files found.", files.Count<string>().ToString());
         }
-			
+
         catch (UnauthorizedAccessException UAEx)
         {
             Console.WriteLine(UAEx.Message);

snippets/csharp/System.IO/Directory/EnumerateFiles/program3.cs

@@ -0,0 +1,50 @@
+// <Snippet1>
+using System;
+using System.IO;
+using System.Linq;
+
+partial class Example2
+{
+    static void EnumerationOptionsExample()
+    {
+        try
+        {
+            // Set a variable to the My Documents path.
+            string docPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
+
+            // Set the options for the enumeration.
+            var options = new EnumerationOptions
+            {
+                IgnoreInaccessible = true,
+                MatchCasing = MatchCasing.CaseInsensitive,
+                MatchType = MatchType.Simple,
+                RecurseSubdirectories = true
+            };
+
+            var files = from file in Directory.EnumerateFiles(docPath, "*.txt", options)
+                        from line in File.ReadLines(file)
+                        where line.Contains("Microsoft")
+                        select new
+                        {
+                            File = file,
+                            Line = line
+                        };
+
+            foreach (var f in files)
+            {
+                Console.WriteLine($"{f.File}\t{f.Line}");
+            }
+
+            Console.WriteLine($"{files.Count()} files found.");
+        }
+        catch (PathTooLongException pathEx)
+        {
+            Console.WriteLine(pathEx.Message);
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine(ex.Message);
+        }
+    }
+}
+// </Snippet1>

snippets/csharp/System.IO/Directory/EnumerateFiles/program4.cs

@@ -0,0 +1,35 @@
+// <Snippet1>
+using System;
+using System.IO;
+
+partial class Example1
+{
+    static void EnumerationOptionsExample()
+    {
+        string sourceDirectory = @"C:\current";
+        string archiveDirectory = @"C:\archive";
+
+        var options = new EnumerationOptions
+        {
+            MatchCasing = MatchCasing.CaseInsensitive,
+            MatchType = MatchType.Simple,
+            RecurseSubdirectories = true
+        };
+
+        try
+        {
+            var txtFiles = Directory.EnumerateFiles(sourceDirectory, "*.txt", options);
+
+            foreach (string currentFile in txtFiles)
+            {
+                string fileName = currentFile.Substring(sourceDirectory.Length + 1);
+                Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName));
+            }
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine(ex.Message);
+        }
+    }
+}
+// </Snippet1>

snippets/csharp/System.IO/Directory/EnumerateFiles/project.csproj

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

snippets/csharp/System.IO/Directory/Overview/class2.cs

@@ -2,30 +2,27 @@
 using System;
 using System.IO;
 
-namespace ConsoleApplication
+partial class Example1
 {
-    class Program
+    static void TwoStringsExample()
     {
-        static void Main(string[] args)
-        {
-            string sourceDirectory = @"C:\current";
-            string archiveDirectory = @"C:\archive";
+        string sourceDirectory = @"C:\current";
+        string archiveDirectory = @"C:\archive";
 
-            try
-            {
-                var txtFiles = Directory.EnumerateFiles(sourceDirectory, "*.txt");
+        try
+        {
+            var txtFiles = Directory.EnumerateFiles(sourceDirectory, "*.txt");
 
-                foreach (string currentFile in txtFiles)
-                {
-                    string fileName = currentFile.Substring(sourceDirectory.Length + 1);
-                    Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName));
-                }
-            }
-            catch (Exception e)
+            foreach (string currentFile in txtFiles)
             {
-                Console.WriteLine(e.Message);
+                string fileName = currentFile.Substring(sourceDirectory.Length + 1);
+                Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName));
             }
         }
+        catch (Exception e)
+        {
+            Console.WriteLine(e.Message);
+        }
     }
 }
 // </snippet10>

snippets/csharp/System.IO/Directory/Overview/class3.cs

@@ -3,29 +3,27 @@
 using System.IO;
 using System.Linq;
 
-namespace ConsoleApplication
+partial class Program
 {
-    class Program
+    static void EnumerateFilesExample()
     {
-        static void Main(string[] args)
-        {
-            string archiveDirectory = @"C:\archive";
+        string archiveDirectory = @"C:\archive";
 
-            var files = from retrievedFile in Directory.EnumerateFiles(archiveDirectory, "*.txt", SearchOption.AllDirectories)
-                        from line in File.ReadLines(retrievedFile)
-                        where line.Contains("Example")
-                        select new
-                        {
-                            File = retrievedFile,
-                            Line = line
-                        };
+        var files = from retrievedFile in Directory.EnumerateFiles(archiveDirectory, "*.txt", SearchOption.AllDirectories)
+                    from line in File.ReadLines(retrievedFile)
+                    where line.Contains("Example")
+                    select new
+                    {
+                        File = retrievedFile,
+                        Line = line
+                    };
 
-            foreach (var f in files)
-            {
-                Console.WriteLine("{0} contains {1}", f.File, f.Line);
-            }
-            Console.WriteLine("{0} lines found.", files.Count().ToString());
+        foreach (var f in files)
+        {
+            Console.WriteLine("{0} contains {1}", f.File, f.Line);
         }
+
+        Console.WriteLine("{0} lines found.", files.Count().ToString());
     }
 }
 // </snippet11>

snippets/csharp/System.IO/Directory/Overview/class4.cs

@@ -2,30 +2,27 @@
 using System;
 using System.IO;
 
-namespace ConsoleApplication
+partial class Example1
 {
-    class Program
+    static void OneStringExample()
     {
-        static void Main(string[] args)
-        {
-            string sourceDirectory = @"C:\current";
-            string archiveDirectory = @"C:\archive";
+        string sourceDirectory = @"C:\current";
+        string archiveDirectory = @"C:\archive";
 
-            try
-            {
-                var txtFiles = Directory.EnumerateFiles(sourceDirectory);
+        try
+        {
+            var txtFiles = Directory.EnumerateFiles(sourceDirectory);
 
-                foreach (string currentFile in txtFiles)
-                {
-                    string fileName = currentFile.Substring(sourceDirectory.Length + 1);
-                    Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName));
-                }
-            }
-            catch (Exception e)
+            foreach (string currentFile in txtFiles)
             {
-                Console.WriteLine(e.Message);
+                string fileName = currentFile.Substring(sourceDirectory.Length + 1);
+                Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName));
             }
         }
+        catch (Exception e)
+        {
+            Console.WriteLine(e.Message);
+        }
     }
 }
 // </snippet12>