StrConv (Función)

  • Artículo

Actualización: noviembre 2007

Devuelve una cadena convertida según se ha 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
    Obligatorio. Expresión String que se va a convertir.

  • Conversion
    Obligatorio. Miembro VbStrConv (Enumeración). Valor de enumeración que especifica el tipo de conversión que realizar.

  • LocaleID
    Opcional. Valor LocaleID, si es diferente del valor de la referencia cultural actual de la aplicación. Para obtener más información acerca de los identificadores y la referencia cultural, vea CultureInfo. (El valor de referencia cultural actual de la aplicación es el valor predeterminado.)

Valores

Los valores del argumento Conversion son:

Miembro de la enumeración

Descripción

VbStrConv.None

No se realiza ninguna conversión

VbStrConv.LinguisticCasing

Usa mayúsculas o minúsculas con arreglo a criterios lingüísticos, más que los del sistema de archivos (predeterminado). Válido con VbStrConv.UpperCase y VbStrConv.LowerCase solamente.

VbStrConv.UpperCase

Convierte la cadena a mayúsculas.

VbStrConv.LowerCase

Convierte la cadena a minúsculas.

VbStrConv.ProperCase

Pone en mayúscula la primera letra de cada palabra de la cadena.

VbStrConv.Wide*

Convierte los caracteres estrechos (ancho medio) de la cadena en caracteres anchos (ancho completo).

VbStrConv.Narrow*

Convierte los 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 los caracteres de chino tradicional a chino simplificado.

VbStrConv.TraditionalChinese*

Convierte los caracteres de chino simplificado en chino tradicional.

*   Se aplica a configuraciones regionales asiáticas.

**   Sólo se aplica a Japón.

Nota:

Estas constantes se especifican en Common Language Runtime de .NET Framework. Por tanto, pueden utilizarse en cualquier lugar del código en vez de sus valores reales. La mayoría de ellas pueden combinarse (por ejemplo, UpperCase + Wide) excepto cuando se excluyan mutuamente (por ejemplo, VbStrConv.Wide + VbStrConv.Narrow).

Los siguientes separadores son separadores de palabra válidos para una presentación correcta: Null (Chr$(0)), tabulación horizontal (Chr$(9)), avance de línea (Chr$(10)), tabulación vertical (Chr$(11)), salto de página (Chr$(12)), retorno de carro (Chr$(13)), espacio (juego de caracteres de un solo byte) (Chr$(32)). En Asia oriental, el valor real de un espacio, que puede ser de uno o dos bytes, varía en función del país o región.

Excepciones

Tipo de excepción

Número de error

Condición

ArgumentException

5

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

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

Las constantes VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana y VbStrConv.Hiragana pueden provocar errores en tiempo de ejecución cuando se utilizan en configuraciones regionales en las que no se aplican pero no siempre: las constantes VbStrConv.Katakana y VbStrConv.Hiragana se pueden utilizar en sistemas no japoneses con un paquete de japonés instalado. Además, se admite el uso de las constantes VbStrConv.Wide y VbStrConv.Narrow en cualquier sistema que tenga instalado un idioma de Asia oriental.

Esta función utiliza la información de referencia cultural de la aplicación al manipular la cadena para que los cambios de mayúsculas y minúsculas sean los adecuados para la configuración regional en la que se usa la aplicación.

Nota de seguridad:

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

Ejemplo

En este ejemplo se pone un texto todo en minúsculas.

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

Notas para desarrolladores de dispositivos inteligentes

Esta función no está admitida.

Requisitos

Espacio de nombres:Microsoft.VisualBasic

**Módulo:**Strings

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Vea también

Referencia

Resumen de manipulación de cadenas

Chr, ChrW (Funciones)

String (Tipo de datos, Visual Basic)

Funciones de conversión de tipos

ArgumentException