String.ToLower Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce una copia di questa stringa convertita in minuscolo.
Overload
| Nome | Descrizione |
|---|---|
| ToLower() |
Restituisce una copia di questa stringa convertita in minuscolo. |
| ToLower(CultureInfo) |
Restituisce una copia di questa stringa convertita in minuscolo, utilizzando le regole di maiuscole e minuscole delle impostazioni cultura specificate. |
ToLower()
- Origine:
- String.Manipulation.cs
- Origine:
- String.Manipulation.cs
- Origine:
- String.Manipulation.cs
- Origine:
- String.Manipulation.cs
- Origine:
- String.Manipulation.cs
Restituisce una copia di questa stringa convertita in minuscolo.
public:
System::String ^ ToLower();
public string ToLower();
member this.ToLower : unit -> string
Public Function ToLower () As String
Valori restituiti
Stringa in minuscolo.
Esempio
Nell'esempio seguente vengono convertite diverse stringhe maiuscole e minuscole in lettere minuscole.
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
Commenti
Questo metodo tiene conto delle regole di maiuscole e minuscole delle impostazioni cultura correnti.
Note
Questo metodo non modifica il valore dell'istanza corrente. Restituisce invece una nuova stringa in cui tutti i caratteri dell'istanza corrente vengono convertiti in lettere minuscole.
L'operazione di maiuscole e minuscole risultante dalla chiamata al ToLower() metodo tiene conto delle convenzioni di maiuscole e minuscole delle impostazioni cultura correnti. Se è necessaria la versione minuscola o maiuscola di un identificatore del sistema operativo, ad esempio un nome file, una named pipe o una chiave del Registro di sistema, usare i ToLowerInvariant metodi o ToUpperInvariant . Questo produce lo stesso risultato in tutte le impostazioni cultura (a differenza del ToLower() metodo) ed esegue in modo più efficiente.
Note per i chiamanti
Come illustrato in Procedure consigliate per l'uso di stringhe, è consigliabile evitare di chiamare metodi di combinazione di maiuscole e minuscole di stringhe che sostituiscono i valori predefiniti e chiamare invece metodi che richiedono parametri da specificare in modo esplicito. Per convertire un carattere in minuscolo usando le convenzioni di maiuscole e minuscole delle impostazioni cultura correnti, segnalare in modo esplicito l'intenzione chiamando l'overload del ToLower(CultureInfo) metodo con un valore di CurrentCulture per il relativo culture parametro. Se non è necessario un confronto con riconoscimento linguistico, è consigliabile usare Ordinal.
Vedi anche
Si applica a
ToLower(CultureInfo)
- Origine:
- String.Manipulation.cs
- Origine:
- String.Manipulation.cs
- Origine:
- String.Manipulation.cs
- Origine:
- String.Manipulation.cs
- Origine:
- String.Manipulation.cs
Restituisce una copia di questa stringa convertita in minuscolo, utilizzando le regole di maiuscole e minuscole delle impostazioni cultura specificate.
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
Parametri
- culture
- CultureInfo
Oggetto che fornisce regole di maiuscole e minuscole specifiche delle impostazioni cultura. Se culture è null, viene utilizzata l'impostazione cultura corrente.
Valori restituiti
Equivalente minuscolo della stringa corrente.
Esempio
Nell'esempio seguente vengono convertite due stringhe di caratteri maiuscoli in caratteri minuscoli usando le impostazioni cultura English-United Stati e Turkish-Turkey, quindi confronta le stringhe minuscole. Le stringhe maiuscole sono identiche, ad eccezione del fatto che per ogni occorrenza della LETTERA MAIUSCOLA UNICODE I in una stringa, l'altra stringa contiene LA LETTERA MAIUSCOLA LATINA I CON PUNTO SOPRA.
// 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
Commenti
Le regole di maiuscole e minuscole delle impostazioni cultura specificate dal culture parametro determinano la modalità di modifica della combinazione di maiuscole e minuscole della stringa.
Note
Questo metodo non modifica il valore dell'istanza corrente. Restituisce invece una nuova stringa in cui tutti i caratteri dell'istanza corrente vengono convertiti in lettere minuscole.
Se si passa il ToLower(CultureInfo) metodo un CultureInfo oggetto diverso da CultureInfo.InvariantCulture, l'operazione di combinazione di maiuscole e minuscole prenderà in considerazione le regole specifiche delle impostazioni cultura. Se è necessaria la versione minuscola o maiuscola di un identificatore del sistema operativo, ad esempio un nome file, una named pipe o una chiave del Registro di sistema, usare il ToLowerInvariant metodo o ToUpperInvariant . Questo produce lo stesso risultato in tutte le impostazioni cultura ed esegue in modo più efficiente.