DateTimeFormatInfo.SetAllDateTimePatterns(String[], Char) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Globalization

Zestaw:: System.Runtime.dll

Zestaw:: netstandard.dll

Zestaw:: mscorlib.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Ustawia niestandardowe ciągi formatu daty i czasu, które odpowiadają określonemu ciągowi formatu standardowego.

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)

Parametry

patterns: String[]

Tablica niestandardowych ciągów formatu.

format: Char

Ciąg formatu standardowego skojarzony z ciągami formatu niestandardowego określonymi w patterns parametrze .

Atrybuty: ComVisibleAttribute

Wyjątki

ArgumentException

patterns jest null lub tablicą o zerowej długości.

-lub- format nie jest prawidłowym ciągiem formatu standardowego lub jest ciągiem formatu standardowego, którego wzorców nie można ustawić.

ArgumentNullException

patterns ma element tablicy, którego wartość to null .

InvalidOperationException

Ten DateTimeFormatInfo obiekt jest tylko do odczytu.

Przykłady

Poniższy przykład przedstawia obiekt reprezentujący kulturę "en-US" (angielski — Stany Zjednoczone) i używa jej do analizowania tablicy ciągów daty i godziny przy użyciu standardowego ciągu formatu CultureInfo "Y". Następnie używa metody , aby skojarzyć nowy ciąg formatu niestandardowego ze standardowym ciągiem formatu "Y", a następnie próbuje skojarzyć tablicę ciągów daty SetAllDateTimePatterns i godziny. Dane wyjściowe z przykładu pokazują, że nowy ciąg formatu niestandardowego jest używany zarówno w operacjach analizy, jak i formatowania.

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

Uwagi

Metoda SetAllDateTimePatterns definiuje niestandardowe ciągi formatu, które odpowiadają konkretnemu ciągowi standardowego formatu daty i godzin. Jeśli wywołanie metody formatowania daty i czasu zawiera ciąg standardowego formatu daty i czasu określony przez metodę , metoda używa pierwszego elementu w tablicy do zdefiniowania formatu format patterns wynikowego ciągu.

Ostrzeżenie

Metody i nie w pełni iterują wszystkich ciągów w ciągu podczas analizowania ciągu Parse TryParse patterns reprezentacji daty i czasu. Jeśli wymagasz, aby ciąg daty i godziny miał konkretne formaty w operacji analizowania, należy przekazać tablicę prawidłowych formatów do metody DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles) , DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) , lub DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) DateTimeOffset.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) .

Można zdefiniować niestandardowe ciągi formatu, które odpowiadają ciągom standardowego formatu daty i godziny "d", "D", "t", "T" i "y" lub "Y". Jeśli wartość jest format innym ciągiem formatu standardowego, SetAllDateTimePatterns metoda zgłasza wyjątek ArgumentException .

Jeśli niestandardowe ciągi formatu daty i godziny zawierają separatory daty, należy jawnie określić separator daty zamiast polegać na metodzie analizy lub formatowania, która zastępuje specyfikator formatu niestandardowego "/" określonym separatorem daty. Aby na przykład uzyskać wzorzec MM-DD-yyyy, użyj wzorca "MM-DD-yyyy".

Dotyczy