String.ToLowerInvariant 方法

  • 参考

定义

命名空间:
System
程序集:
System.Runtime.dll
程序集:
netstandard.dll
程序集:
mscorlib.dll

返回此 String 对象的转换为小写形式的副本，返回时使用固定区域性的大小写规则。

public:
 System::String ^ ToLowerInvariant();
public string ToLowerInvariant ();
member this.ToLowerInvariant : unit -> string
Public Function ToLowerInvariant () As String

返回

String

当前字符串的等效小写形式。

示例

下面的示例定义了一个字符串数组，其中包含多种语言的单个单词。 ToLowerInvariant方法用于使用每个单词的不区分大小写的版本填充并行数组的元素。 Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>)方法用于根据小写数组中元素的顺序对区分大小写的数组进行排序，以确保元素按与语言无关的顺序显示。

using System;

public class Example
{
   public static void Main()
   {
      string[] words = { "Tuesday", "Salı", "Вторник", "Mardi", 
                         "Τρίτη", "Martes", "יום שלישי", 
                         "الثلاثاء", "วันอังคาร" };
      // Display array in unsorted order.
      foreach (string word in words)
         Console.WriteLine(word);
      Console.WriteLine();

      // Create parallel array of words by calling ToLowerInvariant.
      string[] lowerWords = new string[words.Length];
      for (int ctr = words.GetLowerBound(0); ctr <= words.GetUpperBound(0); ctr++)
         lowerWords[ctr] = words[ctr].ToLowerInvariant();
      
      // Sort the words array based on the order of lowerWords.
      Array.Sort(lowerWords, words, StringComparer.InvariantCulture);
      
      // Display the sorted array.
      foreach (string word in words)
         Console.WriteLine(word);
   }
}
// The example displays the following output:
//       Tuesday
//       Salı
//       Вторник
//       Mardi
//       Τρίτη
//       Martes
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
//       
//       Mardi
//       Martes
//       Salı
//       Tuesday
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร

Module Example
   Public Sub Main()
      Dim words() As String = { "Tuesday", "Salı", "Вторник", "Mardi", _
                                "Τρίτη", "Martes", "יום שלישי", _
                                "الثلاثاء", "วันอังคาร" }
      ' Display array in unsorted order.
      For Each word As String In words
         Console.WriteLine(word)
      Next
      Console.WriteLine()

      ' Create parallel array of words by calling ToLowerInvariant.
      Dim lowerWords(words.Length - 1) As String
      For ctr As Integer = words.GetLowerBound(0) To words.GetUpperBound(0)
         lowerWords(ctr) = words(ctr).ToLowerInvariant()
      Next
      
      ' Sort the words array based on the order of lowerWords.
      Array.Sort(lowerWords, words, StringComparer.InvariantCulture)
      
      ' Display the sorted array.
      For Each word As String In words
         Console.WriteLine(word)
      Next
   End Sub
End Module
' The example displays the following output:
'       Tuesday
'       Salı
'       Вторник
'       Mardi
'       Τρίτη
'       Martes
'       יום שלישי
'       الثلاثاء
'       วันอังคาร
'       
'       Mardi
'       Martes
'       Salı
'       Tuesday
'       Τρίτη
'       Вторник
'       יום שלישי
'       الثلاثاء
'       วันอังคาร

注解

固定区域性表示不区分区域性的区域性。 它与英语相关联，而不是与特定国家或地区相关联。 有关更多信息，请参见 CultureInfo.InvariantCulture 属性。

如果你的应用程序依赖于以可预测方式（不受当前区域性影响）更改的字符串，请使用 ToLowerInvariant 方法。 ToLowerInvariant方法等效于 ToLower(CultureInfo.InvariantCulture) 。 如果在用户界面控件中必须按可预测顺序显示字符串集合，则建议使用方法。

备注

此方法不会修改当前实例的值。 相反，它会返回一个新字符串，其中当前实例中的所有字符都转换为小写。

安全注意事项

如果需要操作系统标识符的小写或大写版本，如文件名、命名管道或注册表项，请使用 ToLowerInvariant 或 ToUpperInvariant 方法。

适用于

另请参阅