Devolve um valor convertido Variant (String).
Sintaxe
StrConv(string, conversion [, LCID])
A StrConv sintaxe da função tem os seguintes argumentos:
| Argumento | Descrição |
|---|---|
string |
Obrigatório. A expressão de cadeia a converter. |
conversion |
Obrigatório. Um número inteiro. A soma de valores que especifica o tipo de conversão a ser efetuada. |
LCID |
Opcional. O ID local, se for diferente do ID local do sistema. O ID da região do sistema é o padrão. |
Definições
As conversion definições de argumento são:
| Constante | Valor | Descrição |
|---|---|---|
vbUpperCase |
1 | Converte a cadeia em carateres em maiúsculas. |
vbLowerCase |
2 | Converte a cadeia em carateres minúsculos. |
vbProperCase |
3 | Converte a primeira letra de cada palavra na cadeia em maiúsculas. |
vbWide * |
4* | Converte carateres estreitos (byte único) na cadeia para carateres largos (byte duplo). |
vbNarrow * |
8* | Converte carateres largos (byte duplo) na cadeia para carateres estreitos (byte único). |
vbKatakana ** |
16** | Converte os carateres Hiragana na cadeia em carateres Katakana. |
vbHiragana ** |
32** | Converte os carateres Katakana da cadeia em carateres 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 de Unicode na página de código padrão do sistema. (Não disponível em Macintosh.) |
*Aplica-se às regiões da Ásia Oriental.
**Apenas aplicável ao Japão.
Nota
Visual Basic for Applications (VBA) especifica essas constantes. Pode utilizá-los em qualquer parte do seu código em vez dos valores reais. É possível combinar a maior parte das constantes. Por exemplo, utilize vbUpperCase + vbWide. Não combine constantes que se excluam mutuamente. Por exemplo, não utilize vbUnicode + vbFromUnicodeo . As vbWideconstantes , vbNarrow, vbKatakanae vbHiragana causam erros em tempo de execução quando são utilizadas em regiões onde não se aplicam.
Os separadores de palavras válidos a seguir são válidos para o uso correto de maiúsculas: Nulo (Chr$(0)), tabulação horizontal (Chr$(9)), alimentação de linha (Chr$(10)), tabulação vertical (Chr$(11)), alimentação de formulário (Chr$(12)), retorno de carro (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
Ao converter uma Byte matriz no formato ANSI para uma cadeia, utilize a StrConv função. Quando estiver a converter o mesmo tipo de matriz no formato Unicode, utilize uma instrução de atribuição.
Exemplos de consulta
| Expressão | Resultados |
|---|---|
SELECT StrConv(ProductDesc,1) AS Expr1 FROM ProductSales; |
Converte os valores do ProductDesc campo em maiúsculas Expr1 e apresenta-os na coluna. |
SELECT StrConv(ProductDesc,2) AS LowercaseID FROM ProductSales; |
Converte os valores do ProductDesc campo em minúsculas LowercaseID e apresenta-os na coluna. |
Exemplo do VBA
Nota
Os exemplos que se seguem mostram como utilizar esta função num módulo Visual Basic for Applications (VBA). 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