Documente Academic
Documente Profesional
Documente Cultură
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"
' 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")
Strings.Asc (Método)
.NET Framework 4.5
Otras versiones
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
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
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
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.
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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
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.
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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
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 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
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
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.
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 #).
"#,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".
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
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.
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).
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
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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.
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
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
Valor Descripción
TriState.True True
TriState.False False
TriState.UseDefault Configuración regional del equipo
Ejemplos
VB
Copiar
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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
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
VB
Copiar
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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
Constante Descripción
TriState.True True
TriState.False False
TriState.UseDefault Configuración regional del equipo
Ejemplos
VB
Copiar
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
Devuelve una expresión con formato de porcentaje (multiplicada por 100), acompañada del
carácter final %.
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
Constante Descripción
TriState.True True
TriState.False False
TriState.Default Configuración regional del equipo
Ejemplos
VB
Copiar
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
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.
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
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
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
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
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.
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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
Devuelve una cadena alineada a la izquierda que contiene la cadena especificada ajustada a la
longitud indicada.
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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
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.
Constante Descripción
Binary Realiza una comparación binaria
Text Realiza una comparación textual
Ejemplos
VB
Copiar
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
Devuelve una cadena que contiene un número especificado de caracteres desde el lado
derecho de una cadena.
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
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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.
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
VB
Copiar
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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).
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
Devuelve una matriz unidimensional basada en cero que contiene un número especificado de
subcadenas.
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"}.
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"}
En el ejemplo siguiente se muestra cómo se divide una cadena en los espacios que contiene.
VB
Copiar
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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).
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
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
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
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
VB
Copiar
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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
Devuelve una cadena en la que se invierte el orden de los caracteres de la cadena especificada.
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
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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
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).
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
Información de versión
.NET Framework
Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
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 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.