Função SeqConv

Retorna uma sequência de caracteres convertida como especificado.

Public Shared Function StrConv( _
   ByVal str As String, _
   ByVal Conversion As Microsoft.VisualBasic.VbStrConv, _
   Optional ByVal LocaleID As Integer, 
) As String

Parâmetros

  • str
    Obrigatório.String expressão a ser convertido.

  • Conversion
    Obrigatório.Enumeração VbStrConv membro. O valor de enumeração especificando o tipo de conversão para executar.

  • LocaleID
    Opcional.O valor LocaleID, se for diferente do valor cultural atual do aplicativo.Para obter mais informações sobre identificações de localidade e cultura informações, consulte CultureInfo.(Valor cultural atual do aplicativo é o padrão).

Configurações

As configurações do argumento Conversion são:

Membro de enumeração

Descrição

VbStrConv.None

Não realiza nenhuma conversão.

VbStrConv.LinguisticCasing

Usa regras linguísticas para capitalização, em vez do sistema de arquivos (padrão).Válido somente com VbStrConv.UpperCase e VbStrConv.LowerCase.

VbStrConv.UpperCase

Converte a string para caracteres maiúsculos.

VbStrConv.LowerCase

Converte a string para caracteres minúsculos.

VbStrConv.ProperCase

Converte a primeira letra de cada palavra na string para maiúscula.

VbStrConv.Wide*

Converte caracteres estreitos na sequência de caracteres para caracteres largos.

VbStrConv.Narrow*

Converte caracteres largos na sequência de caracteres para caracteres estreitos.

VbStrConv.Katakana**

Converte caracteres Hiragana na string para caracteres Katakana.

VbStrConv.Hiragana**

Converte caracteres Katakana na string para caracteres Hiragana.

VbStrConv.SimplifiedChinese*

Converte caracteres chinês tradicional para chinês simplificado.

VbStrConv.TraditionalChinese*

Converte caracteres chinês simplificadol para chinês tradicional.

* Aplica-se a localidades asiáticas.

** se aplica apenas ao Japão.

Observação:

Essas constantes são especificadas no Common Language Runtime do Framework .NET.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 eles são mutuamente exclusivo (por exemplo, VbStrConv.Wide + VbStrConv.Narrow).

Separadores de palavras válido para letras maiúsculas e minúsculas adequada são: Nulo (Chr$(0)), () guia horizontalChr$(9)), feed de linha ()Chr$(10)), tabulação vertical ()Chr$(11)), feed de formulário ()Chr$(12)), retorno de cursor ()Chr$(13)), () espaço (conjunto de caractere de byte único)Chr$(32)). O valor real para um espaço, que pode ser total ou meia largura, varia de acordo por país/região para culturas do Leste Asiático.

Exceções

Tipo de exceção

Número de erro

Condição

ArgumentException

5

Não há suporte para LocaleID, Conversion < 0 ou > 2048, ou sem suporte de conversão de localidade especificada.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

As constantes VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana, e VbStrConv.Hiragana pode causar erros de time de execução quando usadas em localidades onde não se aplicam, mas nem sempre: as constantes VbStrConv.Katakana e VbStrConv.Hiragana pode ser usado em um sistema japonês não com o empacotar de linguagem japonês instalado. Além disso, o uso das constantes VbStrConv.Wide e VbStrConv.Narrow é suportado em qualquer sistema com um idioma do Leste Asiático instalado.

Essa função usa informações de cultura do aplicativo ao manipular a sequência de caracteres para que as alterações sejam apropriadas para a localidade no qual o aplicativo está sendo usado.

Observação de segurança:

Se seu aplicativo toma decisões de segurança com base no resultado de uma comparação ou a operação de alterar de caso, a operação deve usar o String.Compare método e passar Ordinal ou OrdinalIgnoreCase para o comparisonType argumento. Para obter mais informações, consulte Como a cultura afeta strings no Visual Basic.

Exemplo

Este exemplo converte todas as letras do texto para minúsculas.

Dim sText As String = "Hello World"
' Returns "hello world".
Dim sNewText As String = StrConv(sText, VbStrConv.LowerCase)

Anotações Developer Dispositivo Inteligente

Não há suporte para esta função.

Requisitos

Namespace:Microsoft.VisualBasic

**Módulo:**Strings

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Sumário de Manipulação de Strings

Funções Chr, ChrW

Tipo de dados de sequência de caracteres (Visual Basic)

Funções de conversão de tipo 

ArgumentException