String.ToLower Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

A sztring kisbetűssé konvertált másolatát adja vissza.

Túlterhelések

Name	Description
ToLower()	A sztring kisbetűssé konvertált másolatát adja vissza.
ToLower(CultureInfo)	Visszaadja ennek a sztringnek a kisbetűssé konvertált másolatát a megadott kultúra casing szabályainak használatával.

ToLower()

Forrás:

String.Manipulation.cs

A sztring kisbetűssé konvertált másolatát adja vissza.

public:
 System::String ^ ToLower();

public string ToLower();

member this.ToLower : unit -> string

Public Function ToLower () As String

Válaszok

String

Kisbetűs sztring.

Példák

Az alábbi példa több vegyes kisbetűs sztringet kisbetűssé alakít át.

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

Megjegyzések

Ez a módszer figyelembe veszi a jelenlegi kultúra casing szabályait.

Note

Ez a metódus nem módosítja az aktuális példány értékét. Ehelyett egy új sztringet ad vissza, amelyben az aktuális példány összes karaktere kisbetűssé lesz konvertálva.

A metódus meghívásából ToLower() eredő casing művelet figyelembe veszi az aktuális kultúra casing konvencióit. Ha szüksége van egy operációs rendszer-azonosító kis- vagy nagybetűs verziójára( például fájlnévre, elnevezett csőre vagy beállításkulcsra), használja a metódusokat vagy ToLowerInvariant a ToUpperInvariant metódusokat. Ez minden kultúrában ugyanazt az eredményt eredményezi (a ToLower() módszertől eltérően), és hatékonyabban teljesít.

Megjegyzések a hívókhoz

A sztringek használatának ajánlott eljárásaiban leírtak szerint javasoljuk, hogy kerülje az alapértelmezett értékeket helyettesítő sztringház metódusok meghívását, és ne hívja meg azokat a metódusokat, amelyekhez paramétereket kell explicit módon megadni. Ha egy karaktert kisbetűssé szeretne alakítani az aktuális kultúra casing konvencióinak használatával, a metódus túlterhelésének meghívásával ToLower(CultureInfo) jelezheti szándékát CurrentCulture a paraméter értékévelculture. Ha nincs szüksége nyelvtudó összehasonlításra, fontolja meg a használatát Ordinal.

Lásd még

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

ToLower(CultureInfo)

Forrás:

String.Manipulation.cs

Visszaadja ennek a sztringnek a kisbetűssé konvertált másolatát a megadott kultúra casing szabályainak használatával.

public:
 System::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

Paraméterek

culture

CultureInfo

Kultúraspecifikus burkolatszabályokat biztosító objektum. Ha culture van null, a jelenlegi kultúrát használják.

Válaszok

String

Az aktuális sztring kisbetűs megfelelője.

Példák

Az alábbi példa két nagybetűs sztringet konvertál kisbetűkké az English-United állapotok és Turkish-Turkey kultúrák használatával, majd összehasonlítja a kisbetűs sztringeket. A nagybetűs sztringek azonosak, azzal a különbséggel, hogy a Unicode LATIN NAGYBETŰS I. sztring minden előfordulása esetében az egyik sztringben a másik sztring a FENTI PONTTAL RENDELKEZŐ LATIN NAGYBETŰT tartalmazza.

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

Megjegyzések

A paraméter által culture megadott kultúra casing szabályai határozzák meg a sztring esetének módosítását.

Note

Ez a metódus nem módosítja az aktuális példány értékét. Ehelyett egy új sztringet ad vissza, amelyben az aktuális példány összes karaktere kisbetűssé lesz konvertálva.

Ha nem egy ToLower(CultureInfo) objektumot CultureInfoad át a CultureInfo.InvariantCulture metódusnak, a casing művelet figyelembe veszi a kultúraspecifikus szabályokat. Ha egy operációsrendszer-azonosító kis- vagy nagybetűs verziójára van szüksége, például fájlnévre, elnevezett csőre vagy beállításkulcsra, használja a vagy ToLowerInvariant a metódustToUpperInvariant. Ez minden kultúrában ugyanazt az eredményt eredményezi, és hatékonyabban teljesít.

Lásd még

• CultureInfo
• ToUpper()