String.ToLower Metoda

Definice

Obor názvů:: System

Sestavení:: mscorlib.dll, System.Runtime.dll

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí kopii tohoto řetězce převedenou na malá písmena.

Přetížení

Name	Description
ToLower()	Vrátí kopii tohoto řetězce převedenou na malá písmena.
ToLower(CultureInfo)	Vrátí kopii tohoto řetězce převedenou na malá písmena pomocí pravidel malých písmen zadané jazykové verze.

ToLower()

Zdroj:: String.Manipulation.cs

Zdroj:: String.Manipulation.cs

Zdroj:: String.Manipulation.cs

Zdroj:: String.Manipulation.cs

Zdroj:: String.Manipulation.cs

Vrátí kopii tohoto řetězce převedenou na malá písmena.

public:
 System::String ^ ToLower();

public string ToLower();

member this.ToLower : unit -> string

Public Function ToLower () As String

Návraty

String

Řetězec malými písmeny.

Příklady

Následující příklad převede několik řetězců smíšených malých písmen na malá písmena.

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

open System

let info = [| "Name"; "Title"; "Age"; "Location"; "Gender" |]

printfn "The initial values in the array are:"
for s in info do
    printfn $"{s}"

printfn $"{Environment.NewLine}The lowercase of these values is:"

for s in info do
    printfn $"{s.ToLower()}"

printfn $"{Environment.NewLine}The uppercase of these values is:"

for s in info do
    printfn $"{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

Dim info As String() = {"Name", "Title", "Age", "Location", "Gender"}

Console.WriteLine("The initial values in the array are:")

Dim s As String
For Each s In info
    Console.WriteLine(s)
Next

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

For Each s In info
    Console.WriteLine(s.ToLower())
Next

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

For Each s In info
    Console.WriteLine(s.ToUpper())
Next

' 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

Poznámky

Tato metoda bere v úvahu pravidla velikostí a velikostí v aktuální jazykové verzi.

Note

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny znaky v aktuální instanci převedeny na malá písmena.

Operace casingu, která je výsledkem volání ToLower() metody, bere v úvahu konvence velikostí a velikostí v aktuální jazykové verzi. Pokud potřebujete malá nebo velká písmena identifikátoru operačního systému, například název souboru, pojmenovaný kanál nebo klíč registru, použijte ToLowerInvariant metody nebo ToUpperInvariant metody. Výsledkem je stejný výsledek v každé jazykové verzi (na rozdíl od ToLower() metody) a funguje efektivněji.

Poznámky pro volající

Jak je vysvětleno v osvědčených postupech pro používání řetězců, doporučujeme vyhnout se volání metod pro vkládání řetězců, které nahrazují výchozí hodnoty a místo toho volají metody, které vyžadují explicitní zadání parametrů. Chcete-li převést znak na malá písmena pomocí konvencí písmen aktuální jazykové verze, signalizovat záměr explicitně voláním ToLower(CultureInfo) přetížení metody s hodnotou CurrentCulture pro jeho culture parametr. Pokud nepotřebujete lingvistické porovnání, zvažte použití .Ordinal

Viz také

Platí pro

ToLower(CultureInfo)

Zdroj:: String.Manipulation.cs

Zdroj:: String.Manipulation.cs

Zdroj:: String.Manipulation.cs

Zdroj:: String.Manipulation.cs

Zdroj:: String.Manipulation.cs

Vrátí kopii tohoto řetězce převedenou na malá písmena pomocí pravidel malých písmen zadané jazykové verze.

public:
 System::String ^ ToLower(System::Globalization::CultureInfo ^ culture);

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

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

member this.ToLower : System.Globalization.CultureInfo -> string

Public Function ToLower (culture As CultureInfo) As String

Parametry

culture: CultureInfo

Objekt, který poskytuje pravidla casingu specifická pro jazykovou verzi. Pokud culture je null, použije se aktuální jazyková verze.

Návraty

String

Malá písmena odpovídající aktuálnímu řetězci.

Příklady

Následující příklad převede dva řetězce velkých písmen na malá písmena pomocí English-USA a Turkish-Turkey jazykové verze a pak porovná řetězce s malými písmeny. Velké řetězce jsou shodné s tím rozdílem, že pro každý výskyt znaku Unicode LATIN CAPITAL LETTER I v jednom řetězci obsahuje druhý řetězec 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
*/

// Sample for String.ToLower(CultureInfo)

open System
open System.Globalization

let codePoints title s =
     printf $"{Environment.NewLine}The code points in {title} are: {Environment.NewLine}"
     for u in s do
          printf $"{u:x4} "
     printfn ""

let str1 = "INDIGO"
// str2 = str1, except each 'I' is '\u0130' (Unicode LATIN CAPITAL I WITH DOT ABOVE).
let str2 = String [| '\u0130'; 'N'; 'D'; '\u0130'; 'G'; 'O' |]

printfn $"\nstr1 = '{str1}'\n"

printfn $"""str1 is {if 0 = String.CompareOrdinal(str1, str2) then "equal" else "not equal"} to str2."""
codePoints "str1" str1
codePoints "str2" str2

// str3 is a lower case copy of str2, using English-United States culture.
printfn "\nstr3 = Lower case copy of str2 using English-United States culture."
let str3 = str2.ToLower(CultureInfo("en-US", false))

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

// Compare the code points in str3 and str4.
printfn $"""\nstr3 is {if 0 = String.CompareOrdinal(str3, str4) then "equal" else "not equal"} to str4."""
     
codePoints "str3" str3
codePoints "str4" str4

(*
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
*)

Public Shared Sub Run()
    Dim str1 As [String] = "INDIGO"
    ' str2 = str1, except each 'I' is '\u0130' (Unicode LATIN CAPITAL I WITH DOT ABOVE).
    Dim str2 As New [String](New [Char]() {ChrW(&H130), "N"c, "D"c, ChrW(&H130), "G"c, "O"c})
    Dim str3, str4 As [String]

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

    Console.WriteLine()
    Console.WriteLine("str1 is {0} to str2.",
                     IIf(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.",
                     IIf(0 = [String].CompareOrdinal(str3, str4), "equal", "not equal"))
    CodePoints("str3", str3)
    CodePoints("str4", str4)
End Sub

Public Shared Sub CodePoints(title As [String], s As [String])
    Console.Write("{0}The code points in {1} are: {0}", Environment.NewLine, title)
    Dim c As Char
    For Each c In s
        Console.Write("{0:x4} ", AscW(c))
    Next c
    Console.WriteLine()
End Sub

'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

Poznámky

Pravidla velikosti písmen jazykové verze určené parametrem culture určují způsob změny velikosti písmen řetězce.

Note

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny znaky v aktuální instanci převedeny na malá písmena.

Pokud předáte metodu jiného objektu ToLower(CultureInfo)CultureInfo než CultureInfo.InvariantCulture, operace casing vezme v úvahu pravidla specifická pro jazykovou verzi. Pokud potřebujete malá nebo velká písmena identifikátoru operačního systému, například název souboru, pojmenovaný kanál nebo klíč registru, použijte metodu nebo ToLowerInvariant metoduToUpperInvariant. Výsledkem je stejný výsledek v každé jazykové verzi a funguje efektivněji.

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?