String.ToLower Metoda

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Zwraca kopię tego ciągu przekonwertowaną na małe litery.

Przeciążenia

ToLower()	Zwraca kopię tego ciągu przekonwertowaną na małe litery.
ToLower(CultureInfo)	Zwraca kopię tego ciągu przekonwertowaną na małe litery przy użyciu reguł wielkości liter określonej kultury.

ToLower()

Źródło:

String.Manipulation.cs

Zwraca kopię tego ciągu przekonwertowaną na małe litery.

C#

public string ToLower();

Zwraca

String

Ciąg w małych literach.

Przykłady

Poniższy przykład konwertuje kilka ciągów wielkości liter mieszanych na małe litery.

C#

using System;

public class ToLowerTest {
    public static void Main() {

        string [] info = {"Name", "Title", "Age", "Location", "Gender"};

        Console.WriteLine("The initial values in the array are:");
        foreach (string s in info)
            Console.WriteLine(s);

        Console.WriteLine("{0}The lowercase of these values is:", Environment.NewLine);

        foreach (string s in info)
            Console.WriteLine(s.ToLower());

        Console.WriteLine("{0}The uppercase of these values is:", Environment.NewLine);

        foreach (string s in info)
            Console.WriteLine(s.ToUpper());
    }
}
// The example displays the following output:
//       The initial values in the array are:
//       Name
//       Title
//       Age
//       Location
//       Gender
//
//       The lowercase of these values is:
//       name
//       title
//       age
//       location
//       gender
//
//       The uppercase of these values is:
//       NAME
//       TITLE
//       AGE
//       LOCATION
//       GENDER

Uwagi

Ta metoda uwzględnia reguły wielkości liter bieżącej kultury.

Uwaga

Metoda ta nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym wszystkie znaki w bieżącym wystąpieniu są konwertowane na małe litery.

Operacja wielkości liter, która wynika z wywołania ToLower() metody, bierze pod uwagę konwencje wielkości liter bieżącej kultury. Jeśli potrzebujesz małych lub wielkich wersji identyfikatora systemu operacyjnego, na przykład nazwy pliku, nazwanego potoku lub klucza rejestru, użyj ToLowerInvariant metod lub ToUpperInvariant . Daje to ten sam wynik w każdej kulturze (w przeciwieństwie do ToLower() metody) i działa wydajniej.

Uwagi dotyczące wywoływania

Jak wyjaśniono w artykule Best Practices for Using Strings (Najlepsze rozwiązania dotyczące używania ciągów), zalecamy unikanie wywoływania metod wielkości liter ciągu, które zastępują wartości domyślne, a zamiast tego wywołuje metody, które wymagają jawnego określenia parametrów. Aby przekonwertować znak na małe litery przy użyciu konwencji wielkości liter bieżącej kultury, zasygnalizuj zamiar jawnie, wywołując ToLower(CultureInfo) przeciążenie metody z wartością parametru CurrentCultureculture . Jeśli nie potrzebujesz porównania językowego, rozważ użycie metody Ordinal.

Zobacz też

• ToLowerInvariant()
• ToUpper()
• ToUpperInvariant()

ToLower(CultureInfo)

Źródło:

String.Manipulation.cs

Zwraca kopię tego ciągu przekonwertowaną na małe litery przy użyciu reguł wielkości liter określonej kultury.

C#

public string ToLower(System.Globalization.CultureInfo? culture);

Parametry

culture

CultureInfo

Obiekt, który dostarcza reguły dotyczące wielkości znaków z uwzględnieniem ustawień kulturowych. Jeśli culture wartość to null, używana jest bieżąca kultura.

Zwraca

String

Małe litery odpowiadające bieżącemu ciągowi.

Przykłady

Poniższy przykład konwertuje dwa ciągi wielkich liter na małe litery przy użyciu English-United States i Turkish-Turkey kultur, a następnie porównuje małe ciągi. Wielkie ciągi są identyczne, z tą różnicą, że dla każdego wystąpienia LITERY ALFABETU ŁACIŃSKIEGO Unicode I w jednym ciągu drugi ciąg zawiera LITERĘ WIELKA ALFABET ŁACIŃSKI I Z KROPKĄ POWYŻEJ.

C#

// 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
*/

Uwagi

Reguły wielkości liter kultury określone przez culture parametr określają sposób zmiany wielkości liter ciągu.

Uwaga

Metoda ta nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym wszystkie znaki w bieżącym wystąpieniu są konwertowane na małe litery.

Jeśli przekażesz metodę ToLower(CultureInfo)CultureInfo obiekt inny niż CultureInfo.InvariantCulture, operacja wielkości liter będzie uwzględniać reguły specyficzne dla kultury. Jeśli potrzebujesz małych lub wielkich liter identyfikatora systemu operacyjnego, na przykład nazwy pliku, nazwanego potoku lub klucza rejestru, użyj ToLowerInvariant metody lub ToUpperInvariant . Daje to ten sam wynik w każdej kulturze i działa wydajniej.

Zobacz też

• CultureInfo
• ToUpper()