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

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic
Ensamblado:
Microsoft.VisualBasic.Core.dll
Ensamblado:
Microsoft.VisualBasic.dll
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb

Devuelve una cadena convertida según se ha especificado.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? StrConv (string? str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
public static string StrConv (string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string
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

Obligatorio. Expresión de tipo String que se va a convertir.

Conversion
VbStrConv

Obligatorio. Miembro VbStrConv. Valor de enumeración que especifica el tipo de conversión que se va a realizar.

LocaleID
Int32

Opcional. Valor de LocaleID si difiere del valor de LocaleID del sistema. (El valor de LocaleID del sistema es el valor predeterminado.)

Devoluciones

String

Cadena convertida según se ha especificado.

Atributos
SupportedOSPlatformAttribute

Excepciones

ArgumentException

LocaleID no admitido, Conversion< 0 o > 2048, o conversión no admitida para la configuración regional especificada.

Ejemplos

En este ejemplo se convierte texto en todas las letras minúsculas.

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

Comentarios

Las constantes VbStrConv.Wide, , VbStrConv.SimplifiedChineseVbStrConv.Narrow, VbStrConv.TraditionalChinese, VbStrConv.Katakanay VbStrConv.Hiragana pueden provocar errores en tiempo de ejecución cuando se usan en configuraciones regionales en las que no se aplican, pero no siempre: las constantes VbStrConv.Katakana y VbStrConv.Hiragana se pueden usar en un sistema que no sea japonés con el paquete de idioma japonés instalado. Además, el uso de las constantes VbStrConv.Wide y VbStrConv.Narrow se admite en cualquier sistema con un idioma asiático oriental instalado.

Esta función usa la información de referencia cultural de la aplicación al manipular la cadena para que los cambios de caso sean adecuados para la configuración regional en la que se usa la aplicación.

Importante

Si la aplicación toma decisiones de seguridad basadas en el resultado de una operación de comparación o cambio de mayúsculas y minúsculas, la operación debe usar el método String.Compare y pasar Ordinal o OrdinalIgnoreCase para el argumento comparisonType. Para obtener más información, vea Cómo afecta la referencia cultural a las cadenas en Visual Basic.

La configuración del argumento Conversion es:

Miembro de enumeración Descripción
VbStrConv.None No realiza ninguna conversión
VbStrConv.LinguisticCasing Usa reglas lingüísticas para mayúsculas y minúsculas, en lugar de sistema de archivos (valor predeterminado). Válido solo con VbStrConv.UpperCase y VbStrConv.LowerCase .
VbStrConv.UpperCase Convierte la cadena a mayúsculas.
VbStrConv.LowerCase Convierte la cadena a minúsculas.
VbStrConv.ProperCase Convierte la primera letra de cada palabra en cadena en mayúsculas.
VbStrConv.Wide * Convierte caracteres estrechos (de ancho medio) en la cadena en caracteres anchos (ancho completo). Es posible que en la conversión se use la forma de normalización C, incluso si un carácter de entrada ya es de ancho completo. Por ejemplo, la cadena "は゛" (que ya es de ancho completo) se normaliza a "ば". Vea Unicode normalization forms (Formas de normalización Unicode).
VbStrConv.Narrow * Convierte caracteres anchos (ancho completo) de la cadena en caracteres estrechos (ancho medio).
VbStrConv.Katakana ** Convierte los caracteres Hiragana de la cadena en caracteres Katakana.
VbStrConv.Hiragana ** Convierte los caracteres Katakana de la cadena en caracteres Hiragana.
VbStrConv.SimplifiedChinese * Convierte caracteres chinos tradicionales en chino simplificado.
VbStrConv.TraditionalChinese * Convierte caracteres chinos simplificados en chino tradicional.

* Se aplica a las configuraciones regionales asiáticas.

** Solo se aplica a Japón.

Nota

Estas constantes se especifican en Common Language Runtime de .NET Framework. Como resultado, se pueden usar en cualquier parte del código en lugar de los valores reales. La mayoría se puede combinar (por ejemplo, UpperCase + Wide), excepto cuando son mutuamente excluyentes (por ejemplo, VbStrConv.Wide + VbStrConv.Narrow).

Los siguientes son separadores de palabras válidos para mayúsculas y minúsculas adecuadas: Null (Chr$(0)), tabulación horizontal (), avance de línea (Chr$(9)), tabulación vertical (Chr$(11)Chr$(10)), fuente de formulario (Chr$(12)), retorno de carro (Chr$(13)), espacio (juego de caracteres de un solo byte) (Chr$(32)). El valor real de un espacio, que puede ser de ancho completo o medio, varía según el país o la región de las referencias culturales de Asia Oriental.

Se aplica a

Consulte también