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

  • Referência

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Origem:
Strings.vb
Origem:
Strings.vb
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);
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
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

Obrigatórios. Expressão String a ser convertida.

Conversion
VbStrConv

Obrigatórios. Membro de VbStrConv. O valor de enumeração que especifica o tipo de conversão a ser executado.

LocaleID
Int32

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

Retornos

String

Uma cadeia de caracteres convertida, conforme especificado.

Atributos
SupportedOSPlatformAttribute

Exceções

ArgumentException

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

Exemplos

Este exemplo converte o 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 e VbStrConv.Hiragana podem ser usadas VbStrConv.Katakana em um sistema não japonês com o Pacote de Idiomas Japonês instalado. Além disso, o uso das constantes VbStrConv.Wide e VbStrConv.Narrow tem suporte 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 maiúsculas e minúsculas 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 String.Compare método e passar Ordinal ou OrdinalIgnoreCase para o comparisonType argumento. Para obter mais informações, confira 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 uso de maiúsculas e minúsculas, 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 em cadeia de caracteres em maiúsculas.
VbStrConv.Wide * Converte caracteres estreitos (meia largura) na cadeia de caracteres em caracteres largos (largura inteira). A conversão poderá usar o Formulário de Normalização C mesmo se um caractere de entrada já for de largura inteira. Por exemplo, a cadeia de caracteres "は゛" (que já é de largura inteira) é normalizada para "ば". Consulte Formato de normalização Unicode.
VbStrConv.Narrow * Converte caracteres largos (largura inteira) na cadeia de caracteres em caracteres estreitos (meia largura).
VbStrConv.Katakana ** Converte os caracteres Hiragana da cadeira de caracteres em caracteres Katakana.
VbStrConv.Hiragana ** Converte os caracteres Katakana da cadeira 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.

Observação

Essas constantes são especificadas no .NET Framework Common Language Runtime. 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 elas são mutuamente exclusivas (por exemplo, VbStrConv.Wide + VbStrConv.Narrow).

Veja a seguir separadores de palavras válidos para maiúsculas e minúsculas adequadas: Null (Chr$(0)), guia horizontal (Chr$(9)), alimentação 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 o país/região das culturas do Leste Asiático.

Aplica-se a

Confira também