Strings.StrConv(String, VbStrConv, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Uma cadeia de caracteres convertida, conforme especificado.
- Atributos
Exceções
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.Katakana
e 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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de