String 类

System.String.ToLower 方法 (CultureInfo)

上一篇：System.String.ToLower() 方法下一篇：System.String.ToLowerInvariant 方法

方法描述

根据指定区域性的大小写规则返回此字符串转换为小写形式的副本。

语法定义(C# System.String.ToLower 方法 (CultureInfo) 的用法)

public string ToLower(
	CultureInfo culture
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
culture	System-Globalization-CultureInfo	一个对象，用于提供区域性特定的大小写规则。
返回值	System.String	当前字符串的等效小写形式。

提示和注释

culture 参数指定的区域性的大小写规则决定更改字符串大小写的方法。

注意

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

安全注意事项

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

System.String.ToLower 方法 (CultureInfo)例子

两个大写字符串相同，唯一区别在于：在一个字符串中每次出现的 Unicode LATIN CAPITAL LETTER I，在另一个字符串中为 LATIN CAPITAL LETTER I WITH DOT ABOVE。

// Sample for String.ToLower(CultureInfo)

using System;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
    String str1 = "INDIGO";
    // str2 = str1, except each 'I' is '\u0130' (Unicode LATIN CAPITAL I WITH DOT ABOVE).
    String str2 = new String(new Char[] {'\u0130', 'N', 'D', '\u0130', 'G', 'O'});
    String str3, str4;

    Console.WriteLine();
    Console.WriteLine("str1 = '{0}'", str1);

    Console.WriteLine();
    Console.WriteLine("str1 is {0} to str2.", 
         ((0 == String.CompareOrdinal(str1, str2)) ? "equal" : "not equal"));
    CodePoints("str1", str1);
    CodePoints("str2", str2);

    Console.WriteLine();
    // str3 is a lower case copy of str2, using English-United States culture.
    Console.WriteLine("str3 = Lower case copy of str2 using English-United States culture.");
    str3 = str2.ToLower(new CultureInfo("en-US", false));

    // str4 is a lower case copy of str2, using Turkish-Turkey culture.
    Console.WriteLine("str4 = Lower case copy of str2 using Turkish-Turkey culture.");
    str4 = str2.ToLower(new CultureInfo("tr-TR", false));

    // Compare the code points in str3 and str4.
    Console.WriteLine();
    Console.WriteLine("str3 is {0} to str4.", 
         ((0 == String.CompareOrdinal(str3, str4)) ? "equal" : "not equal"));
    CodePoints("str3", str3);
    CodePoints("str4", str4);
    }

    public static void CodePoints(String title, String s)
    {
    Console.Write("{0}The code points in {1} are: {0}", Environment.NewLine, title);
    foreach (ushort u in s)
      Console.Write("{0:x4} ", u);
    Console.WriteLine();
    }
}
/*
This example produces the following results:

str1 = 'INDIGO'

str1 is not equal to str2.

The code points in str1 are:
0049 004e 0044 0049 0047 004f

The code points in str2 are:
0130 004e 0044 0130 0047 004f

str3 = Lower case copy of str2 using English-United States culture.
str4 = Lower case copy of str2 using Turkish-Turkey culture.

str3 is equal to str4.

The code points in str3 are:
0069 006e 0064 0069 0067 006f

The code points in str4 are:
0069 006e 0064 0069 0067 006f
*/

异常

异常	异常描述
ArgumentNullException	culture 为 null。

命名空间

namespace: System

程序集: mscorlib（在 mscorlib.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。