Sunteți pe pagina 1din 76

Funciones de cadena (Visual Basic)

Visual Studio 2013

En la tabla siguiente se enumeran las funciones que Visual Basic proporciona para buscar y
manipular las cadenas.

Método en .NET
Descripción
Framework
Devuelve un valor de tipo Integer que representa el código de carácter
Asc, AscW
que corresponde a un carácter.
Chr, ChrW Devuelve el carácter asociado al código de carácter especificado.
Devuelve una matriz basada en cero que contiene un subconjunto de
Filter
una matriz String basada en criterios de filtro especificados.
Devuelve una cadena con el formato que especifiquen las
Format
instrucciones contenidas en una expresión String de formato.
Devuelve una expresión con formato de moneda en la que se utilizará
FormatCurrency el símbolo de moneda que se haya definido en el panel de control del
sistema.
Devuelve una expresión de cadena que representa un valor de fecha u
FormatDateTime
hora.
FormatNumber Devuelve una expresión con formato de número.
Devuelve una expresión con formato de porcentaje (multiplicada por
FormatPercent
100), acompañada del carácter final %.
Devuelve un entero que especifica la posición inicial de la primera
InStr
aparición de una cadena dentro de otra.
Devuelve la posición de la primera aparición de una cadena dentro de
InStrRev
otra, comenzando por el extremo derecho de la cadena.
Devuelve una cadena creada a partir de la combinación de varias
Join
subcadenas contenidas en una matriz.
LCase Devuelve una cadena o un carácter convertidos en minúscula.
Devuelve una cadena que contiene un número especificado de
Left
caracteres a partir del lado izquierdo de una cadena.
Devuelve un entero que contiene el número de caracteres de una
Len
cadena.
Devuelve una cadena alineada a la izquierda que contiene la cadena
LSet
especificada ajustada a la longitud indicada.
Devuelve una cadena que contiene una copia de una cadena
LTrim
especificada sin espacios iniciales.
Mid Devuelve una cadena que a su vez contiene un número especificado de
caracteres de una cadena.
Devuelve una cadena en la que la subcadena especificada se reemplaza
Replace
determinado número de veces por otra subcadena.
Devuelve una cadena que contiene un número especificado de
Right
caracteres desde el lado derecho de una cadena.
Devuelve una cadena alineada a la derecha que contiene la cadena
RSet
especificada y con la longitud especificada.
Devuelve una cadena que contiene una copia de una cadena
RTrim
especificada sin espacios finales.
Space Devuelve una cadena que consta del número especificado de espacios.
Devuelve una matriz unidimensional basada en cero que contiene un
Split
número especificado de subcadenas.
Devuelve un valor, -1, 0 ó 1, que indica el resultado de una
StrComp
comparación de cadena.
StrConv Devuelve una cadena convertida según se ha especificado.
Devuelve una cadena o un objeto que se compone del carácter
StrDup
especificado repetido el número de veces especificado.
Devuelve una cadena en la que se invierte el orden de los caracteres de
StrReverse
la cadena especificada.
Devuelve una cadena que contiene una copia de una cadena
Trim
especificada sin espacios iniciales o finales.
Devuelve una cadena o un carácter que contiene la cadena
UCase
especificada convertida en mayúsculas.

Puede usar la instrucción Option Compare para establecer si las cadenas se comparan
mediante un criterio de ordenación de texto sin distinción entre mayúsculas y minúsculas
determinado por la configuración regional del sistema (Text) o por las representaciones
binarias internas de los caracteres (Binary).El método predeterminado de comparación de
texto es Binary.

Ejemplo

En este ejemplo se utiliza la función UCase para devolver la versión en mayúsculas de una
cadena.

VB
Copiar
' String to convert.
Dim LowerCase As String = "Hello World 1234"
' Returns "HELLO WORLD 1234".
Dim UpperCase As String = UCase(LowerCase)
En este ejemplo se usa la función LTrim para quitar los espacios iniciales y la función RTrim
para quitar los espacios finales de una variable de cadena.También se usa la función Trim para
quitar ambos tipos de espacios.

VB
Copiar
' Initializes string.
Dim TestString As String = " <-Trim-> "
Dim TrimString As String
' Returns "<-Trim-> ".
TrimString = LTrim(TestString)
' Returns " <-Trim->".
TrimString = RTrim(TestString)
' Returns "<-Trim->".
TrimString = LTrim(RTrim(TestString))
' Using the Trim function alone achieves the same result.
' Returns "<-Trim->".
TrimString = Trim(TestString)

En este ejemplo se utiliza la función Mid para devolver un número de caracteres especificado
de una cadena.

VB
Copiar
' Creates text string.
Dim TestString As String = "Mid Function Demo"
' Returns "Mid".
Dim FirstWord As String = Mid(TestString, 1, 3)
' Returns "Demo".
Dim LastWord As String = Mid(TestString, 14, 4)
' Returns "Function Demo".
Dim MidWords As String = Mid(TestString, 5)

En este ejemplo se utiliza Len para devolver el número de caracteres de una cadena:

VB
Copiar
' Initializes variable.
Dim TestString As String = "Hello World"
' Returns 11.
Dim TestLen As Integer = Len(TestString)
En este ejemplo se usa la función InStr para devolver la posición de la primera aparición de
una cadena dentro de otra.

VB
Copiar
' String to search in.
Dim SearchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim SearchChar As String = "P"

Dim TestPos As Integer


' A textual comparison starting at position 4. Returns 6.
TestPos = InStr(4, SearchString, SearchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.


TestPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.


' If Option Compare is set to Text, returns 3.
TestPos = InStr(SearchString, SearchChar)

' Returns 0.
TestPos = InStr(1, SearchString, "W")

En este ejemplo se muestran los diversos usos de la función Format para dar formato a valores
tanto con formatos String como otros definidos por el usuario.Para el separador de fecha (/),
hora (:) e indicadores de a.m./p.m. (t y tt), el formato de salida que muestre su sistema
dependerá de la configuración regional que use el código.Cuando las horas y fechas se
muestren en el entorno de desarrollo, se utilizará el formato de fecha y hora corta de la
configuración regional del código.

Nota
Para configuraciones regionales que utilizan un reloj de 24 horas, los indicadores de a.m./p.m.
(t y tt) no muestran nada.
VB
Copiar
Dim TestDateTime As Date = #1/27/2001 5:04:23 PM#
Dim TestStr As String
' Returns current system time in the system-defined long time format.
TestStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
TestStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date
' format, using the single letter code for the format.
TestStr = Format(Now(), "D")

' Returns the value of TestDateTime in user-defined date/time formats.


' Returns "5:4:23".
TestStr = Format(TestDateTime, "h:m:s")
' Returns "05:04:23 PM".
TestStr = Format(TestDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
TestStr = Format(TestDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
TestStr = Format(TestDateTime, "HH:mm:ss")
' Returns "23".
TestStr = Format(23)

' User-defined numeric formats.


' Returns "5,459.40".
TestStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
TestStr = Format(334.9, "###0.00")
' Returns "500.00%".
TestStr = Format(5, "0.00%")

Strings.Asc (Método)
.NET Framework 4.5
Otras versiones

Personas que lo han encontrado útil: 2 de 3 - Valorar este tema

Devuelve un valor de tipo Integer que representa el código de carácter que corresponde a un
carácter.

Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
Devuelve un valor de tipo Integer que representa el código de carácter que
Asc(Char)
corresponde a un carácter.
Devuelve un valor de tipo Integer que representa el código de carácter que
Asc(String)
corresponde a un carácter.

Strings.AscW (Método)
.NET Framework 4.5
Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve un valor de tipo Integer que representa el código de carácter que corresponde a un
carácter.

Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
Devuelve un valor de tipo Integer que representa el código de carácter que
AscW(Char)
corresponde a un carácter.
Devuelve un valor de tipo Integer que representa el código de carácter que
AscW(String)
corresponde a un carácter.

Strings.Chr (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve el carácter asociado al código de carácter especificado.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#
C++

F#

VB

Copiar

'Declaración
Public Shared Function Chr ( _
CharCode As Integer _
) As Char

Parámetros
CharCode

Tipo: System.Int32
Requerido.Expresión de tipo Integer que representa el code point o el código del carácter.

Valor devuelto
Tipo: System.Char
Devuelve el carácter asociado al código de carácter especificado.

Excepciones

Excepción Condición

ArgumentException
CharCode < 0 o > 255 para Chr.
Comentarios

El intervalo asimétrico aceptado para CharCode compensa las diferencias de almacenamiento


entre Short e Integer.Por ejemplo, -29183 es Short pero +36353 es Integer.De este modo
también se facilita la compatibilidad con Visual Basic 6.0.

Chr utiliza la clase Encoding del espacio de nombres System.Text para determinar si el
subproceso actual está utilizando un juego de caracteres de un solo byte (SBCS) o un juego de
caracteres de doble byte (DBCS).Después utiliza como punto de código el CharCode del juego
correspondiente.El intervalo puede ser del 0 al 255 para caracteres SBCS y del -32768 al
65535 para caracteres DBCS.

El valor devuelto depende de la página de códigos para el subproceso actual, que está en la
propiedad ANSICodePage de la clase TextInfo en el espacio de nombres
System.Globalization.Puede obtener ANSICodePage especificando
System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage.

ChrW utiliza CharCode como punto de código Unicode.El intervalo no depende de la


configuración de referencia cultural y página de códigos del subproceso actual.Los valores del
-32768 al -1 se tratan igual que los valores del intervalo del +32768 al +65535.

Los números del 0 al 31 son los mismos que los códigos ASCII estándar no imprimibles.Por
ejemplo, Chr(10) devuelve un carácter de avance de línea.

Nota

La función ChrB en las versiones anteriores de Visual Basic devuelve un byte único.Se utiliza
principalmente para convertir cadenas en aplicaciones de juegos de caracteres de doble byte
(DBCS).En Visual Basic y en .NET Framework, todas las cadenas están en Unicode y ya no
se admite ChrB.
Ejemplos

En el ejemplo siguiente se utiliza la función Chr para devolver el carácter asociado al código
de carácter especificado.

VB

Copiar

Dim associatedChar As Char


' Returns "A".
associatedChar = Chr(65)
' Returns "a".
associatedChar = Chr(97)
' Returns ">".
associatedChar = Chr(62)
' Returns "%".
associatedChar = Chr(37)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1
Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.ChrW (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve el carácter asociado al código de carácter especificado.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function ChrW ( _
CharCode As Integer _
) As Char
Parámetros
CharCode

Tipo: System.Int32
Requerido.Expresión de tipo Integer que representa el code point o el código del carácter.

Valor devuelto
Tipo: System.Char
Devuelve el carácter asociado al código de carácter especificado.

Excepciones

Excepción Condición

ArgumentException
CharCode < -32768 o > 65535 para ChrW.
Comentarios

El intervalo asimétrico aceptado para CharCode compensa las diferencias de almacenamiento


entre Short e Integer.Por ejemplo, -29183 es Short pero +36353 es Integer.De este modo
también se facilita la compatibilidad con Visual Basic 6.0.

Chr utiliza la clase Encoding del espacio de nombres System.Text para determinar si el
subproceso actual está utilizando un juego de caracteres de un solo byte (SBCS) o un juego de
caracteres de doble byte (DBCS).Después utiliza como punto de código el CharCode del juego
correspondiente.El intervalo puede ser del 0 al 255 para caracteres SBCS y del -32768 al
65535 para caracteres DBCS.

El valor devuelto depende de la página de códigos para el subproceso actual, que está en la
propiedad ANSICodePage de la clase TextInfo en el espacio de nombres
System.Globalization.Puede obtener ANSICodePage especificando
System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage.

ChrW utiliza CharCode como punto de código Unicode.El intervalo no depende de la


configuración de referencia cultural y página de códigos del subproceso actual.Los valores del
-32768 al -1 se tratan igual que los valores del intervalo del +32768 al +65535.

Los números del 0 al 31 son los mismos que los códigos ASCII estándar no imprimibles.Por
ejemplo, Chr(10) devuelve un carácter de avance de línea.

Nota
La función ChrB en las versiones anteriores de Visual Basic devuelve un byte único.Se utiliza
principalmente para convertir cadenas en aplicaciones de juegos de caracteres de doble byte
(DBCS).En Visual Basic y en .NET Framework, todas las cadenas están en Unicode y ya no
se admite ChrB.
Ejemplos

En el ejemplo siguiente se utiliza la función Chr para devolver el carácter asociado al código
de carácter especificado.

VB

Copiar

Dim associatedChar As Char


' Returns "A".
associatedChar = Chr(65)
' Returns "a".
associatedChar = Chr(97)
' Returns ">".
associatedChar = Chr(62)
' Returns "%".
associatedChar = Chr(37)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

.NET para aplicaciones de la Tienda Windows


Compatible con: Windows 8

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.Filter (Método)
.NET Framework 4.5
Otras versiones

Personas que lo han encontrado útil: 0 de 1 - Valorar este tema

Devuelve una matriz basada en cero que contiene un subconjunto de una matriz String basada
en criterios de filtro especificados.

Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
Devuelve una matriz basada en cero que contiene un
Filter(Object(), String,
subconjunto de una matriz String basada en criterios de filtro
Boolean, CompareMethod)
especificados.
Devuelve una matriz basada en cero que contiene un
Filter(String(), String,
subconjunto de una matriz String basada en criterios de filtro
Boolean, CompareMethod)
especificados.

Strings.Format (Método)
.NET Framework 4.5

Otras versiones

Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

Devuelve una cadena con el formato que especifiquen las instrucciones contenidas en una
expresión String de formato.
Espacio de nombres: Microsoft.VisualBasic
Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function Format ( _
Expression As Object, _
Style As String _
) As String

Parámetros
Expression

Tipo: System.Object
Requerido.Cualquier expresión válida.

Style

Tipo: System.String
Opcional.Expresión válida de formato de tipo String con nombre o definida por el usuario.

Valor devuelto
Tipo: System.String
Devuelve una cadena con el formato que especifiquen las instrucciones contenidas en una expresión
String de formato.

Comentarios

El método String.Format también proporciona una funcionalidad similar.

Si da formato a una cadena numérica no localizada, debería utilizar un formato numérico


definido por el usuario para asegurarse de lograr la presentación deseada.
Si intenta aplicar formato a un número sin especificar Style, la función Format ofrecerá una
funcionalidad similar a la función Str, a pesar de admitir configuraciones internacionales.No
obstante, los números positivos a los que se les da formato de cadena mediante la función
Format no incluyen ningún espacio inicial reservado para el signo del valor; los que se
convierten mediante la función Str sí conservan este espacio inicial.

Diferentes formatos para diferentes valores numéricos

Expresión de formato definida por el usuario y correspondiente a números que pueden


contener entre una y tres secciones separadas por signos de punto y coma.Si el argumento
Style de la función Format contiene uno de los formatos numéricos predefinidos, sólo se
permite una sección.

Si usa El resultado será


Sólo una
La expresión de formato se aplica a todos los valores.
sección
La primera sección se aplica a valores positivos y ceros; la segunda, sólo a
Dos secciones
valores negativos.
Tres La primera sección se aplica a valores positivos y ceros; la segunda, sólo a
secciones. valores negativos; la tercera, a ceros.

El siguiente ejemplo contiene dos secciones: la primera define el formato para valores
positivos y ceros; la segunda define el formato para valores negativos.Como el argumento
Style de la función Format utiliza una cadena, ésta aparece entre comillas.

VB

Copiar

Dim Style1 As String = "$#,##0;($#,##0)"

Si incluye signos de punto y coma sin nada entre ellos, la sección ausente se imprimirá usando
el formato del valor positivo.Por ejemplo, el siguiente formato mostrará valores positivos y
negativos usando el formato de la primera sección; y mostrará Zero si el valor es cero.

VB

Copiar

Dim Style2 As String = "$#,##0;;\Z\e\r\o"


Formatos numéricos predefinidos

La tabla siguiente muestra los nombres de formato numérico predefinidos.Éstos pueden usarse
por nombre como el argumento Style para la función Format.

Nombre de
Descripción
formato
General Muestra el número sin separadores de miles.
Number, G o
g Por ejemplo, Format(&H3FA, "g") devuelve 1018.
Muestra el número con separadores de miles, en su caso; también muestra dos
dígitos a la derecha del separador de decimales.El formato de salida dependerá
Currency, C o
de la configuración regional.
c
Por ejemplo, Format(1234567, "c") devuelve $1,234,567.00.
Muestra al menos un dígito a la izquierda y dos a la derecha del separador de
decimales.
Fixed, F o f
Por ejemplo, Format(1234567, "f") devuelve 1234567.00.
Muestra el número con separador de miles, al menos un dígito a la izquierda y
Standard, N o dos a la derecha del separador de decimales.
n
Por ejemplo, Format(1234567, "n") devuelve 1,234,567.00.
Muestra el número multiplicado por 100 con un signo de porcentaje (%) a la
derecha; siempre muestra dos dígitos a la derecha del separador de decimales.
Percent
Por ejemplo, Format(0.4744, "Percent") devuelve 47.44%.
Muestra el número con separador de miles multiplicado por 100 con un signo
de porcentaje (%) a la derecha y separado por un solo espacio; siempre muestra
Pop dos dígitos a la derecha del separador de decimales.

Por ejemplo, Format(0.80345, "p") devuelve 80.35 %.


Utiliza notación científica estándar y proporciona dos dígitos significativos.
Scientific
Por ejemplo, Format(1234567, "Scientific") devuelve 1.23E+06.
Utiliza notación científica estándar y proporciona seis dígitos significativos.
Eoe
Por ejemplo, Format(1234567, "e") devuelve 1.234567e+006.
Muestra el número como una cadena que contiene el valor del número en
formato Decimal (base 10).Esta opción solo se admite para tipos enteros (Byte,
Dod Short, Integer, Long).

Por ejemplo, Format(&H7F, "d") devuelve 127.


Xox Muestra el número como una cadena que contiene el valor del número en
formato Hexadecimal (base 16).Esta opción solo se admite para tipos enteros
(Byte, Short, Integer, Long).

Por ejemplo, Format(127, "x") devuelve 7f.


Muestra No si el número es 0; de lo contrario, muestra Yes.
Yes/No
Por ejemplo, Format(0, "Yes/No") devuelve No.
Muestra False si el número es 0; de lo contrario, muestra True.
True/False
Por ejemplo, Format(1, "True/False") devuelve True.
Muestra Off si el número es 0; de lo contrario, muestra On.
On/Off
Por ejemplo, Format(1, "On/Off") devuelve On.

Notas para desarrolladores de dispositivos Smart Device

No se admiten los formatos Yes/No, True/False y On/Off.

Formatos numéricos definidos por el usuario

La siguiente tabla identifica caracteres que puede usar para crear formatos de número
definidos por el usuario.Estos pueden usarse para compilar el argumento Style correspondiente
a la función Format:

Carácter Descripción
None Muestra el número sin formato alguno.
Marcador de posición de dígito.Muestra un dígito o un cero.Si la expresión tiene un
dígito en la posición donde aparece el cero en la cadena de formato, éste se mostrará
así; de lo contrario, aparecerá un cero en esa posición.

Si el número tiene menos dígitos que ceros (a cualquier lado del separador decimal)
(0)
en la expresión de formato, se mostrarán ceros iniciales o finales.Si el número tiene
más dígitos a la derecha del separador decimal que ceros en la expresión de formato,
se redondeará el número a tantos decimales como ceros haya.Si el número tiene más
dígitos a la derecha del separador decimal que ceros en la expresión de formato, se
redondeará el número a tantos decimales como ceros haya.
Marcador de posición de dígito.Muestra un dígito o nada.Si la expresión tiene un
dígito en la posición donde aparece el carácter # en la cadena de formato, se
muestra; de lo contrario, no aparece nada en esa posición.
(#)
Este símbolo funciona como el marcador de posición de dígito 0, salvo que los ceros
iniciales y finales no se mostrarán si el número contiene menos dígitos que
caracteres # a cualquiera de los lados del separador decimal en la expresión de
formato.
(.) Marcador de posición decimal.El marcador de posición decimal determina cuántos
dígitos se mostrarán a la izquierda y derecha del separador decimal.Si la expresión
de formato sólo contiene caracteres # a la izquierda de este símbolo, los números
inferiores a 1 empezarán con un separador decimal.Par mostrar un cero inicial con
números fraccionarios, use el cero como el primer marcador de posición digital a la
izquierda del separador decimal.El uso del punto o la coma como separador decimal
depende de la configuración regional en cada caso.El mismo carácter utilizado como
marcador decimal en virtud del formato de salida dependerá del formato de número
reconocido por su sistema.Por tanto, deberá usar el punto como marcador decimal en
sus formatos, incluso aunque su configuración regional utilice la coma como
separador decimal.La cadena con formato se mostrará con el formato correcto para
la configuración regional correspondiente.
Marcador de posición de porcentaje.Multiplica la expresión por 100.El carácter de
(%)
porcentaje (%) se inserta en la posición donde aparece en la cadena de formato.
Separador de miles.El separador de miles separa las unidades de millar de las
centenas con un número que presente cuatro o más dígitos a la izquierda del
separador decimal.Se especificará un uso estándar del separador de miles si el
formato contiene un separador de miles rodeado de marcadores de posición de dígito
(0 o #).

Un separador de miles situado inmediatamente a la izquierda del separador decimal


(se especificará si se trata de un decimal o no) o como el carácter más a la derecha
de la cadena significa "reducir el número dividiéndolo por 1000 y redondeándolo en
caso necesario". Los números menores que 1,000 pero mayores o iguales que 500 se
muestran como 1; los números menores que 500 se muestran como 0.Dos
separadores de miles adyacentes en esta posición se reducen por un factor de 1
millón, más otro factor adicional de 1000 por cada separador adicional.

En el caso de los separadores múltiples en cualquier posición que no sea


inmediatamente a la izquierda del separador decimal o la posición más a la derecha
(,)
de la cadena, se interpretará que simplemente especifican el uso de un separador de
miles.El uso del punto o la coma como separador de miles depende de la
configuración regional en cada caso.El mismo carácter utilizado como separador de
miles en virtud del formato de salida dependerá del formato de número reconocido
por su sistema.Por tanto, deberá usar la coma como marcador de miles en sus
formatos, incluso aunque su configuración regional utilice el punto como marcador
de miles.La cadena con formato se mostrará con el formato correcto para la
configuración regional correspondiente.

Por ejemplo, considere las tres cadenas de formato siguientes:

 "#,0.", que utiliza el separador de miles para dar formato al número 100
millones como la cadena "100,000,000".
 "#0,.", que ajusta la escala en un factor de mil para dar formato al número
100 millones como la cadena "100000".
 "#,0,.", que utiliza el separador de miles y el ajuste de la escala en un factor
de mil para dar formato al número 100 millones como la cadena "100,000".

Separador de hora.En ciertas configuraciones regionales, pueden usarse otros


caracteres para representar el separador de hora.Este separador horario separa horas,
(:) minutos y segundos cuando se da formato a valores horarios.El carácter real
utilizado es el especificado como separador de hora en la configuración de su
sistema.
Separador de fecha.En ciertas configuraciones regionales, pueden usarse otros
caracteres para representar el separador de fecha.Este separador separa el día, mes y
(/)
año cuando se da formato a los valores de fecha.El carácter real utilizado es el
especificado como separador de fecha en la configuración de su sistema.
Formato científico.Si la expresión de formato contiene al menos un marcador de
posición de dígito (0 o #) a la izquierda de E-, E+, e- o e+, el número se muestra en
formato científico, y se inserta E o e entre el número y su exponente.El número de
(E-E+e- marcadores de posición digitales a la izquierda determina el número de dígitos en el
e+) exponente.Use E- o e- para colocar un signo menos junto a los exponentes
negativos.Utilice E+ o e+ para colocar un signo menos junto a los exponentes
negativos y un signo más junto a los positivos.También deberá incluir marcadores
de posición digitales a la derecha de este símbolo para obtener un formato correcto.
Caracteres literales.Estos caracteres se mostrarán exactamente como se escriben en
-+$ ( ) la cadena de formato.Para mostrar un carácter distinto de los listados, se hace
preceder de una barra invertida (\) o se escribe entre comillas (" ").
Muestra el siguiente carácter de una cadena de formato.Para mostrar un carácter
dotado de un significado especial como carácter literal, éste debe ir precedido de una
barra invertida (\).La barra invertida en sí no aparecerá.El uso de una barra invertida
equivale a incluir el siguiente carácter entre comillas.Para mostrar una barra
invertida, se utilizan dos (\\).
(\)
Ejemplos de caracteres que no se pueden mostrar cuando los caracteres literales son
caracteres de formato de fecha y de formato de hora (a, c, d, h, m, n, p, q, s, t, w, y, /
y :), caracteres de formato numérico (#, 0, %, E, e, coma y punto) y caracteres de
formato de cadenas (@, &, <, > y !).
Muestra la cadena entre comillas (" ").Si se desea insertar una cadena en el
("ABC") argumento de estilo desde el código, debe usar Chr(34) para incluir el texto (34 es el
código de caracteres correspondiente a las comillas dobles (")).

Ejemplo de código heredado

La tabla siguiente contiene algunas muestras de expresiones de formato correspondientes a


números. En estos ejemplos se presupone que la configuración regional del sistema es Inglés
(Estados Unidos). La primera columna contiene las cadenas de formato correspondientes al
argumento Style de la función Format; las otras columnas contienen el formato de salida
resultante si los datos con formato contienen el valor asignado en los encabezados de columna.

Formato (Style) "5" con formato como "-5" con formato como "0.5" con formato como
Zero-length string ("") 5 -5 0.5
0 5 -5 1
0.00 5.00 -5.00 0.50
#,##0 5 -5 1
$#,##0;($#,##0) $5 ($5) $1
$#,##0.00;($#,##0.00) $5.00 ($5.00) $0.50
0% 500% -500% 50%
0.00% 500.00% -500.00% 50.00%
0.00E+00 5.00E+00 -5.00E+00 5.00E-01
0.00E-00 5.00E00 -5.00E00 5.00E-01

Formatos de fecha y hora predefinidos

La tabla siguiente identifica los nombres de formatos de fecha y hora predefinidos.Éstos


pueden usarse por nombre como argumento de estilo para la función Format:

Nombre de
Descripción
formato
General Date Muestra una fecha o una hora.Por ejemplo, 3/12/2008 11:07:31 AM.El formato
oG de fecha depende del valor de la referencia cultural actual de la aplicación.
Long Date,
Muestra una fecha de acuerdo con el formato de fecha larga vigente en la
Medium Date
referencia cultural actual.Por ejemplo, Wednesday, March 12, 2008.
oD
Muestra una fecha de acuerdo con el formato de fecha corta vigente en la
Short Date o referencia cultural actual.Por ejemplo, 3/12/2008.
d
El carácter d muestra el día en un formato de fecha definido por el usuario.
Long Time, Muestra una hora de acuerdo con el formato de hora larga vigente en la
Medium referencia cultural actual; e incluye normalmente horas, minutos y
Time o T segundos.Por ejemplo, 11:07:31 AM.
Muestra una hora de acuerdo con el formato de hora corta vigente en la
referencia cultural actual.Por ejemplo, 11:07 AM.
Short Time o
t
El carácter t muestra valores PM o AM para las configuraciones regionales que
utilizan un reloj de 12 horas en un formato de hora definido por el usuario.
Muestra la fecha larga y la hora corta de acuerdo con el formato vigente en la
f
referencia cultural actual.Por ejemplo, Wednesday, March 12, 2008 11:07 AM.
Muestra la fecha larga y la hora larga de acuerdo con el formato vigente en la
F referencia cultural actual.Por ejemplo, Wednesday, March 12, 2008 11:07:31
AM.
Muestra la fecha corta y la hora corta de acuerdo con el formato vigente en la
g
referencia cultural actual.Por ejemplo, 3/12/2008 11:07 AM.
Muestra el mes y el día de una fecha dada.Por ejemplo, March 12.
M, m
El carácter M muestra el mes en un formato de fecha definido por el usuario.El
carácter m muestra los minutos en un formato de hora definido por el usuario.
Da formato a la fecha según la propiedad RFC1123Pattern.Por ejemplo, Wed,
12 Mar 2008 11:07:31 GMT.La fecha con formato no ajusta el valor de la fecha
R, r
y hora.Debe ajustar el valor de fecha u hora según GMT antes de llamar a la
función Format.
Da formato a la fecha y la hora como un índice ordenable.Por ejemplo, 2008-
03-12T11:07:31.
s
El carácter s muestra los segundos en un formato de hora definido por el
usuario.
Da formato a la fecha y la hora como un índice GMT ordenable.Por ejemplo,
u
2008-03-12 11:07:31Z.
Da formato como GMT a la fecha larga y la hora larga.Por ejemplo,
U
Wednesday, March 12, 2008 6:07:31 PM.
Da formato a la fecha especificando el año y el mes.Por ejemplo, March, 2008.
Y, y
Los caracteres Y e y muestran el año en un formato de fecha definido por el
usuario.

Para obtener más información sobre la información de la referencia cultural actual de la


aplicación, vea Cómo afecta la referencia cultural a las cadenas en Visual Basic.

Formatos de fecha y hora definidos por el usuario

En la siguiente tabla se muestran los caracteres que se pueden utilizar para crear formatos de
fecha y hora definidos por el usuario.A diferencia de versiones anteriores de Visual Basic,
estos caracteres de formato distinguen mayúsculas de minúsculas.

Carácter Descripción
Separador de hora.En ciertas configuraciones regionales, pueden usarse otros
caracteres para representar el separador de hora.Este separador horario separa horas,
(:) minutos y segundos cuando se da formato a valores horarios.El carácter real que se
usa como separador de hora en los resultados con formato, viene determinado por el
valor de referencia cultural actual de la aplicación.
Separador de fecha.En ciertas configuraciones regionales, pueden usarse otros
caracteres para representar el separador de fecha.Este separador separa el día, mes y
(/) año cuando se da formato a los valores de fecha.El carácter real que se usa como
separador de fecha en los resultados con formato, viene determinado por la
referencia cultural actual de la aplicación.
Se utiliza para indicar que el carácter siguiente debe leerse como formato de una sola
(%)
letra sin tener en cuenta las posibles letras finales.También se emplea para indicar
que un formato de una sola letra se lea como formato definido por el usuario.Para
obtener más información, consulte la información que aparece a continuación.
Muestra el día como un número sin cero a la izquierda (por ejemplo, 1).Utilice %d si
d
es el único carácter en el formato numérico definido por el usuario.
dd Muestra el día como un número con cero a la izquierda (por ejemplo, 01).
ddd Muestra el día de forma abreviada (por ejemplo, Sun).
dddd Muestra el día de forma completa (por ejemplo, Sunday).
Muestra el mes como un número sin cero a la izquierda (por ejemplo, enero se
M representa como 1).Utilice %M si es el único carácter en el formato numérico
definido por el usuario.
Muestra el mes como un número con cero a la izquierda (por ejemplo, 01/12/01),
MM
doce de enero de 2001.
MMM Muestra el mes en forma abreviada (por ejemplo, Jan).
MMMM Muestra el mes en forma completa (por ejemplo, January).
gg Especifica el período o era (por ejemplo, A.D.)
Muestra la hora como un número sin ceros a la izquierda y en formato de doce horas
h (por ejemplo, 1:15:15 PM).Utilice %h si es el único carácter en el formato numérico
definido por el usuario.
Muestra la hora como un número con ceros a la izquierda y en formato de doce horas
hh
(por ejemplo, 01:15:15 PM).
Muestra la hora como un número sin ceros a la izquierda y en formato de doce horas
H (por ejemplo, 1:15:15).Utilice %H si es el único carácter en el formato numérico
definido por el usuario.
Muestra la hora como un número con ceros a la izquierda y en formato de doce horas
HH
(por ejemplo, 01:15:15).
Muestra los minutos como un número sin ceros a la izquierda (por ejemplo,
m 12:1:15).Utilice %m si es el único carácter en el formato numérico definido por el
usuario.
Muestra los minutos como un número con ceros a la izquierda (por ejemplo,
mm
12:01:15).
Muestra los segundos como un número sin ceros a la izquierda (por ejemplo,
s 12:15:5).Utilice %s si es el único carácter en el formato numérico definido por el
usuario.
Muestra los segundos como un número con ceros a la izquierda (por ejemplo,
ss
12:15:05).
Muestra fracciones de segundos.Por ejemplo, ff muestra centésimas de segundo,
mientras que ffff muestra diez milésimas de segundo.Puede utilizar hasta siete
f
símbolos f en el formato definido por el usuario.Utilice %f si es el único carácter en
el formato numérico definido por el usuario.
Usa el reloj de doce horas y muestra la leyenda A en mayúsculas para cualquier hora
t entre medianoche y mediodía; y P en mayúsculas para cualquier hora entre mediodía
y medianoche. Utilice %t si es el único carácter en el formato numérico definido por
el usuario.
Para las configuraciones regionales que utilizan el reloj de doce horas, muestra la
leyenda AM en mayúsculas para cualquier hora entre medianoche y mediodía; y PM
en mayúsculas para cualquier hora entre mediodía y medianoche.
tt
Para las configuraciones regionales que utilizan el reloj de 24 horas, no muestra
nada.
Muestra el año sin cero inicial.Utilice %y si es el único carácter en el formato
y
numérico definido por el usuario.
yy Muestra el año en formato numérico de dos dígitos sin cero inicial, si procede.
yyy Muestra el año en formato numérico de cuatro dígitos.
yyyy Muestra el año en formato numérico de cuatro dígitos.
Muestra el desplazamiento de zona horaria sin cero a la izquierda (por ejemplo, -
z
8).Utilice %z si es el único carácter en el formato numérico definido por el usuario.
Muestra el desplazamiento de zona horaria con un cero a la izquierda (por ejemplo, -
zz
08).
zzz Muestra el desplazamiento completo de zona horaria (por ejemplo, -08:00).

Ejemplo de código heredado

A continuación se muestran algunos ejemplos de formatos de hora y fecha definidos por el


usuario y correspondientes al 7 de diciembre de 1958, a las ocho horas, cincuenta minutos y
treinta y cinco segundos de la tarde (December 7, 1958, 8:50 PM, 35 seconds):

Format Muestra
M/d/yy 12/7/58
d-MMM 7-Dec
d-MMMM-yy 7-December-58
d MMMM 7 December
MMMM yy December 58
hh:mm tt 08:50 PM
h:mm:ss t 8:50:35 P
H:mm 20:50
H:mm:ss 20:50:35
M/d/yyyy H:mm 12/7/1958 20:50

Notas para desarrolladores de dispositivos Smart Device

El fabricante de cada dispositivo es el que determina la resolución de tiempo mínima.Si la


resolución de tiempo del dispositivo es lo bastante amplia, el carácter de formato f devuelve 0
cuando se ejecuta en ese dispositivo.
Ejemplos

En este ejemplo se muestran los diversos usos de la función Format para dar formato a valores
tanto con formatos String como otros definidos por el usuario.Para el separador de fecha (/),
hora (:) e indicadores de a.m./p.m. (t y tt), el formato de salida que muestre su sistema
dependerá de la configuración regional que use el código.Cuando las horas y fechas se
muestren en el entorno de desarrollo, se utilizará el formato de fecha y hora corta de la
configuración regional del código.

Nota

Para configuraciones regionales que utilizan un reloj de 24 horas, los indicadores de a.m./p.m.
(t y tt) no muestran nada.
VB

Copiar

Dim TestDateTime As Date = #1/27/2001 5:04:23 PM#


Dim TestStr As String
' Returns current system time in the system-defined long time format.
TestStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
TestStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date
' format, using the single letter code for the format.
TestStr = Format(Now(), "D")

' Returns the value of TestDateTime in user-defined date/time formats.


' Returns "5:4:23".
TestStr = Format(TestDateTime, "h:m:s")
' Returns "05:04:23 PM".
TestStr = Format(TestDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
TestStr = Format(TestDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
TestStr = Format(TestDateTime, "HH:mm:ss")
' Returns "23".
TestStr = Format(23)

' User-defined numeric formats.


' Returns "5,459.40".
TestStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
TestStr = Format(334.9, "###0.00")
' Returns "500.00%".
TestStr = Format(5, "0.00%")

Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.FormatCurrency (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una expresión con formato de moneda en la que se utilizará el símbolo de moneda
que se haya definido en el panel de control del sistema.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#
VB

Copiar

'Declaración
Public Shared Function FormatCurrency ( _
Expression As Object, _
NumDigitsAfterDecimal As Integer, _
IncludeLeadingDigit As TriState, _
UseParensForNegativeNumbers As TriState, _
GroupDigits As TriState _
) As String

Parámetros
Expression

Tipo: System.Object
Requerido.Expresión a la que se va a aplicar formato.

NumDigitsAfterDecimal

Tipo: System.Int32
Opcional.Valor numérico que indica el número de posiciones que se muestran a la derecha
del separador decimal.El valor predeterminado es -1, que indica que se utiliza la configuración
regional del equipo.

IncludeLeadingDigit

Tipo: Microsoft.VisualBasic.TriState
Opcional.Enumeración de TriState que indica si se muestra un cero inicial o no para los
valores fraccionarios.Vea los valores en la sección "Comentarios".

UseParensForNegativeNumbers

Tipo: Microsoft.VisualBasic.TriState
Opcional.Enumeración TriState que indica si los valores negativos se van a colocar entre
paréntesis o no.Vea los valores en la sección "Comentarios".

GroupDigits

Tipo: Microsoft.VisualBasic.TriState
Opcional.Enumeración TriState que indica si los números se agrupan o no mediante el
delimitador de grupo especificado en la configuración regional del equipo.Vea los valores en
la sección "Comentarios".

Valor devuelto
Tipo: System.String
Devuelve una expresión con formato de moneda en la que se utilizará el símbolo de moneda que se
haya definido en el panel de control del sistema.
Excepciones

Excepción Condición

ArgumentException El número de dígitos situados a continuación del signo decimal es mayor


que 99.
InvalidCastException
El tipo no es numérico.
Comentarios

Cada vez que se omita algún argumento opcional, el equipo lo reemplazará por el valor que se
ajuste a su configuración regional.

La configuración regional del sistema determinará la posición del símbolo de moneda con
respecto al valor moneda.

Nota

Toda la información de configuración provendrá de la configuración regional de la


aplicación.De manera predeterminada, la configuración regional será la establecida en el panel
de control.Sin embargo, a excepción del cero inicial, que procede de la ficha Number, la
configuración regional podrá cambiarse mediante programación en .NET Framework.

Los argumentos IncludeLeadingDigit, UseParensForNegativeNumbers y GroupDigits toman


los siguientes valores de enumeración de triple estado.

Valor Descripción
TriState.True True
TriState.False False
TriState.UseDefault Configuración regional del equipo
Ejemplos

En el siguiente ejemplo se muestra el uso de la función FormatCurrency.

VB

Copiar

Dim TestDebt As Double = -4456.43


Dim TestString As String
' Returns "($4,456.43)".
TestString = FormatCurrency(TestDebt, , , TriState.True, TriState.True)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.FormatDateTime (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una expresión de cadena que representa un valor de fecha u hora.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#
C++

F#

VB

Copiar

'Declaración
Public Shared Function FormatDateTime ( _
Expression As DateTime, _
NamedFormat As DateFormat _
) As String

Parámetros
Expression

Tipo: System.DateTime
Requerido.Expresión de Date a la que se va a aplicar formato.

NamedFormat

Tipo: Microsoft.VisualBasic.DateFormat
Opcional.Valor numérico que indica el formato de fecha y hora utilizado.Si se omite, se utiliza
DateFormat.GeneralDate.

Valor devuelto
Tipo: System.String
Devuelve una expresión de cadena que representa un valor de fecha u hora.

Excepciones

Excepción Condición

ArgumentException
El valor de NamedFormat no es válido.
Comentarios

El tipo de datos Date siempre contiene información de fecha y hora.Para la conversión de


tipos, Visual Basic considera 1/1/1 (1 de enero del año 1) un valor neutral de fecha y 00:00:00
(medianoche) un valor neutral de hora.Si a un valor Date se le asigna el formato de cadena de
fecha u hora, FormatDateTime no incluye valores neutrales en la cadena resultante.Por
ejemplo, si se convierte #1/1/0001 9:30:00# en una cadena, el resultado sería "9:30:00 AM",
ya que la información de fecha se omite.No obstante, la información de fecha sigue estando
presente en el valor Date original y se puede recuperar mediante funciones como DatePart.
Nota

Si transfiere el argumento Expression como un literal String, FormatDateTime lo interpreta


según la configuración de CurrentCulture de su aplicación.Sin embargo, si lo transfiere como
un literal Date, debería utilizar el formato #mm/dd/aaaa#, porque FormatDateTime siempre
interpreta un literal Date de acuerdo con la referencia cultural de inglés (EE.UU.).Esto es
necesario porque, si una aplicación se desarrolla y codifica utilizando literales Date de una
referencia cultural pero se ejecuta en una plataforma de otra referencia cultural diferente, los
literales Date podrían analizarse de forma incorrecta.

El argumento NamedFormat tiene los siguientes valores.

Constante Descripción
Muestra una fecha o una hora.Muestra una parte de la fecha como
DateFormat.GeneralDate una fecha corta.Si hay una parte con hora, ésta se mostrará como
hora larga.De estar presentes, se mostrarán ambas partes.
Muestra una fecha con el formato de fecha larga especificado en la
DateFormat.LongDate
configuración regional del equipo.
Muestra una fecha con el formato de fecha corta especificado en la
DateFormat.ShortDate
configuración regional del equipo.
Muestra una hora con el formato de hora especificado en la
DateFormat.LongTime
configuración regional del equipo.
DateFormat.ShortTime Muestra una hora con el formato de 24 horas (hh:mm).
Ejemplos

En este ejemplo se muestra el uso de la función FormatDateTime.

VB

Copiar

' English (US) format.


Dim TestDate As DateTime = #3/12/1999#

' FormatDateTime returns "Friday, March 12, 1999".


' The time information is neutral (00:00:00) and therefore suppressed.
Dim TestString As String = FormatDateTime(TestDate, DateFormat.LongDate)

Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.FormatNumber (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una expresión con formato de número.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar
'Declaración
Public Shared Function FormatNumber ( _
Expression As Object, _
NumDigitsAfterDecimal As Integer, _
IncludeLeadingDigit As TriState, _
UseParensForNegativeNumbers As TriState, _
GroupDigits As TriState _
) As String

Parámetros
Expression

Tipo: System.Object
Requerido.Expresión a la que se va a aplicar formato.

NumDigitsAfterDecimal

Tipo: System.Int32
Opcional.Valor numérico que indica el número de posiciones que se muestran a la derecha
del separador decimal.El valor predeterminado es -1, que indica que se utiliza la configuración
regional del equipo.

IncludeLeadingDigit

Tipo: Microsoft.VisualBasic.TriState
Opcional.Constante TriState que indica si se muestra un 0 inicial para los valores
fraccionarios.Vea los valores en "Configuración".

UseParensForNegativeNumbers

Tipo: Microsoft.VisualBasic.TriState
Opcional.Constante TriState que indica si los valores negativos se van a colocar entre
paréntesis.Vea los valores en "Configuración".

GroupDigits

Tipo: Microsoft.VisualBasic.TriState
Opcional.Constante TriState que indica si los números se agrupan utilizando el delimitador de
grupo especificado en la configuración regional o no.Vea los valores en "Configuración".

Valor devuelto
Tipo: System.String
Devuelve una expresión con formato de número.

Excepciones
Excepción Condición

InvalidCastException
El tipo no es numérico.
Comentarios

Cuando se omitan uno o más argumentos opcionales, la configuración regional del equipo
proporcionará los valores correspondientes.

Nota

Toda la información de configuración provendrá de la configuración regional de la


aplicación.De manera predeterminada, la configuración regional será la establecida en el panel
de control.No obstante, la configuración regional podrá cambiarse mediante programación en
.NET Framework.

Los argumentos IncludeLeadingDigit, UseParensForNegativeNumbers y GroupDigits tienen


los siguientes valores.

Constante Descripción
TriState.True True
TriState.False False
TriState.UseDefault Configuración regional del equipo
Ejemplos

En este ejemplo se muestra el uso de la función FormatNumber.

VB

Copiar

Dim TestNumber As Integer = 45600


' Returns "45,600.00".
Dim TestString As String = FormatNumber(TestNumber, 2, , , TriState.True)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
.NET Framework Client Profile
Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.FormatPercent (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una expresión con formato de porcentaje (multiplicada por 100), acompañada del
carácter final %.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function FormatPercent ( _
Expression As Object, _
NumDigitsAfterDecimal As Integer, _
IncludeLeadingDigit As TriState, _
UseParensForNegativeNumbers As TriState, _
GroupDigits As TriState _
) As String

Parámetros
Expression

Tipo: System.Object
Requerido.Expresión a la que se va a aplicar formato.

NumDigitsAfterDecimal

Tipo: System.Int32
Opcional.Valor numérico que indica el número de posiciones que se muestran a la derecha
del separador decimal.El valor predeterminado es -1, que indica que se utiliza la configuración
regional.

IncludeLeadingDigit

Tipo: Microsoft.VisualBasic.TriState
Opcional.Constante TriState que indica si se va a mostrar un cero inicial para los valores
fraccionarios o no.Vea los valores en "Configuración".

UseParensForNegativeNumbers

Tipo: Microsoft.VisualBasic.TriState
Opcional.Constante TriStateque indica si los valores negativos se van a colocar entre
paréntesis o no.Vea los valores en "Configuración".

GroupDigits

Tipo: Microsoft.VisualBasic.TriState
Opcional.Constante TriStateque indica si los números se agrupan utilizando el delimitador de
grupo especificado en la configuración regional o no.Vea los valores en "Configuración".

Valor devuelto
Tipo: System.String
Devuelve una expresión con formato de porcentaje (multiplicada por 100), acompañada del carácter
final %.

Excepciones
Excepción Condición

InvalidCastException
El tipo no es numérico.
Comentarios

Cuando se omitan uno o más argumentos opcionales, la configuración regional del equipo
proporcionará los valores correspondientes.

Nota

Toda la información de configuración provendrá de la configuración regional de la


aplicación.De manera predeterminada, la configuración regional será la establecida en el panel
de control.No obstante, la configuración regional podrá cambiarse mediante programación en
.NET Framework.

Los argumentos IncludeLeadingDigit, UseParensForNegativeNumbers y GroupDigits tienen


los siguientes valores.

Constante Descripción
TriState.True True
TriState.False False
TriState.Default Configuración regional del equipo
Ejemplos

Este ejemplo muestra el uso de la función FormatPercent.

VB

Copiar

Dim TestNumber As Single = 0.76


' Returns "76.00%".
Dim TestString As String = FormatPercent(TestNumber)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
.NET Framework Client Profile
Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.InStr (Método)
.NET Framework 4.5
Otras versiones

Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

Devuelve un entero que especifica la posición inicial de la primera aparición de una cadena
dentro de otra.

Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
InStr(String, String, Devuelve un entero que especifica la posición inicial de la
CompareMethod) primera aparición de una cadena dentro de otra.
InStr(Int32, String, String, Devuelve un entero que especifica la posición inicial de la
CompareMethod) primera aparición de una cadena dentro de otra.

Strings.InStrRev (Método)
.NET Framework 4.5

Otras versiones
Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve la posición de la primera aparición de una cadena dentro de otra, comenzando por el
extremo derecho de la cadena.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function InStrRev ( _
StringCheck As String, _
StringMatch As String, _
Start As Integer, _
Compare As CompareMethod _
) As Integer

Parámetros
StringCheck

Tipo: System.String
Requerido.Expresión de cadena en la que se va a buscar.

StringMatch

Tipo: System.String
Requerido.Expresión de cadena que se va a buscar.

Start

Tipo: System.Int32
Opcional.Expresión numérica que establece la posición inicial de base 1 para cada búsqueda,
empezando por el lado izquierdo de la cadena.Si se omite Start, se utiliza -1, lo que significa
que la búsqueda comienza en la posición del último carácter.A continuación, la búsqueda se
realiza de derecha a izquierda.

Compare

Tipo: Microsoft.VisualBasic.CompareMethod
Opcional.Valor numérico que indica el tipo de comparación que se va a utilizar al evaluar
subcadenas.Si se omite, se realiza una comparación binaria.Para obtener los valores, vea
Configuración.

Valor devuelto
Tipo: System.Int32

Si InStrRev devolverá:
StringCheck tiene longitud
0
cero
StringMatch tiene longitud
Start
cero
No se encuentra StringMatch. 0
StringMatch se encuentra La posición en la que se localice la primera coincidencia,
dentro de StringCheck comenzando por el extremo derecho de la cadena
Start es mayor que la longitud
0
de StringMatch
Excepciones

Excepción Condición

ArgumentException
Start = 0 ó Start <-1.
Comentarios

Observe que la sintaxis de la función InStrRev no es la misma que la de la función InStr.

El argumento Compare puede tener los siguientes valores:

Constante Descripción
Binary Realiza una comparación binaria.
Text Realiza una comparación textual.
Ejemplos
En este ejemplo se muestra el uso de la función InStrRev.

VB

Copiar

Dim TestString As String = "the quick brown fox jumps over the lazy dog"
Dim TestNumber As Integer
' Returns 32.
TestNumber = InStrRev(TestString, "the")
' Returns 1.
TestNumber = InStrRev(TestString, "the", 16)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.Join (Método)
.NET Framework 4.5
Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena creada a partir de la combinación de varias subcadenas contenidas en


una matriz.
Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
Join(Object(), Devuelve una cadena creada a partir de la combinación de varias
String) subcadenas contenidas en una matriz.
Join(String(), Devuelve una cadena creada a partir de la combinación de varias
String) subcadenas contenidas en una matriz.

Strings.LCase (Método)
.NET Framework 4.5
Otras versiones

Personas que lo han encontrado útil: 0 de 1 - Valorar este tema

Devuelve una cadena o un carácter convertidos en minúscula.

Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
LCase(Char) Devuelve una cadena o un carácter convertidos en minúscula.
LCase(String) Devuelve una cadena o un carácter convertidos en minúscula.

Strings.Left (Método)
.NET Framework 4.5

Otras versiones
Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

Devuelve una cadena que contiene un número especificado de caracteres a partir del lado
izquierdo de una cadena.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function Left ( _
str As String, _
Length As Integer _
) As String

Parámetros
str

Tipo: System.String
Requerido.Expresión de tipo String de la que se devuelven los caracteres situados más a la
izquierda.

Length

Tipo: System.Int32
Requerido.Expresión Integer.Expresión numérica que indica el número de caracteres que se
van a devolver.Si es 0, se devuelve una cadena de longitud cero ("").Si es mayor o igual que el
número de caracteres en str, se devuelve la cadena completa.
Valor devuelto
Tipo: System.String
Devuelve una cadena que contiene un número especificado de caracteres a partir del lado izquierdo
de una cadena.

Excepciones

Excepción Condición

ArgumentException
Length < 0.
Comentarios

Para determinar el número de caracteres de str, utilice la función Len.Si se utiliza en una
aplicación de Windows Forms o en cualquier otra clase que tiene una propiedad Left, debe
calificar totalmente la función con Microsoft.VisualBasic.Left.

Nota

La función LeftB de versiones anteriores de Visual Basic devuelve una cadena en bytes, en
lugar de caracteres.Se utiliza principalmente para convertir cadenas en aplicaciones de juegos
de caracteres de doble byte (DBCS).Todas las cadenas actuales de Visual Basic están en
Unicode y ya no se admite LeftB.
Ejemplos

En este ejemplo se muestra el uso de la función Left para devolver una subcadena de una
String dada.En una clase que tenga una propiedad Left, podría ser necesario calificar la
función Left plenamente.

VB

Copiar

Dim TestString As String = "Hello World!"


' Returns "Hello".
Dim subString As String = Left(TestString, 5)

Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.Len (Método)
.NET Framework 4.5
Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve un entero que contiene el número de caracteres de una cadena o el número nominal
de bytes necesarios para almacenar una variable.

Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Boolean)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Byte)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Char)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(DateTime)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Decimal)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Double)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Int16)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Int32)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Int64)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Object)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(SByte)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(Single)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(String)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(UInt16)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(UInt32)
número nominal de bytes necesarios para almacenar una variable.
Devuelve un entero que contiene el número de caracteres de una cadena o el
Len(UInt64)
número nominal de bytes necesarios para almacenar una variable.

Strings.LSet (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena alineada a la izquierda que contiene la cadena especificada ajustada a la
longitud indicada.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)
Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function LSet ( _
Source As String, _
Length As Integer _
) As String

Parámetros
Source

Tipo: System.String
Requerido.Expresión String.Nombre de variable de cadena.

Length

Tipo: System.Int32
Requerido.Expresión Integer.Longitud de la cadena devuelta.

Valor devuelto
Tipo: System.String
Devuelve una cadena alineada a la izquierda que contiene la cadena especificada ajustada a la
longitud indicada.

Comentarios

Si la cadena especificada es más larga que la longitud dada, la cadena devuelta se acorta
ajustándose a la longitud indicada.Si la cadena especificada es más corta que la longitud dada,
se agregan espacios al extremo derecho de la cadena devuelta para que su longitud sea la
adecuada.

Ejemplos
En este ejemplo se muestra el uso de la función LSet.

VB

Copiar

Dim TestString As String = "Left"


Dim lString As String
' Returns "Left "
lString = LSet(TestString, 10)
' Returns "Le"
lString = LSet(TestString, 2)
' Returns "Left"
lString = LSet(TestString, 4)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.LTrim (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema


Devuelve una cadena que contiene una copia de una cadena especificada sin espacios iniciales
(LTrim), sin espacios finales (RTrim) o sin espacios iniciales ni finales (Trim).

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function LTrim ( _
str As String _
) As String

Parámetros
str

Tipo: System.String
Requerido.Cualquier expresión de String válida.

Valor devuelto
Tipo: System.String
Devuelve una cadena que contiene una copia de una cadena especificada sin espacios iniciales
(LTrim), sin espacios finales (RTrim) o sin espacios iniciales ni finales (Trim).

Comentarios

Las funciones LTrim, RTrim y Trim quitan los espacios de los finales de las cadenas.

Ejemplos

En este ejemplo se usa la función LTrim para quitar los espacios iniciales y la función RTrim
para quitar los espacios finales de una variable de cadena.También se usa la función Trim para
quitar ambos tipos de espacios.
VB

Copiar

' Initializes string.


Dim TestString As String = " <-Trim-> "
Dim TrimString As String
' Returns "<-Trim-> ".
TrimString = LTrim(TestString)
' Returns " <-Trim->".
TrimString = RTrim(TestString)
' Returns "<-Trim->".
TrimString = LTrim(RTrim(TestString))
' Using the Trim function alone achieves the same result.
' Returns "<-Trim->".
TrimString = Trim(TestString)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.Mid (Método)
.NET Framework 4.5
Otras versiones

Personas que lo han encontrado útil: 0 de 2 - Valorar este tema


Devuelve una cadena que a su vez contiene un número especificado de caracteres de una
cadena.

Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
Devuelve una cadena que a su vez contiene un número especificado de
Mid(String, Int32)
caracteres de una cadena.
Mid(String, Int32, Devuelve una cadena que a su vez contiene un número especificado de
Int32) caracteres de una cadena.

Strings.Replace (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena en la que la subcadena especificada se reemplaza determinado número


de veces por otra subcadena.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB
Copiar

'Declaración
Public Shared Function Replace ( _
Expression As String, _
Find As String, _
Replacement As String, _
Start As Integer, _
Count As Integer, _
Compare As CompareMethod _
) As String

Parámetros
Expression

Tipo: System.String
Requerido.Expresión de cadena que contiene la subcadena que se va a reemplazar.

Find

Tipo: System.String
Requerido.Subcadena que se va a buscar.

Replacement

Tipo: System.String
Requerido.Subcadena de reemplazo.

Start

Tipo: System.Int32
Opcional.Posición dentro de Expression que inicia una subcadena usada para el reemplazo.El
valor devuelto de Replace es una cadena que comienza en Start, con substituciones
adecuadas.Si se omite, se supone que el valor es 1.

Count

Tipo: System.Int32
Opcional.Número de reemplazos de subcadena que se van a realizar.Si se omite, el valor
predeterminado es -1, lo que significa que se van a realizar todos los reemplazos posibles.

Compare

Tipo: Microsoft.VisualBasic.CompareMethod
Opcional.Valor numérico que indica el tipo de comparación que se va a utilizar al evaluar
subcadenas.Para obtener los valores, vea Configuración.
Valor devuelto
Tipo: System.String
Replace devuelve los siguientes valores.

Si Replace devolverá:
Find es de longitud cero o Nothing Copia de Expression
Copia de Expression sin
Replace tiene longitud cero
apariciones de Find
Expression es de longitud cero o Nothing, o bien Start es
Nothing
mayor que la longitud de Expression
Count es igual a 0, Copia de Expression
Excepciones

Excepción Condición

ArgumentException
Count < -1 ó Start <= 0.
Comentarios

El valor que devuelve la función Replace es una cadena que comienza en la posición
especificada por Start y concluye al final de la cadena Expression, con las sustituciones
efectuadas según especifican los valores de Find y Replace.

El argumento Compare puede tener los siguientes valores:

Constante Descripción
Binary Realiza una comparación binaria
Text Realiza una comparación textual
Ejemplos

En este ejemplo se muestra el uso de la función Replace.

VB

Copiar

Dim TestString As String = "Shopping List"


' Returns "Shipping List".
Dim aString As String = Replace(TestString, "o", "i")
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.Right (Método)
.NET Framework 4.5

Otras versiones

Personas que lo han encontrado útil: 0 de 2 - Valorar este tema

Devuelve una cadena que contiene un número especificado de caracteres desde el lado
derecho de una cadena.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#
VB

Copiar

'Declaración
Public Shared Function Right ( _
str As String, _
Length As Integer _
) As String

Parámetros
str

Tipo: System.String
Requerido.Expresión de tipo String de la que se devuelven los caracteres situados más a la
derecha.

Length

Tipo: System.Int32
Requerido.Integer.Expresión numérica que indica el número de caracteres que se van a
devolver.Si es 0, se devuelve una cadena de longitud cero ("").Si es mayor o igual que el
número de caracteres en str, se devuelve la cadena completa.

Valor devuelto
Tipo: System.String
Devuelve una cadena que contiene un número especificado de caracteres desde el lado derecho de
una cadena.

Excepciones

Excepción Condición

ArgumentException
Length < 0.
Comentarios

Para determinar el número de caracteres de str, utilice la función Len.Si se utiliza en un


Windows Form o en cualquier otra clase que tiene una propiedad Right, debe calificar
totalmente la función con Microsoft.VisualBasic.Strings.Right.

Nota

La función RightB de versiones anteriores de Visual Basic devuelve una cadena en bytes, en
lugar de caracteres.Se utiliza principalmente para convertir cadenas en aplicaciones de juegos
de caracteres de doble byte (DBCS).Todas las cadenas actuales de Visual Basic están en
Unicode y ya no se admite RightB.
Ejemplos

En este ejemplo se muestra el uso de la función Right para devolver una subcadena de una
String dada.En una clase que tenga una propiedad Right, podría ser necesario calificar la
función Right plenamente.

VB

Copiar

Dim TestString As String = "Hello World!"


' Returns "World!".
Dim subString As String = Right(TestString, 6)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.RSet (Método)
.NET Framework 4.5

Otras versiones
Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena alineada a la derecha que contiene la cadena especificada y con la
longitud especificada.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function RSet ( _
Source As String, _
Length As Integer _
) As String

Parámetros
Source

Tipo: System.String
Requerido.Expresión String.Nombre de variable de cadena.

Length

Tipo: System.Int32
Requerido.Expresión Integer.Longitud de la cadena devuelta.

Valor devuelto
Tipo: System.String
Devuelve una cadena alineada a la derecha que contiene la cadena especificada y con la longitud
especificada.

Comentarios
Si Source tiene una longitud mayor que Length, RSet coloca sólo los caracteres situados más a
la izquierda, hasta alcanzar la longitud de Source, en la cadena devuelta.Si la cadena
especificada es más corta que la longitud indicada, se agregan espacios al extremo izquierdo
de la cadena para que su longitud sea la adecuada.Si la cadena especificada es más larga que la
longitud indicada, se acorta ajustándose a la longitud especificada.

Ejemplos

En este ejemplo se muestra el uso de la función RSet.

VB

Copiar

Dim TestString As String = "Right"


' Returns " Right"
Dim rString As String = RSet(TestString, 11)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.RTrim (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena que contiene una copia de una cadena especificada sin espacios iniciales
(LTrim), sin espacios finales (RTrim) o sin espacios iniciales ni finales (Trim).

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function RTrim ( _
str As String _
) As String

Parámetros
str

Tipo: System.String
Requerido.Cualquier expresión de String válida.

Valor devuelto
Tipo: System.String
Devuelve una cadena que contiene una copia de una cadena especificada sin espacios iniciales
(LTrim), sin espacios finales (RTrim) o sin espacios iniciales ni finales (Trim).

Comentarios
Las funciones LTrim, RTrim y Trim quitan los espacios de los finales de las cadenas.

Ejemplos

En este ejemplo se usa la función LTrim para quitar los espacios iniciales y la función RTrim
para quitar los espacios finales de una variable de cadena.También se usa la función Trim para
quitar ambos tipos de espacios.

VB

Copiar

' Initializes string.


Dim TestString As String = " <-Trim-> "
Dim TrimString As String
' Returns "<-Trim-> ".
TrimString = LTrim(TestString)
' Returns " <-Trim->".
TrimString = RTrim(TestString)
' Returns "<-Trim->".
TrimString = LTrim(RTrim(TestString))
' Using the Trim function alone achieves the same result.
' Returns "<-Trim->".
TrimString = Trim(TestString)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.
Strings.Space (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena que consta del número especificado de espacios.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function Space ( _
Number As Integer _
) As String

Parámetros
Number

Tipo: System.Int32
Requerido.Expresión Integer.Número de espacios deseados en la cadena.

Valor devuelto
Tipo: System.String
Devuelve una cadena que consta del número especificado de espacios.

Excepciones
Excepción Condición

ArgumentException
Number < 0.
Comentarios

La función Space es útil para dar formato a datos de salida y descartar información en cadenas
de longitud fija.

Ejemplos

En este ejemplo se utiliza la función Space para devolver una cadena formada por un número
de espacios especificado.

VB

Copiar

Dim TestString As String


' Returns a string with 10 spaces.
TestString = Space(10)
' Inserts 10 spaces between two strings.
TestString = "Hello" & Space(10) & "World"

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.Split (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una matriz unidimensional basada en cero que contiene un número especificado de
subcadenas.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function Split ( _
Expression As String, _
Delimiter As String, _
Limit As Integer, _
Compare As CompareMethod _
) As String()

Parámetros
Expression

Tipo: System.String
Requerido.Expresión de tipo String que contiene subcadenas y delimitadores.
Delimiter

Tipo: System.String
Opcional.Cualquier carácter individual que se utilice para identificar los límites de las
subcadenas.Si se omite Delimiter, se supone que el carácter de espacio (" ") es el delimitador.

Limit

Tipo: System.Int32
Opcional.Número máximo de subcadenas en las que se debe dividir la cadena de entrada.El
valor predeterminado es -1, que indica que la cadena de entrada se debe dividir cada vez que
aparece la cadena Delimiter.

Compare

Tipo: Microsoft.VisualBasic.CompareMethod
Opcional.Valor numérico que indica la comparación que se va a utilizar al evaluar
subcadenas.Vea los valores en "Configuración".

Valor devuelto
Tipo: System.String()
Matriz de String.Si Expression es una cadena de longitud cero (""), Split devuelve una matriz de un
solo elemento que contiene una cadena de longitud cero.Si Delimiter es una cadena de longitud cero
o si no aparece en Expression, Split devuelve una matriz de un solo elemento que contiene toda la
cadena Expression.

Comentarios

De manera predeterminada, o cuando Limit es igual a -1, la función Split divide la cadena de
entrada en cada aparición de la cadena de delimitación, y devuelve las subcadenas en una
matriz.Cuando el parámetro Limit es mayor que cero, la función Split divide la cadena en las
primeras apariciones en las que el valor de Limit es -1 y devuelve una matriz con las
subcadenas resultantes.Por ejemplo, Split("a:b:c", ":") devuelve la matriz {"a", "b", "c"},
mientras que Split("a:b:c", ":", 2) devuelve la matriz {"a", "b:c"}.

Cuando la función Split encuentra dos delimitadores seguidos o un delimitador al principio o


al final de la cadena, interpreta que estos delimitadores encierran una cadena vacía ("").Por
ejemplo, Split("xx", "x") devuelve la matriz que contiene tres cadenas vacías: una cadena que
va desde el comienzo de la cadena hasta la primera "x", otra cadena que abarca el espacio
comprendido entre las dos "x" y una última que va desde la última "x" hasta el final de la
cadena.

En esta tabla se muestra cómo los parámetros opcionales Delimiter, Limit y Compare pueden
cambiar el comportamiento de la función Split.
Dividir llamada Valor devuelto
Split("42, 12, 19") {"42," , "12," , "19"}
Split("42, 12, 19", ", ") {"42", "12", "19"}
Split("42, 12, 19", ", ", 2) {"42", "12, 19"}
Split("192.168.0.1", ".") {"192", "168", "0", "1"}
Split("Alice and Bob", " AND ") {"Alice and Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text) {"Alice", "Bob"}
Split("someone@example.com", "@",1) {"someone@example.com"}
Split("someone@example.com", "@",2) {"someone", "example.com"}

El argumento Compare puede tener los siguientes valores:

Constante Descripción Valor


CompareMethod.Binary Realiza una comparación binaria 0
CompareMethod.Text Realiza una comparación textual 1
Ejemplos

En el ejemplo siguiente se muestra cómo se divide una cadena en los espacios que contiene.

VB

Copiar

Dim TestString As String = "Look at these!"


' Returns an array containing "Look", "at", and "these!".
Dim TestArray() As String = Split(TestString)

En el ejemplo siguiente se muestra cómo se dividen cadenas con varios delimitadores seguidos
y cómo se filtran las cadenas vacías.

VB

Copiar

Dim TestString As String = "apple pear banana "


Dim TestArray() As String = Split(TestString)
' TestArray holds {"apple", "", "", "", "pear", "banana", "", ""}
Dim LastNonEmpty As Integer = -1
For i As Integer = 0 To TestArray.Length - 1
If TestArray(i) <> "" Then
LastNonEmpty += 1
TestArray(LastNonEmpty) = TestArray(i)
End If
Next
ReDim Preserve TestArray(LastNonEmpty)
' TestArray now holds {"apple", "pear", "banana"}

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.StrComp (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve un valor, -1, 0 ó 1, que indica el resultado de una comparación de cadena.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis
C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function StrComp ( _
String1 As String, _
String2 As String, _
Compare As CompareMethod _
) As Integer

Parámetros
String1

Tipo: System.String
Requerido.Cualquier expresión de String válida.

String2

Tipo: System.String
Requerido.Cualquier expresión de String válida.

Compare

Tipo: Microsoft.VisualBasic.CompareMethod
Opcional.Especifica el tipo de comparación de cadenas.Si se omite Compare, la configuración
de Option Compare determina el tipo de comparación.

Valor devuelto
Tipo: System.Int32
La función StrComp devuelve los siguientes valores.

Si StrComp devuelve
String1 se ordena delante de String2 -1
String1 es igual a String2 0
String1 se ordena después de String2 1
Excepciones

Excepción Condición
ArgumentException
El valor de Compare no es válido.
Comentarios

Las cadenas se comparan por valores alfanuméricos ordenados comenzando por el primer
carácter.Para obtener más información sobre comparaciones binarias y textuales, así como
criterios de ordenación, vea Option Compare (Instrucción).

Los valores del argumento Compare son:

Constante Descripción
Realiza una comparación binaria basada en un criterio de ordenación que se deriva
Binary
de las representaciones binarias internas de los caracteres.
Realiza una comparación de texto, basándose en un criterio de ordenación de texto
Text sin distinción entre mayúsculas y minúsculas que viene determinado por el valor de
LocaleID del sistema.
Ejemplos

En este ejemplo se utiliza la función StrComp para devolver los resultados de una
comparación de cadena.

VB

Copiar

' Defines variables.


Dim TestStr1 As String = "ABCD"
Dim TestStr2 As String = "abcd"
Dim TestComp As Integer
' The two strings sort equally. Returns 0.
TestComp = StrComp(TestStr1, TestStr2, CompareMethod.Text)
' TestStr1 sorts before TestStr2. Returns -1.
TestComp = StrComp(TestStr1, TestStr2, CompareMethod.Binary)
' TestStr2 sorts after TestStr1. Returns 1.
TestComp = StrComp(TestStr2, TestStr1, CompareMethod.Binary)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
.NET Framework Client Profile
Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.StrConv (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena convertida según se ha especificado.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function StrConv ( _
str As String, _
Conversion As VbStrConv, _
LocaleID As Integer _
) As String

Parámetros
str

Tipo: System.String
Requerido.Expresión de tipo String que se va a convertir.

Conversion

Tipo: Microsoft.VisualBasic.VbStrConv
Requerido.Miembro VbStrConv.Valor de enumeración que especifica el tipo de conversión
que se va a realizar.

LocaleID

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

Valor devuelto
Tipo: System.String
Devuelve una cadena convertida según se ha especificado.

Excepciones

Excepción Condición

ArgumentException LocaleID no admitido, Conversion < 0 o > 2048, o conversión no admitida


para la configuración regional especificada.
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 sobre la 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.

Los valores del argumento Conversion son:

Miembro de la enumeración Descripción


VbStrConv.None No se realiza ninguna conversión
Usa mayúsculas o minúsculas con arreglo a criterios
lingüísticos, más que los del sistema de archivos
VbStrConv.LinguisticCasing
(predeterminado).Válido con VbStrConv.UpperCase y
VbStrConv.LowerCase solamente.
VbStrConv.UpperCase Convierte la cadena en caracteres en mayúscula.
VbStrConv.LowerCase Convierte la cadena en caracteres en minúscula.
Pone en mayúscula la primera letra de cada palabra de la
VbStrConv.ProperCase
cadena.
Convierte los caracteres estrechos (ancho medio) de la
VbStrConv.Wide*
cadena en caracteres anchos (ancho completo).
Convierte los caracteres anchos (ancho completo) de la
VbStrConv.Narrow*
cadena en caracteres estrechos (ancho medio).
Convierte los caracteres hiragana de la cadena en caracteres
VbStrConv.Katakana**
katakana.
Convierte los caracteres katakana de la cadena en caracteres
VbStrConv.Hiragana**
hiragana.
Convierte los caracteres de chino tradicional a chino
VbStrConv.SimplifiedChinese*
simplificado.
Convierte los caracteres de chino simplificado en chino
VbStrConv.TraditionalChinese*
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.

Ejemplos

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

VB

Copiar

Dim sText As String = "Hello World"


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

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.
Strings.StrDup (Método)
.NET Framework 4.5
Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena o un objeto que se compone del carácter especificado repetido el número
de veces especificado.

Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
StrDup(Int32, Devuelve una cadena o un objeto que se compone del carácter
Char) especificado repetido el número de veces especificado.
StrDup(Int32, Devuelve una cadena o un objeto que se compone del carácter
Object) especificado repetido el número de veces especificado.
StrDup(Int32, Devuelve una cadena o un objeto que se compone del carácter
String) especificado repetido el número de veces especificado.

Strings.StrReverse (Método)
.NET Framework 4.5

Otras versiones

Personas que lo han encontrado útil: 0 de 1 - Valorar este tema

Devuelve una cadena en la que se invierte el orden de los caracteres de la cadena especificada.

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)
Sintaxis

C#

C++

F#

VB

Copiar

'Declaración
Public Shared Function StrReverse ( _
Expression As String _
) As String

Parámetros
Expression

Tipo: System.String
Requerido.Expresión de cadena cuyos caracteres se van a invertir.Si Expression es una cadena
de longitud cero (""), se devuelve una cadena de longitud cero.

Valor devuelto
Tipo: System.String
Devuelve una cadena en la que se invierte el orden de los caracteres de la cadena especificada.

Comentarios

La función StrReverse devuelve una cadena que contiene los mismos caracteres que
Expression, pero en el orden contrario.

Ejemplos

VB

Copiar

Dim TestString As String = "ABCDEFG"


' Returns "GFEDCBA".
Dim revString As String = StrReverse(TestString)
Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.Trim (Método)
.NET Framework 4.5

Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena que contiene una copia de una cadena especificada sin espacios iniciales
(LTrim), sin espacios finales (RTrim) o sin espacios iniciales ni finales (Trim).

Espacio de nombres: Microsoft.VisualBasic


Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

Sintaxis

C#

C++
F#

VB

Copiar

'Declaración
Public Shared Function Trim ( _
str As String _
) As String

Parámetros
str

Tipo: System.String
Requerido.Cualquier expresión de String válida.

Valor devuelto
Tipo: System.String
Devuelve una cadena que contiene una copia de una cadena especificada sin espacios iniciales
(LTrim), sin espacios finales (RTrim) o sin espacios iniciales ni finales (Trim).

Comentarios

Las funciones LTrim, RTrim y Trim quitan los espacios de los finales de las cadenas.

Ejemplos

En este ejemplo se usa la función LTrim para quitar los espacios iniciales y la función RTrim
para quitar los espacios finales de una variable de cadena.También se usa la función Trim para
quitar ambos tipos de espacios.

VB

Copiar

' Initializes string.


Dim TestString As String = " <-Trim-> "
Dim TrimString As String
' Returns "<-Trim-> ".
TrimString = LTrim(TestString)
' Returns " <-Trim->".
TrimString = RTrim(TestString)
' Returns "<-Trim->".
TrimString = LTrim(RTrim(TestString))
' Using the Trim function alone achieves the same result.
' Returns "<-Trim->".
TrimString = Trim(TestString)

Información de versión

.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile


Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008
(no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con
SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las
versiones compatibles, vea Requisitos de sistema de .NET Framework.

Strings.UCase (Método)
.NET Framework 4.5
Otras versiones

Este tema aún no ha recibido ninguna valoración - Valorar este tema

Devuelve una cadena o un carácter que contiene la cadena especificada convertida en


mayúsculas.

Este miembro está sobrecargado. Para obtener información completa sobre este miembro,
incluida la sintaxis, el uso y algunos ejemplos, haga clic en un nombre de la lista de
sobrecarga.

Lista de sobrecarga

Nombre Descripción
UCase(Char) Devuelve una cadena o un carácter que contiene la cadena especificada
convertida en mayúsculas.
Devuelve una cadena o un carácter que contiene la cadena especificada
UCase(String)
convertida en mayúsculas.

S-ar putea să vă placă și