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

Definición

Devuelve una cadena convertida según se ha especificado.Returns a string converted as specified.

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

Obligatorio.Required. Expresión de tipo String que se va a convertir.String expression to be converted.

Conversion
VbStrConv

Obligatorio.Required. Miembro VbStrConv.VbStrConv member. Valor de enumeración que especifica el tipo de conversión que se va a realizar.The enumeration value specifying the type of conversion to perform.

LocaleID
Int32

Opcional.Optional. Valor de LocaleID si difiere del valor de LocaleID del sistema.The LocaleID value, if different from the system LocaleID value. (El valor de LocaleID del sistema es el valor predeterminado.)(The system LocaleID value is the default.)

Devoluciones

Cadena convertida según se ha especificado.A string converted as specified.

Excepciones

LocaleID no admitido, Conversion < 0 o > 2048, o conversión no admitida para la configuración regional especificada.Unsupported LocaleID, Conversion < 0 or > 2048, or unsupported conversion for specified locale.

Ejemplos

En este ejemplo se convierte texto en minúsculas.This example converts text into all lowercase letters.

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.Katakana y VbStrConv.Hiragana pueden producir 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 esté en japonés con el idioma japonés. Paquete instalado.The constants VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana, and VbStrConv.Hiragana can cause run-time errors when used in locales where they do not apply, but not always: the constants VbStrConv.Katakana and VbStrConv.Hiragana can be used in a non-Japanese system with the Japanese Language Pack installed. Además, se admite el uso de las constantes VbStrConv.Wide y VbStrConv.Narrow en cualquier sistema que tenga instalado un idioma asiático oriental.In addition, use of the constants VbStrConv.Wide and VbStrConv.Narrow is supported on any system with an East Asian language installed.

Esta función usa 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 adecuados para la configuración regional en la que se usa la aplicación.This function uses the application's culture information when manipulating the string so that the case changes are appropriate for the locale in which the application is being used.

Importante

Si su aplicación toma decisiones de seguridad basadas en el resultado de una comparación o una operación de 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.If your application makes security decisions based on the result of a comparison or case-change operation, then the operation should use the String.Compare method, and pass Ordinal or OrdinalIgnoreCase for the comparisonType argument. Para obtener más información, vea Cómo afecta la referencia cultural a las cadenas en Visual Basic.For more information, see How Culture Affects Strings in Visual Basic.

La configuración del argumento Conversion es:The Conversion argument settings are:

Miembro de enumeraciónEnumeration member DescripciónDescription
VbStrConv.None No realiza ninguna conversiónPerforms no conversion
VbStrConv.LinguisticCasing Utiliza reglas lingüísticas para el uso de mayúsculas y minúsculas, en lugar del sistema de archivos (valor predeterminado).Uses linguistic rules for casing, rather than File System (default). Válido solo con VbStrConv.UpperCase y VbStrConv.LowerCase.Valid with VbStrConv.UpperCase and VbStrConv.LowerCase only.
VbStrConv.UpperCase Convierte la cadena a mayúsculas.Converts the string to uppercase characters.
VbStrConv.LowerCase Convierte la cadena a minúsculas.Converts the string to lowercase characters.
VbStrConv.ProperCase Convierte la primera letra de cada palabra de la cadena a mayúsculas.Converts the first letter of every word in string to uppercase.
VbStrConv.Wide *VbStrConv.Wide * Convierte los caracteres estrechos (medio ancho) de la cadena en caracteres anchos (ancho completo).Converts narrow (half-width) characters in the string to wide (full-width) characters. 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.The conversion may use Normalization Form C even if an input character is already full-width. Por ejemplo, la cadena "は゛" (que ya es de ancho completo) se normaliza a "ば".For example, the string "は゛" (which is already full-width) is normalized to "ば". Vea Unicode normalization forms (Formas de normalización Unicode).See Unicode normalization forms.
VbStrConv.Narrow *VbStrConv.Narrow * Convierte los caracteres anchos (ancho completo) de la cadena en caracteres estrechos (de ancho medio).Converts wide (full-width) characters in the string to narrow (half-width) characters.
VbStrConv.Katakana **VbStrConv.Katakana ** Convierte los caracteres Hiragana de la cadena en caracteres Katakana.Converts Hiragana characters in the string to Katakana characters.
VbStrConv.Hiragana **VbStrConv.Hiragana ** Convierte los caracteres Katakana de la cadena en caracteres Hiragana.Converts Katakana characters in the string to Hiragana characters.
VbStrConv.SimplifiedChinese *VbStrConv.SimplifiedChinese * Convierte los caracteres de chino tradicional en chino simplificado.Converts Traditional Chinese characters to Simplified Chinese.
VbStrConv.TraditionalChinese *VbStrConv.TraditionalChinese * Convierte los caracteres de chino simplificado en chino tradicional.Converts Simplified Chinese characters to Traditional Chinese.

* Se aplica a las configuraciones regionales asiáticas.* Applies to Asian locales.

** Solo se aplica a Japón.** Applies to Japan only.

Nota

Estas constantes se especifican en el Common Language Runtime .NET Framework.These constants are specified in the .NET Framework common language runtime. Como resultado, se pueden usar en cualquier parte del código en lugar de los valores reales.As a result, they can be used anywhere in your code in place of the actual values. La mayoría puede combinarse (por ejemplo, UpperCase + Wide), excepto cuando son mutuamente excluyentes (por ejemplo, VbStrConv.Wide + VbStrConv.Narrow).Most can be combined (for example, UpperCase + Wide), except when they are mutually exclusive (for example, VbStrConv.Wide + VbStrConv.Narrow).

Los siguientes son separadores de palabras válidos para las mayúsculas y minúsculas adecuadas: Null (Chr$(0)), tabulación horizontal (Chr$(9)), avance de línea (Chr$(10)), tabulación vertical (Chr$(11)), fuente de formularios (Chr$(12)), retorno de carro (Chr$(13)), espacio (juego de caracteres de un solo byte) (Chr$(32)).The following are valid word separators for proper casing: Null (Chr$(0)), horizontal tab (Chr$(9)), line feed (Chr$(10)), vertical tab (Chr$(11)), form feed (Chr$(12)), carriage return (Chr$(13)), space (single-byte character set) (Chr$(32)). El valor real de un espacio, que puede ser Full o Half width, varía según el país o la región para las referencias culturales de Asia oriental.The actual value for a space, which can be full or half width, varies by country/region for East Asian cultures.

Se aplica a

Consulte también: