TextInfo.ToUpper Метод

Определение

Преобразует заданный знак или строку в верхний регистр.

Перегрузки

ToUpper(Char)

Преобразует заданный знак в верхний регистр.

ToUpper(String)

Преобразует заданную строку в верхний регистр.

Примеры

В следующем примере кода изменяется регистр строки на основе языка и региональных параметров "Английский (США)" с именем языка и региональных параметров en-US.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Defines the String* with mixed casing.
   String^ myString = "wAr aNd pEaCe";
   
   // Creates a TextInfo based on the S"en-US" culture.
   CultureInfo^ MyCI = gcnew CultureInfo( "en-US",false );
   TextInfo^ myTI = MyCI->TextInfo;
   
   // Changes a String* to lowercase.
   Console::WriteLine( "\"{0}\" to lowercase: {1}", myString, myTI->ToLower( myString ) );
   
   // Changes a String* to uppercase.
   Console::WriteLine( "\"{0}\" to uppercase: {1}", myString, myTI->ToUpper( myString ) );
   
   // Changes a String* to titlecase.
   Console::WriteLine( "\"{0}\" to titlecase: {1}", myString, myTI->ToTitleCase( myString ) );
}

/*
This code produces the following output.

S"wAr aNd pEaCe" to lowercase: war and peace
S"wAr aNd pEaCe" to uppercase: WAR AND PEACE
S"wAr aNd pEaCe" to titlecase: War And Peace

*/
using System;
using System.Globalization;

public class SamplesTextInfo  {

   public static void Main()  {

      // Defines the string with mixed casing.
      string myString = "wAr aNd pEaCe";

      // Creates a TextInfo based on the "en-US" culture.
      TextInfo myTI = new CultureInfo("en-US",false).TextInfo;

      // Changes a string to lowercase.
      Console.WriteLine( "\"{0}\" to lowercase: {1}", myString, myTI.ToLower( myString ) );

      // Changes a string to uppercase.
      Console.WriteLine( "\"{0}\" to uppercase: {1}", myString, myTI.ToUpper( myString ) );

      // Changes a string to titlecase.
      Console.WriteLine( "\"{0}\" to titlecase: {1}", myString, myTI.ToTitleCase( myString ) );
   }
}

/*
This code produces the following output.

"wAr aNd pEaCe" to lowercase: war and peace
"wAr aNd pEaCe" to uppercase: WAR AND PEACE
"wAr aNd pEaCe" to titlecase: War And Peace

*/
Imports System.Globalization

Public Class SamplesTextInfo

   Public Shared Sub Main()

      ' Defines the string with mixed casing.
      Dim myString As String = "wAr aNd pEaCe"

      ' Creates a TextInfo based on the "en-US" culture.
      Dim myTI As TextInfo = New CultureInfo("en-US", False).TextInfo

      ' Changes a string to lowercase.
      Console.WriteLine("""{0}"" to lowercase: {1}", myString, myTI.ToLower(myString))

      ' Changes a string to uppercase.
      Console.WriteLine("""{0}"" to uppercase: {1}", myString, myTI.ToUpper(myString))

      ' Changes a string to titlecase.
      Console.WriteLine("""{0}"" to titlecase: {1}", myString, myTI.ToTitleCase(myString))

   End Sub

End Class


'This code produces the following output.
'
'"wAr aNd pEaCe" to lowercase: war and peace
'"wAr aNd pEaCe" to uppercase: WAR AND PEACE
'"wAr aNd pEaCe" to titlecase: War And Peace

ToUpper(Char)

Преобразует заданный знак в верхний регистр.

public:
 virtual char ToUpper(char c);
public:
 char ToUpper(char c);
public virtual char ToUpper (char c);
public char ToUpper (char c);
abstract member ToUpper : char -> char
override this.ToUpper : char -> char
member this.ToUpper : char -> char
Public Overridable Function ToUpper (c As Char) As Char
Public Function ToUpper (c As Char) As Char

Параметры

c
Char

Знак для преобразования в верхний регистр.

Возвращаемое значение

Char

Заданный знак, преобразуемый в верхний регистр.

Комментарии

Семантика регистра зависит от используемого языка и региональных параметров. Для инвариантного языка и региональных параметров семантика регистра не учитывает язык и региональные параметры. Для конкретного языка и региональных параметров семантика регистра чувствительна к этому языку и региональным параметрам.

Если решение о безопасности зависит от сравнения строк или операции изменения регистра, приложение должно использовать, InvariantCulture чтобы обеспечить целостность поведения независимо от настроек языка и региональных параметров системы. Однако инвариантные язык и региональные параметры должны использоваться только процессами, для которых требуются независимые от языка и региональных параметров результаты, например системные службы. В противном случае он выдает результаты, которые могут быть лингвистически неверными или культурно недопустимыми.

Дополнительные сведения о культурах см. в разделе CultureInfo .

См. также раздел

Применяется к

ToUpper(String)

Преобразует заданную строку в верхний регистр.

public:
 virtual System::String ^ ToUpper(System::String ^ str);
public:
 System::String ^ ToUpper(System::String ^ str);
public virtual string ToUpper (string str);
public string ToUpper (string str);
abstract member ToUpper : string -> string
override this.ToUpper : string -> string
member this.ToUpper : string -> string
Public Overridable Function ToUpper (str As String) As String
Public Function ToUpper (str As String) As String

Параметры

str
String

Строка для преобразования в верхний регистр.

Возвращаемое значение

String

Заданная строка, преобразуемая в верхний регистр.

Исключения

Параметр str имеет значение null.

Комментарии

Возвращаемая строка может отличаться от длины входной строки. Дополнительные сведения о регистре см. в техническом отчете Юникод #21 "сопоставления вариантов", опубликованных консорциумом Unicode Consortium ( https://www.unicode.org) . Текущая реализация сохраняет длину строки. Однако это поведение не гарантируется и может измениться в будущих реализациях.

Семантика регистра зависит от используемого языка и региональных параметров. Для инвариантного языка и региональных параметров семантика регистра не учитывает язык и региональные параметры. Для конкретного языка и региональных параметров семантика регистра чувствительна к этому языку и региональным параметрам.

Если решение о безопасности зависит от сравнения строк или операции изменения регистра, приложение должно использовать, InvariantCulture чтобы обеспечить целостность поведения независимо от настроек языка и региональных параметров системы. Однако инвариантные язык и региональные параметры должны использоваться только процессами, для которых требуются независимые от языка и региональных параметров результаты, например системные службы. В противном случае он выдает результаты, которые могут быть лингвистически неверными или культурно недопустимыми.

Дополнительные сведения о культурах см. в разделе CultureInfo .

См. также раздел

Применяется к