Strings.StrConv(String, VbStrConv, Int32) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Strings.vb

Retorna uma cadeia de caracteres convertida conforme especificado.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? StrConv (string? str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string

Public Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As String

Parâmetros

str

String

Necessário. String expressão a ser convertida.

Conversion

VbStrConv

Necessário. VbStrConv membro. O valor de enumeração que especifica o tipo de conversão a ser executada.

LocaleID

Int32

Opcional. O valor LocaleID, se diferente do sistema LocaleID valor. (O valor de LocaleID do sistema é o padrão.)

Retornos

String

Uma cadeia de caracteres convertida conforme especificado.

Atributos

SupportedOSPlatformAttribute

Exceções

ArgumentException

LocaleIDsem suporte, Conversion< 0 ou > 2048 ou conversão sem suporte para a localidade especificada.

Exemplos

Este exemplo converte texto em todas as letras minúsculas.

Dim sText As String = "Hello World"
' Returns "hello world".
Dim sNewText As String = StrConv(sText, VbStrConv.LowerCase)

Comentários

As constantes VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakanae VbStrConv.Hiragana podem causar erros em tempo de execução quando usadas em localidades em que não se aplicam, mas nem sempre: as constantes VbStrConv.Katakana e VbStrConv.Hiragana podem ser usadas em um sistema não japonês com o Pacote de Idiomas Japonês instalado. Além disso, há suporte para o uso das constantes VbStrConv.Wide e VbStrConv.Narrow em qualquer sistema com um idioma do Leste Asiático instalado.

Essa função usa as informações de cultura do aplicativo ao manipular a cadeia de caracteres para que as alterações de caso sejam apropriadas para a localidade na qual o aplicativo está sendo usado.

Importante

Se o aplicativo tomar decisões de segurança com base no resultado de uma operação de comparação ou alteração de caso, a operação deverá usar o método String.Compare e passar Ordinal ou OrdinalIgnoreCase para o argumento comparisonType. Para obter mais informações, consulte Como a cultura afeta cadeias de caracteres no Visual Basic.

As configurações do argumento Conversion são:

Membro de enumeração	Descrição
VbStrConv.None	Não executa nenhuma conversão
VbStrConv.LinguisticCasing	Usa regras linguísticas para casing, em vez de Sistema de Arquivos (padrão). Válido apenas com VbStrConv.UpperCase e VbStrConv.LowerCase.
VbStrConv.UpperCase	Converte a cadeia de caracteres em caracteres maiúsculos.
VbStrConv.LowerCase	Converte a cadeia de caracteres em caracteres minúsculos.
VbStrConv.ProperCase	Converte a primeira letra de cada palavra na cadeia de caracteres em maiúscula.
VbStrConv.Wide *	Converte caracteres estreitos (meia largura) na cadeia de caracteres em caracteres largos (largura total). A conversão pode usar o Formulário de Normalização C mesmo se um caractere de entrada já tiver largura total. Por exemplo, a cadeia de caracteres "は ゙" (que já é de largura total) é normalizada como "ば". Consulte formulários de normalização Unicode.
VbStrConv.Narrow *	Converte caracteres largos (largura total) na cadeia de caracteres para caracteres estreitos (meia largura).
VbStrConv.Katakana **	Converte caracteres Hiragana na cadeia de caracteres em caracteres Katakana.
VbStrConv.Hiragana **	Converte caracteres Katakana na cadeia de caracteres em caracteres Hiragana.
VbStrConv.SimplifiedChinese *	Converte caracteres chineses tradicionais em chinês simplificado.
VbStrConv.TraditionalChinese *	Converte caracteres chineses simplificados em chinês tradicional.

^* aplica-se a localidades asiáticas.

^** aplica-se somente ao Japão.

Nota

Essas constantes são especificadas no common language runtime do .NET Framework. Como resultado, eles podem ser usados em qualquer lugar em seu código no lugar dos valores reais. A maioria pode ser combinada (por exemplo, UpperCase + Wide), exceto quando são mutuamente exclusivas (por exemplo, VbStrConv.Wide + VbStrConv.Narrow).

Veja a seguir separadores de palavras válidos para maiúsculas e minúsculas: Nulo (Chr$(0)), guia horizontal (Chr$(9)), feed de linha (Chr$(10)), guia vertical (Chr$(11)), feed de formulário (Chr$(12)), retorno de carro (Chr$(13)), espaço (conjunto de caracteres de byte único) (Chr$(32)). O valor real de um espaço, que pode ter largura total ou meia, varia de acordo com país/região para culturas do Leste Asiático.

Confira também

• Chr(Int32)
• ChrW(Int32)
• String
• ArgumentException
• resumo da manipulação de cadeia de caracteres
• Funções de conversão de tipo