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.
public static string StrConv(string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> stringPublic Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As StringParâmetros
- str
- String
Required.
String expressão a ser convertida.
- Conversion
- VbStrConv
Required. VbStrConv Membro. O valor de enumeração que especifica o tipo de conversão a ser executada.
- LocaleID
- Int32
Optional. O LocaleID valor, se diferente do valor do sistema LocaleID . (O valor do sistema LocaleID é o padrão.)
Retornos
Uma cadeia de caracteres convertida conforme especificado.
Exceções
Sem suporte LocaleID, 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 constantesVbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, , VbStrConv.TraditionalChinesee VbStrConv.KatakanaVbStrConv.Hiragana podem causar erros em tempo de execução quando usadas em localidades onde elas 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, há suporte para o uso das constantes VbStrConv.Wide em VbStrConv.Narrow 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 de 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, consulte How Culture Affects Strings in Visual Basic.
As Conversion configurações de argumento são:
| Membro de enumeração | Description |
|---|---|
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 com VbStrConv.UpperCase e VbStrConv.LowerCase somente. |
VbStrConv.UpperCase |
Converte a cadeia de caracteres em caracteres maiúsculas. |
VbStrConv.LowerCase |
Converte a cadeia de caracteres em caracteres minúsculas. |
VbStrConv.ProperCase |
Converte a primeira letra de cada palavra na cadeia de caracteres em maiúsculas. |
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.
Observação
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 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: 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.