DateTimeFormatInfo.SetAllDateTimePatterns(String[], Char) Methode

public:
 void SetAllDateTimePatterns(cli::array <System::String ^> ^ patterns, char format);

public void SetAllDateTimePatterns (string[] patterns, char format);

[System.Runtime.InteropServices.ComVisible(false)]
public void SetAllDateTimePatterns (string[] patterns, char format);

member this.SetAllDateTimePatterns : string[] * char -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SetAllDateTimePatterns : string[] * char -> unit

Public Sub SetAllDateTimePatterns (patterns As String(), format As Char)

Parameter

Attribute

ComVisibleAttribute

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein CultureInfo -Objekt instanziiert, das die Kultur "en-US" (Englisch – USA) darstellt, und verwendet es, um ein Array von Datums- und Uhrzeitzeichenfolgen mithilfe der Standardformatzeichenfolge "Y" zu analysieren. Anschließend wird die SetAllDateTimePatterns -Methode verwendet, um der Standardformatzeichenfolge "Y" eine neue benutzerdefinierte Formatzeichenfolge zuzuordnen, und versucht dann, das Array der Datums- und Uhrzeitzeichenfolgen zu analysieren. Die Ausgabe des Beispiels zeigt, dass die neue benutzerdefinierte Formatzeichenfolge sowohl in den Analyse- als auch bei formatierungsvorgängen verwendet wird.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Use standard en-US culture.
      CultureInfo enUS = new CultureInfo("en-US");

      string[] values = { "December 2010", "December, 2010",
                          "Dec-2010", "December-2010" };

      Console.WriteLine("Supported Y/y patterns for {0} culture:", enUS.Name);
      foreach (var pattern in enUS.DateTimeFormat.GetAllDateTimePatterns('Y'))
         Console.WriteLine("   " + pattern);

      Console.WriteLine();

      // Try to parse each date string using "Y" format specifier.
      foreach (var value in values) {
         try {
            DateTime dat = DateTime.ParseExact(value, "Y", enUS);
            Console.WriteLine(String.Format(enUS, "   Parsed {0} as {1:Y}", value, dat));
         }
         catch (FormatException) {
            Console.WriteLine("   Cannot parse {0}", value);
         }
      }
      Console.WriteLine();

      //Modify supported "Y" format.
      enUS.DateTimeFormat.SetAllDateTimePatterns( new string[] { "MMM-yyyy" } , 'Y');

      Console.WriteLine("New supported Y/y patterns for {0} culture:", enUS.Name);
      foreach (var pattern in enUS.DateTimeFormat.GetAllDateTimePatterns('Y'))
         Console.WriteLine("   " + pattern);

      Console.WriteLine();

      // Try to parse each date string using "Y" format specifier.
      foreach (var value in values) {
         try {
            DateTime dat = DateTime.ParseExact(value, "Y", enUS);
            Console.WriteLine(String.Format(enUS, "   Parsed {0} as {1:Y}", value, dat));
         }
         catch (FormatException) {
            Console.WriteLine("   Cannot parse {0}", value);
         }
      }
   }
}
// The example displays the following output:
//       Supported Y/y patterns for en-US culture:
//          MMMM, yyyy
//
//          Cannot parse December 2010
//          Parsed December, 2010 as December, 2010
//          Cannot parse Dec-2010
//          Cannot parse December-2010
//
//       New supported Y/y patterns for en-US culture:
//          MMM-yyyy
//
//          Cannot parse December 2010
//          Cannot parse December, 2010
//          Parsed Dec-2010 as Dec-2010
//          Cannot parse December-2010

Imports System.Globalization

Module Example
   Public Sub Main()
      ' Use standard en-US culture.
      Dim enUS As New CultureInfo("en-US")
      
      Dim values() As String = { "December 2010", "December, 2010",  
                                 "Dec-2010", "December-2010" } 
      
      Console.WriteLine("Supported Y/y patterns for {0} culture:", enUS.Name)
      For Each pattern In enUS.DateTimeFormat.GetAllDateTimePatterns("Y"c)
         Console.WriteLine("   " + pattern)
      Next 
      Console.WriteLine()
      
      ' Try to parse each date string using "Y" format specifier.
      For Each value In values
         Try
            Dim dat As Date = Date.ParseExact(value, "Y", enUS)
            Console.WriteLine(String.Format(enUS, "   Parsed {0} as {1:Y}", value, dat))
         Catch e As FormatException
            Console.WriteLine("   Cannot parse {0}", value)
         End Try   
      Next   
      Console.WriteLine()
      
      'Modify supported "Y" format.
      enUS.DateTimeFormat.SetAllDateTimePatterns( { "MMM-yyyy" } , "Y"c)
      
      Console.WriteLine("New supported Y/y patterns for {0} culture:", enUS.Name)
      For Each pattern In enUS.DateTimeFormat.GetAllDateTimePatterns("Y"c)
         Console.WriteLine("   " + pattern)
      Next 
      Console.WriteLine()

      ' Try to parse each date string using "Y" format specifier.
      For Each value In values
         Try
            Dim dat As Date = Date.ParseExact(value, "Y", enUS)
            Console.WriteLine(String.Format(enUS, "   Parsed {0} as {1:Y}", value, dat))
         Catch e As FormatException
            Console.WriteLine("   Cannot parse {0}", value)
         End Try   
      Next   
   End Sub
End Module
' The example displays the following output:
'       Supported Y/y patterns for en-US culture:
'          MMMM, yyyy
'       
'          Cannot parse December 2010
'          Parsed December, 2010 as December, 2010
'          Cannot parse Dec-2010
'          Cannot parse December-2010
'       
'       New supported Y/y patterns for en-US culture:
'          MMM-yyyy
'       
'          Cannot parse December 2010
'          Cannot parse December, 2010
'          Parsed Dec-2010 as Dec-2010
'          Cannot parse December-2010

Hinweise

Die SetAllDateTimePatterns -Methode definiert die benutzerdefinierten Formatzeichenfolgen, die einer bestimmten Standardformatzeichenfolge für Datum und Uhrzeit entsprechen. Wenn ein Aufruf einer Datums- und Uhrzeitformatmethode die von formatangegebene Standardformatzeichenfolge für Datum und Uhrzeit enthält, verwendet die -Methode das erste Element im patterns Array, um das Format der resultierenden Zeichenfolge zu definieren.

Sie können benutzerdefinierte Formatzeichenfolgen definieren, die den Standardformatzeichenfolgen "d", "D", "t", "T" und "y" oder "Y" entsprechen. Wenn der Wert von format eine andere Standardformatzeichenfolge ist, löst die SetAllDateTimePatterns -Methode einen aus ArgumentException.

Wenn Ihre benutzerdefinierten Datums- und Uhrzeitformatzeichenfolgen Datumstrennzeichen enthalten, sollten Sie explizit ein Datumstrennzeichen angeben, anstatt sich auf die Analyse- oder Formatierungsmethode zu verlassen, die den benutzerdefinierten Formatbezeichner "/" durch ein bestimmtes Datumstrennzeichen ersetzt. Um beispielsweise das Muster MM-DD-jjjj abzurufen, verwenden Sie das Muster "MM-TT-JJJJ".

Gilt für:

Weitere Informationen

• GetAllDateTimePatterns
• Standard-Formatzeichenfolgen für Datum und Uhrzeit
• Benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit