Esta documentación está archivada y no tiene mantenimiento.

String.ToUpperInvariant (Método)

Nota: este método es nuevo en la versión 2.0 de .NET Framework.

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.

Espacio de nombres: System
Ensamblado: mscorlib (en mscorlib.dll)

public string ToUpperInvariant ()
public String ToUpperInvariant ()
public function ToUpperInvariant () : String

Valor devuelto

Un objeto String en mayúsculas.

Si la aplicación depende de que las mayúsculas y minúsculas de una cadena cambien de forma predecible que no afecta a la referencia cultural que se encuentra en vigor, utilice el método ToUpperInvariant. El método ToUpperInvariant es equivalente a ToUpper(CultureInfo.InvariantCulture).

Consideraciones de seguridad

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

En el siguiente ejemplo de código, se convierte una cadena de caracteres minúsculas en dos cadenas de caracteres mayúsculas utilizando las referencias culturales Inglés-Estados Unidos y Turco-Turquía y, a continuación, se comparan las cadenas en mayúsculas. Las cadenas en mayúsculas son idénticas, salvo que por cada aparición de la letra mayúscula latina Unicode I en una cadena, la otra cadena contiene la letra mayúscula latina I con un punto encima de la misma.

// Sample for String.ToUpper(CultureInfo)
using System;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
    String str1 = "indigo";
    String str2, str3;

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

    Console.WriteLine("str2 = Upper case copy of str1 using English-United States culture.");
    // str2 is an upper case copy of str1, using English-United States culture.
    str2 = str1.ToUpper(new CultureInfo("en-US", false));

    // str3 is an upper case copy of str1, using Turkish-Turkey culture.
    Console.WriteLine("str3 = Upper case copy of str1 using Turkish-Turkey culture.");
    str3 = str1.ToUpper(new CultureInfo("tr-TR", false));

    // Compare the code points in str2 and str3.
    Console.WriteLine();
    Console.WriteLine("str2 is {0} to str3.", 
         ((0 == String.CompareOrdinal(str2, str3)) ? "equal" : "not equal"));
    CodePoints("str1", str1);
    CodePoints("str2", str2);
    CodePoints("str3", str3);
    }

    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'
str2 = Upper case copy of str1 using English-United States culture.
str3 = Upper case copy of str1 using Turkish-Turkey culture.

str2 is not equal to str3.

The code points in str1 are:
0069 006e 0064 0069 0067 006f

The code points in str2 are:
0049 004e 0044 0049 0047 004f

The code points in str3 are:
0130 004e 0044 0130 0047 004f
*/

// Sample for String.ToUpper(CultureInfo)
import System.*;
import System.Globalization.*;

class Sample
{
    public static void main(String[] args)
    {
        String str1 = "indigo";
        String str2, str3;

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

        Console.WriteLine("str2 = Upper case copy of str1 using English-"
            + "United States culture.");

        // str2 is an upper case copy of str1, using English-United States 
        // culture.
        str2 = str1.ToUpper(new CultureInfo("en-US", false));

        // str3 is an upper case copy of str1, using Turkish-Turkey culture.
        Console.WriteLine("str3 = Upper case copy of str1 using Turkish-"
            + "Turkey culture.");
        str3 = str1.ToUpper(new CultureInfo("tr-TR", false));

        // Compare the code points in str2 and str3.
        Console.WriteLine();
        Console.WriteLine("str2 is {0} to str3.", 
            (0 == String.CompareOrdinal(str2, str3)) ? "equal" : "not equal");
        CodePoints("str1", str1);
        CodePoints("str2", str2);
        CodePoints("str3", str3);
    } //main

    public static void CodePoints(String title, String s)
    {
        Console.Write("{0}The code points in {1} are: {0}", 
            Environment.get_NewLine(), title);
        for (int iCtr = 0; iCtr < s.get_Length(); iCtr++) {
            UInt16 u = (UInt16)s.charAt(iCtr);
            Console.Write("{0:x4} ", u);
        }
        Console.WriteLine();
    } //CodePoints
} //Sample
/*
This example produces the following results:

str1 = 'indigo'
str2 = Upper case copy of str1 using English-United States culture.
str3 = Upper case copy of str1 using Turkish-Turkey culture.

str2 is not equal to str3.

The code points in str1 are:
0069 006e 0064 0069 0067 006f

The code points in str2 are:
0049 004e 0044 0049 0047 004f

The code points in str3 are:
0130 004e 0044 0130 0047 004f
*/

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0

.NET Compact Framework

Compatible con: 2.0
Mostrar: