Funciones canónicas de cadena (Entity SQL)

  • Artículo

Entity SQL incluye funciones canónicas de cadena.

Notas

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

Valor de tipo 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')

Bb738534.note(es-es,VS.100).gifNota:
Si está usando el proveedor de datos SQL Server, esta función devuelve false si la cadena está almacenada 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

Valor de tipo 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: valor de tipo String.

length: valor de tipo Int16, Int32, Int64 o Byte. El parámetro length no puede ser menor que cero.

Valor devuelto

Valor de tipo String.

Ejemplo

-- The following example returns abc.

Left('abcxyz', 3)

Length ( string )

Devuelve la longitud (Int32) de la cadena en caracteres.

Argumentos

string: valor de tipo String.

Valor devuelto

Int32.

Ejemplo

-- The following example returns 6.

Legth('abcxyz')

LTrim( string )

Devuelve string sin el espacio en blanco inicial.

Argumentos

Objeto String.

Valor devuelto

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

Objeto String.

Valor devuelto

Valor de tipo String.

Ejemplo

-- The following example returns abcxyz.

Concat('abc', 'xyz')

Reverse ( string )

Devuelve string con el orden de los caracteres invertidos.

Argumentos

Objeto String.

Valor devuelto

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: valor de tipo String.

length: valor de tipo Int16, Int32, Int64 o Byte. El parámetro length no puede ser menor que cero.

Valor devuelto

Objeto String.

Ejemplo

-- The following example returns xyz.

Right('abcxyz', 3)

RTrim( string )

Devuelve string sin el espacio en blanco final.

Argumentos

Objeto String.

Valor devuelto

Valor de tipo 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: valor de tipo 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

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

Objeto String.

Valor devuelto

Valor de tipo 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

Objeto String.

Valor devuelto

Valor de tipo String.

Ejemplo

-- The following example returns ABC.

ToUpper('abc')

Trim( string )

Devuelve string sin el espacio en blanco inicial ni final.

Argumentos

Objeto String.

Valor devuelto

Valor de tipo 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, vea Proveedor de datos .NET Framework para SQL Server (SqlClient) para las funciones de Entity Framework.

Vea también

Conceptos

Funciones canónicas (Entity SQL)