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

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Strings.vb

Devuelve una cadena convertida como se especifica.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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

Public Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As String

Parámetros

str

String

Obligatorio. String expresión que se va a convertir.

Conversion

VbStrConv

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

LocaleID

Int32

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

Devoluciones

String

Cadena convertida como especificada.

Atributos

SupportedOSPlatformAttribute

Excepciones

ArgumentException

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

Ejemplos

En este ejemplo se convierte el 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.Narrow, VbStrConv.SimplifiedChinese, 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 no 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.

Los valores del argumento Conversion son:

Miembro de enumeración	Descripción
VbStrConv.None	No realiza ninguna conversión
VbStrConv.LinguisticCasing	Usa reglas lingüísticas para el uso de 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 en caracteres en mayúsculas.
VbStrConv.LowerCase	Convierte la cadena en caracteres en minúsculas.
VbStrConv.ProperCase	Convierte la primera letra de cada palabra en cadena en mayúsculas.
VbStrConv.Wide *	Convierte caracteres estrechos (ancho medio) en la cadena en caracteres anchos (ancho completo). La conversión puede usar el formulario de normalización C incluso si un carácter de entrada ya tiene ancho completo. Por ejemplo, la cadena "は ゙" (que ya tiene ancho completo) se normaliza en "ば". Consulte formularios de normalización Unicode.
VbStrConv.Narrow *	Convierte caracteres anchos (ancho completo) en 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 chino 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 lugar del código en lugar de los valores reales. La mayoría se puede combinar (por ejemplo, UpperCase + Wide), excepto cuando se excluyen mutuamente (por ejemplo, VbStrConv.Wide + VbStrConv.Narrow).

Los siguientes son separadores de palabra válidos para mayúsculas y minúsculas adecuados: Null (Chr$(0)), tabulación horizontal (Chr$(9)), avance de línea (Chr$(10)), tabulación vertical (Chr$(11)), 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 región de las referencias culturales de Asia Oriental.

Consulte también

• Chr(Int32)
• ChrW(Int32)
• String
• ArgumentException
• de resumen de manipulación de cadenas de
• funciones de conversión de tipos de