Funciones canónicas de cadena
Entity SQL incluye funciones canónicas de cadena.
Comentarios
En la tabla siguiente se muestran las funciones canónicas de cadena de Entity SQL.
| Función | Descripción |
|---|---|
Concat(string1, string2) |
Devuelve una cadena que contiene una string2 anexada a string1.Argumentos string1: la cadena a la que se anexa string2.string2: la cadena que se anexa a string1.Valor devuelto Un objeto String. Se producirá un error si la longitud de la cadena del valor devuelto es mayor que la longitud máxima permitida.Ejemplo -- The following example returns abcxyz.Concat('abc', 'xyz') |
Contains(string, target) |
Devuelve true si target está incluida en string.Argumentos string: la cadena en la que se busca.target: la cadena de destino que se busca.Valor devuelto Es true si target está incluida en string; de lo contrario, es false.Ejemplo -- The following example returns true.Contains('abc', 'bc') |
EndsWith(string, target) |
Devuelve true si la cadena target está situada al final de la cadena string.Argumentos string: la cadena en la que se busca.target: La cadena de destino que se busca al final de string.Valor devuelto True si string termina por target; de lo contrario false.Ejemplo -- The following example returns true.EndsWith('abc', 'bc') Nota: Si usa el proveedor de datos de SQL Server, esta función devuelve false si la cadena se almacena en una columna de cadena de longitud fija y target es una constante. En este caso, se buscará en toda la cadena, incluyendo los espacios finales de relleno que pueda haber. Una posible solución alternativa es recortar los datos de la cadena de longitud fija, como en el ejemplo siguiente: EndsWith(TRIM(string), target) |
IndexOf(target, string) |
Devuelve la posición de target dentro de string, o 0 si no se encuentra. Devuelve 1 para indicar el principio de string. La numeración del índice empieza a partir de 1.Argumentos target: la cadena que se busca.string: la cadena en la que se busca.Valor devuelto Una clase Int32.Ejemplo -- The following example returns 4.IndexOf('xyz', 'abcxyz') |
Left(string, length) |
Devuelve los primeros length caracteres del lado izquierdo de string. Si la longitud de string es menor que length, se devuelve la cadena entera.Argumentos string: un valor String.length: valor de tipoInt16,Int32, Int64 o Byte. El parámetro length no puede ser menor que cero.Valor devuelto Un objeto String.Ejemplo -- The following example returns abc.Left('abcxyz', 3) |
Length(string) |
Devuelve la longitud (Int32) de la cadena en caracteres.Argumentos string: un valor String.Valor devuelto Una clase Int32.Ejemplo -- The following example returns 6.Length('abcxyz') |
LTrim(string) |
Devuelve string sin el espacio en blanco inicial.Argumentos Un objeto String.Valor devuelto Un objeto String.Ejemplo -- The following example returns abc.LTrim(' abc') |
Replace(string1, string2, string3) |
Devuelve string1, con todas las apariciones de string2 reemplazadas por string3.Argumentos Un objeto String.Valor devuelto Un objeto String.Ejemplo -- The following example returns abcxyz.Concat('abc', 'xyz') |
Reverse(string) |
Devuelve string con el orden de los caracteres invertidos.Argumentos Un objeto String.Valor devuelto Un objeto String.Ejemplo -- The following example returns dcba.Reverse('abcd') |
Right(string, length) |
Devuelve los últimos length caracteres de string. Si la longitud de string es menor que length, se devuelve la cadena entera.Argumentos string: un valor String.length: valor de tipoInt16,Int32, Int64 o Byte. El parámetro length no puede ser menor que cero.Valor devuelto Un objeto String.Ejemplo -- The following example returns xyz.Right('abcxyz', 3) |
RTrim(string) |
Devuelve string sin el espacio en blanco final.Argumentos Un objeto String.Valor devuelto Un objeto String. |
Substring(string, start, length) |
Devuelve la subcadena de la cadena a partir de la posición start, con una longitud de length caracteres. Si se inicia a partir de 1, indica el primer carácter de la cadena. La numeración del índice empieza a partir de 1.Argumentos string: un valor String.start: valor de tipo Int16, Int32, Int64 y Byte. El parámetro start no puede ser menor que uno.length: valor de tipo Int16, Int32, Int64 y Byte. El parámetro length no puede ser menor que cero.Valor devuelto Un objeto String.Ejemplo -- The following example returns xyz.Substring('abcxyz', 4, 3) |
StartsWith(string, target) |
Devuelve true si el objeto string comienza por target.Argumentos string: la cadena en la que se busca.target: la cadena de destino que se busca al principio de string.Valor devuelto True si el objeto string comienza por target; de lo contrario, false.Ejemplo -- The following example returns true.StartsWith('abc', 'ab') |
ToLower(string) |
Devuelve una string con los caracteres en mayúscula pasados a minúscula.Argumentos Un objeto String.Valor devuelto Un objeto String.Ejemplo -- The following example returns abc.ToLower('ABC') |
ToUpper(string) |
Devuelve una string con los caracteres en minúscula pasados a mayúscula.Argumentos Un objeto String.Valor devuelto Un objeto String.Ejemplo -- The following example returns ABC.ToUpper('abc') |
Trim(string) |
Devuelve string sin el espacio en blanco inicial ni final.Argumentos Un objeto String.Valor devuelto Un objeto String.Ejemplo -- The following example returns abc.Trim(' abc ') |
Estas funciones devolverán null si se proporciona la entrada null.
La funcionalidad equivalente está disponible en el proveedor administrado de Microsoft SQL Client. Para obtener más información, consulte SqlClient para funciones de Entity Framework.