Devolve um valor convertido Variant (String).
Sintaxe
StrConv(string, conversion [, LCID])
A StrConv sintaxe da função tem estes argumentos:
| Argumento | Descrição |
|---|---|
string |
Obrigatório. A expressão de cadeia a converter. |
conversion |
Obrigatório. Um número inteiro. A soma dos valores que especifica o tipo de conversão a executar. |
LCID |
Opcional. O ID de região, se for diferente do ID de região do sistema. O ID de região do sistema é a predefinição. |
Definições
As conversion definições do 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 em carateres largos (byte duplo). |
vbNarrow * |
8* | Converte carateres largos (byte duplo) na cadeia em carateres estreitos (byte único). |
vbKatakana ** |
16** | Converte carateres hiragana na cadeia em carateres Katakana. |
vbHiragana ** |
32** | Converte carateres katakana na cadeia em carateres Hiragana. |
vbUnicode |
64 | Converte a cadeia em Unicode através da página de código predefinida do sistema. (Não disponível no Macintosh.) |
vbFromUnicode |
128 | Converte a cadeia de carateres de Unicode para a página de código predefinida do sistema. (Não disponível no Macintosh.) |
*Aplica-se às regiões da Ásia Oriental.
**Aplica-se apenas ao Japão.
Nota
Visual Basic for Applications (VBA) especifica estas constantes. Pode utilizá-los em qualquer parte do seu código em vez dos valores reais. Pode combinar a maioria das constantes. Por exemplo, utilize vbUpperCase + vbWide. Não combine constantes mutuamente exclusivas. Por exemplo, não utilize vbUnicode + vbFromUnicode. As vbWideconstantes , vbNarrow, vbKatakanae vbHiragana causam erros de tempo de execução quando os utiliza em regiões onde não se aplicam.
Seguem-se separadores de palavras válidos para maiúsculas/víulas adequadas: Nulo (Chr$(0)), tabulação horizontal (Chr$(9)), avanço de linha (Chr$(10)), tabulação vertical (Chr$(11)), avanço do formulário (Chr$(12)), símbolo de retorno (Chr$(13)) e espaço (SBCS) (Chr$(32)). Para DBCS, o valor real de um espaço varia consoativamente por país ou região.
Comentários
Quando estiver a converter uma Byte matriz no formato ANSI numa 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 valores do ProductDesc campo em maiúsculas e apresenta-os na Expr1 coluna. |
SELECT StrConv(ProductDesc,2) AS LowercaseID FROM ProductSales; |
Converte valores do ProductDesc campo em minúsculas e apresenta-os na LowercaseID coluna. |
Exemplo de VBA
Nota
Os exemplos seguintes 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 Programador na lista pendente junto a Procurar e, em seguida, introduza um ou mais termos na caixa de pesquisa.
Este exemplo utiliza a StrConv função para converter uma cadeia Unicode numa cadeia 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