String.ToUpperInvariant Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

String.Manipulation.cs

Devuelve una copia de este objeto String convertido en mayúsculas, aplicando las reglas de mayúsculas y minúsculas de la referencia cultural de todos los idiomas.

public:
 System::String ^ ToUpperInvariant();

public string ToUpperInvariant ();

member this.ToUpperInvariant : unit -> string

Public Function ToUpperInvariant () As String

Devoluciones

String

Equivalente en mayúsculas de la cadena actual.

Ejemplos

En el ejemplo siguiente se define una matriz de cadenas que contiene una sola palabra en varios idiomas. El ToUpperInvariant método se usa para rellenar los elementos de una matriz paralela con la versión sin distinción entre mayúsculas y minúsculas de cada palabra. El Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) método se usa para ordenar la matriz que distingue mayúsculas de minúsculas en función del orden de los elementos de la matriz en mayúsculas para asegurarse de que los elementos aparecen en el mismo orden, independientemente del idioma.

using System;
using System.IO;

public class Example
{
   public static void Main()
   {
      string[] words = { "Tuesday", "Salı", "Вторник", "Mardi", 
                         "Τρίτη", "Martes", "יום שלישי", 
                         "الثلاثاء", "วันอังคาร" };
      StreamWriter sw = new StreamWriter(@".\output.txt");
            
      // Display array in unsorted order.
      foreach (string word in words)
         sw.WriteLine(word);

      sw.WriteLine();

      // Create parallel array of words by calling ToUpperInvariant.
      string[] upperWords = new string[words.Length];
      for (int ctr = words.GetLowerBound(0); ctr <= words.GetUpperBound(0); ctr++)
         upperWords[ctr] = words[ctr].ToUpperInvariant();
      
      // Sort the words array based on the order of upperWords.
      Array.Sort(upperWords, words, StringComparer.InvariantCulture);
      
      // Display the sorted array.
      foreach (string word in words)
         sw.WriteLine(word);

      sw.Close();      
   }
}
// The example produces the following output:
//       Tuesday
//       Salı
//       Вторник
//       Mardi
//       Τρίτη
//       Martes
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
//       
//       Mardi
//       Martes
//       Salı
//       Tuesday
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร

open System
open System.IO

do
    let words = 
        [| "Tuesday"; "Salı"; "Вторник"; "Mardi" 
           "Τρίτη"; "Martes"; "יום שלישי" 
           "الثلاثاء"; "วันอังคาร" |]
    use sw = new StreamWriter(@".\output.txt")
        
    // Display array in unsorted order.
    for word in words do
        sw.WriteLine word

    sw.WriteLine()

    // Create parallel array of words by calling ToUpperInvariant.
    let upperWords = words |> Array.map (fun x -> x.ToUpperInvariant())
    
    // Sort the words array based on the order of upperWords.
    Array.Sort(upperWords, words, StringComparer.InvariantCulture)
    
    // Display the sorted array.
    for word in words do
        sw.WriteLine word
    sw.Close()      
// The example produces the following output:
//       Tuesday
//       Salı
//       Вторник
//       Mardi
//       Τρίτη
//       Martes
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
//       
//       Mardi
//       Martes
//       Salı
//       Tuesday
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร

Imports System.IO

Module Example
   Public Sub Main()
      Dim words() As String = { "Tuesday", "Salı", "Вторник", "Mardi", _
                                "Τρίτη", "Martes", "יום שלישי", _
                                "الثلاثاء", "วันอังคาร" }
      Dim sw As New StreamWriter(".\output.txt")
      
      ' Display array in unsorted order.
      For Each word As String In words
         sw.WriteLine(word)
      Next
      sw.WriteLine()

      ' Create parallel array of words by calling ToUpperInvariant.
      Dim upperWords(words.Length - 1) As String
      For ctr As Integer = words.GetLowerBound(0) To words.GetUpperBound(0)
         upperWords(ctr) = words(ctr).ToUpperInvariant()
      Next
      
      ' Sort the words array based on the order of upperWords.
      Array.Sort(upperWords, words, StringComparer.InvariantCulture)
      
      ' Display the sorted array.
      For Each word As String In words
         sw.WriteLine(word)
      Next
      
      sw.Close()
   End Sub
End Module
' The example produces the following output:
'       Tuesday
'       Salı
'       Вторник
'       Mardi
'       Τρίτη
'       Martes
'       יום שלישי
'       الثلاثاء
'       วันอังคาร
'       
'       Mardi
'       Martes
'       Salı
'       Tuesday
'       Τρίτη
'       Вторник
'       יום שלישי
'       الثلاثاء
'       วันอังคาร

Comentarios

La referencia cultural invariable representa una referencia cultural que no distingue la referencia cultural. Está asociado con el idioma inglés, pero no con un país o región específicos. Para obtener más información, vea la propiedad CultureInfo.InvariantCulture.

Si la aplicación depende del caso de que una cadena cambie de forma predecible que no se vea afectada por la referencia cultural actual, use el ToUpperInvariant método . El ToUpperInvariant método es equivalente a ToUpper(CultureInfo.InvariantCulture). El método se recomienda cuando una colección de cadenas debe aparecer en un orden predecible en un control de interfaz de usuario.

Nota

Este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que todos los caracteres de la instancia actual se convierten en mayúsculas.

Si necesita la versión en minúsculas o mayúsculas de un identificador de sistema operativo, como un nombre de archivo, una canalización con nombre o una clave del Registro, use los ToLowerInvariant métodos o ToUpperInvariant .

Consulte también

• ToLowerInvariant()
• ToUpper()
• InvariantCulture