Merge main into live

snippets/csharp/System.IO/Path/Combine/Program.cs

@@ -76,7 +76,7 @@ private static void Combine4()
         //    C:\Pictures\Saved Pictures\2019\Jan\
         //
         // The example displays the following output if run on a Unix-based system:
-        //    C:\Pictures\Saved Pictures\2019\Jan\      
+        //    C:\Pictures\/Saved Pictures\/2019\/Jan\
         // </Snippet4>
     }
 }

snippets/visualbasic/api/system.io/path/combine/Program.vb

@@ -72,7 +72,7 @@ Module Program
         '    C:\Pictures\Saved Pictures\2019\Jan\
         '
         ' The example displays the following output if run on a Unix-based system:
-        '    C:\Pictures\Saved Pictures\2019\Jan\      
+        '    C:\Pictures\/Saved Pictures\/2019\/Jan\
         ' </Snippet4>
     End Sub
 End Module

xml/System/DateTime.xml

@@ -9934,6 +9934,17 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
         <returns>
           <see langword="true" /> if <paramref name="s" /> was converted successfully; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.FormatException">The length of <paramref name="format" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.
+
+ -or-
+
+ <paramref name="format" /> does not contain a valid custom format pattern.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.
+
+ -or-
+
+ <paramref name="style" /> contains an invalid combination of <see cref="T:System.Globalization.DateTimeStyles" /> values (for example, both <see cref="F:System.Globalization.DateTimeStyles.AssumeLocal" /> and <see cref="F:System.Globalization.DateTimeStyles.AssumeUniversal" />).</exception>
       </Docs>
     </Member>
     <Member MemberName="TryParseExact">
@@ -9999,8 +10010,15 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
         <param name="result">When this method returns, contains the <see cref="T:System.DateTime" /> value equivalent to the date and time contained in <paramref name="s" />, if the conversion succeeded, or <see cref="F:System.DateTime.MinValue">DateTime.MinValue</see> if the conversion failed. The conversion fails if the <paramref name="s" /> parameter is <see langword="null" />, is <see cref="F:System.String.Empty" />, or does not contain a valid string representation of a date and time. This parameter is passed uninitialized.</param>
         <summary>Converts the specified char span of a date and time to its <see cref="T:System.DateTime" /> equivalent and returns a value that indicates whether the conversion succeeded.</summary>
         <returns>
-          <see langword="true" /> if the <paramref name="s" /> parameter was converted successfully; otherwise, <see langword="false" />.</returns>
+          <see langword="true" /> if <paramref name="s" /> was converted successfully; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.FormatException">The length of an element in <paramref name="formats" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.
+
+ -or-
+
+ <paramref name="style" /> contains an invalid combination of <see cref="T:System.Globalization.DateTimeStyles" /> values (for example, both <see cref="F:System.Globalization.DateTimeStyles.AssumeLocal" /> and <see cref="F:System.Globalization.DateTimeStyles.AssumeUniversal" />).</exception>
       </Docs>
     </Member>
     <Member MemberName="TryParseExact">
@@ -10129,6 +10147,11 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
 
  ]]></format>
         </remarks>
+        <exception cref="T:System.FormatException">The length of <paramref name="format" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.
+
+ -or-
+
+ <paramref name="format" /> does not contain a valid custom format pattern.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.
 
@@ -10269,6 +10292,7 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
 
  ]]></format>
         </remarks>
+        <exception cref="T:System.FormatException">The length of an element in <paramref name="formats" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.