Strings.StrConv(String, VbStrConv, Int32) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve uma cadeia convertida conforme especificado.

public static string StrConv(string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string
Public Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As String

Parâmetros

str
String

Required. String expressão a converter.

Conversion
VbStrConv

Required. VbStrConv membro. O valor de enumeração especifica o tipo de conversão a realizar.

LocaleID
Int32

Optional. O LocaleID valor é diferente do valor do sistema LocaleID . (O valor do sistema LocaleID é o padrão.)

Devoluções

String

Uma corda convertida conforme especificado.

Exceções

ArgumentException

Não suportado LocaleID, Conversion< 0 ou > 2048, ou conversão não suportada para local especificado.

Exemplos

Este exemplo converte texto em letras minúsculas.

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

Observações

As constantes VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana, e VbStrConv.Hiragana podem causar erros de execução quando usadas em locais onde não se aplicam, mas nem sempre: as constantes VbStrConv.Katakana e VbStrConv.Hiragana podem ser usadas num sistema não japonês com o Japanese Language Pack instalado. Além disso, o uso das constantes VbStrConv.Wide é VbStrConv.Narrow suportado em qualquer sistema com uma língua do Leste Asiático instalada.

Esta função utiliza a informação de cultura da aplicação ao manipular a string, de modo a que as alterações de caso sejam apropriadas para a localização onde a aplicação está a ser utilizada.

Importante

Se seu aplicativo toma decisões de segurança com base no resultado de uma comparação ou operação de mudança de caso, a operação deve usar o String.Compare método e passar Ordinal ou OrdinalIgnoreCase para o comparisonType argumento. Para mais informações, veja Como a Cultura Afeta as Cordas em Visual Basic.

As Conversion definições argumentais são:

Membro de enumeração Description
VbStrConv.None Não realiza conversão
VbStrConv.LinguisticCasing Utiliza regras linguísticas para o casing, em vez do Sistema de Ficheiros (padrão). Válido só com VbStrConv.UpperCase e VbStrConv.LowerCase apenas.
VbStrConv.UpperCase Converte a cadeia em carateres em maiúsculas.
VbStrConv.LowerCase Converte a cadeia em carateres minúsculos.
VbStrConv.ProperCase Converte a primeira letra de cada palavra na cadeia em maiúsculas.
VbStrConv.Wide * Converte caracteres estreitos (meia largura) na cadeia em caracteres largos (de largura total). A conversão pode usar o Formulário de Normalização C mesmo que um carácter de entrada já seja de largura total. Por exemplo, a cadeia "は ゙" (que já é de largura total) é normalizada para "ば". Ver formulários de normalização Unicode.
VbStrConv.Narrow * Converte caracteres largos (de largura total) na cadeia em caracteres estreitos (meia largura).
VbStrConv.Katakana ** Converte caracteres Hiragana na cadeia em caracteres Katakana.
VbStrConv.Hiragana ** Converte caracteres Katakana na cadeia 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 locais asiáticos.

** Aplica-se apenas ao Japão.

Note

Estas constantes são especificadas no tempo de execução da linguagem comum .NET Framework. Como resultado, podem ser usados em qualquer parte do seu código em vez dos valores reais. A maioria pode ser combinada (por exemplo, UpperCase + Wide), exceto quando são mutuamente exclusivas (por exemplo, VbStrConv.Wide + VbStrConv.Narrow).

Os seguintes são separadores de palavras válidos para maiúsculas e propriedades: Null (Chr$(0)), separador horizontal (Chr$(9)), avanço de linha (Chr$(10)), separador vertical (Chr$(11)), avanço de forma (Chr$(12)), retorno de carro (Chr$(13)), espaço (conjunto de caracteres de um byte) (Chr$(32)). O valor real de um espaço, que pode ser de largura total ou metade, varia consoante o país/região nas culturas do Leste Asiático.

Aplica-se a

Ver também