Retorna um valor convertido Variant (String).
Sintaxe
StrConv(string, conversion [, LCID])
A StrConv sintaxe da função tem esses argumentos:
| Argumento | Descrição |
|---|---|
string |
Obrigatório. A expressão de cadeia de caracteres a ser convertida. |
conversion |
Obrigatório. Um inteiro. A soma de valores que especifica o tipo de conversão a ser executada. |
LCID |
Opcional. A ID da localidade, se for diferente da ID da localidade do sistema. A ID da localidade do sistema é o padrão. |
Configurações
As conversion configurações de argumento são:
| Constante | Valor | Descrição |
|---|---|---|
vbUpperCase |
1 | Converte a cadeia de caracteres em caracteres maiúsculas. |
vbLowerCase |
2 | Converte a cadeia de caracteres em caracteres minúsculas. |
vbProperCase |
3 | Converte a primeira letra de cada palavra na cadeia de caracteres em maiúsculas. |
vbWide * |
4* | Converte caracteres estreitos (bytes únicos) na cadeia de caracteres em caracteres largos (bytes duplos). |
vbNarrow * |
8* | Converte caracteres largos (bytes duplos) na cadeia de caracteres para caracteres estreitos (bytes únicos). |
vbKatakana ** |
16** | Converte caracteres Hiragana na cadeia de caracteres em caracteres Katakana. |
vbHiragana ** |
32** | Converte caracteres Katakana na cadeia de caracteres em caracteres Hiragana. |
vbUnicode |
64 | Converte a cadeia de caracteres em Unicode usando a página de código padrão do sistema. (Não disponível em Macintosh.) |
vbFromUnicode |
128 | Converte a cadeia de caracteres do Unicode na página de código padrão do sistema. (Não disponível em Macintosh.) |
*Aplica-se a localidades do leste da Ásia.
**Aplica-se somente ao Japão.
Observação
Visual Basic for Applications (VBA) especifica essas constantes. Você pode usá-los em qualquer lugar do código, em vez dos valores reais. Você pode combinar a maioria das constantes. Por exemplo, use vbUpperCase + vbWide. Não combine constantes mutuamente exclusivas. Por exemplo, não use vbUnicode + vbFromUnicode. As vbWideconstantes , vbNarrow, vbKatakanae vbHiragana causam erros de tempo de execução quando você as usa em localidades em que elas não se aplicam.
A seguir estão separadores de palavras válidos para invólucro adequado: nulo (Chr$(0)), guia horizontal (Chr$(9)), feed de linha (Chr$(10)), guia vertical (Chr$(11)), feed de formulário (Chr$(12)), retorno de transporte (Chr$(13)) e espaço (SBCS) (Chr$(32)). Para DBCS, o valor real de um espaço varia de acordo com o país ou região.
Comentários
Quando você estiver convertendo uma Byte matriz no formato ANSI em uma cadeia de caracteres, use a StrConv função. Quando você estiver convertendo o mesmo tipo de matriz no formato Unicode, use uma instrução de atribuição.
Exemplos de consulta
| Expressão. | Resultados |
|---|---|
SELECT StrConv(ProductDesc,1) AS Expr1 FROM ProductSales; |
Converte valores do campo para maiúsculas ProductDesc e os exibe na Expr1 coluna. |
SELECT StrConv(ProductDesc,2) AS LowercaseID FROM ProductSales; |
Converte valores do ProductDesc campo em minúsculas e exibe-os na LowercaseID coluna. |
Exemplo de VBA
Observação
Os exemplos a seguir mostram como usar essa função em um módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
Este exemplo usa a StrConv função para converter uma cadeia de caracteres Unicode em uma cadeia de caracteres ANSI.
Dim i As Long
Dim x() As Byte
x = StrConv("ABCDEFG", vbFromUnicode) ' Convert string.
For i = 0 To UBound(x)
Debug.Print x(i)
Next