Funciones canónicas de cadenaString Canonical Functions

Entity SQLEntity SQL incluye funciones canónicas de cadena.includes string canonical functions.

ComentariosRemarks

En la tabla siguiente se muestran las funciones canónicas de cadena de Entity SQLEntity SQL.The following table shows the string Entity SQLEntity SQL canonical functions.

FunciónFunction DESCRIPCIÓNDescription
Concat(string1, string2) Devuelve una cadena que contiene una string2 anexada a string1.Returns a string that contains string2 appended to string1.

ArgumentosArguments

string1: Cadena a la que string2 se anexa.string1: The string to which string2 is appended.

string2: Cadena que se anexa a string1.string2: The string that is appended to string1.

Valor devueltoReturn Value

Objeto String.A String. Se producirá un error si la longitud de la cadena del valor devuelto es mayor que la longitud máxima permitida.An error will occur if the length of the return value string is greater than the maximum length allowed.

EjemploExample

-- The following example returns abcxyz.

Concat('abc', 'xyz')
Contains(string, target) Devuelve true si target está incluida en string.Returns true if target is contained in string.

ArgumentosArguments

string: Cadena en la que se busca.string: The string that is searched.

target: Cadena de destino que se busca.target: The target string that is searched for.

Valor devueltoReturn Value

Es true si target está incluida en string; de lo contrario, es false.true if target is contained in string; otherwise false.

EjemploExample

-- 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.Returns true if target ends with string.

ArgumentosArguments

string: Cadena en la que se busca.string: The string that is searched.

target: La cadena de destino que se busca al final de string.target: The target string searched for at the end of string.

Valor devueltoReturn Value

True si string termina por target; de lo contrario false.True if string ends with target; otherwise false.

EjemploExample

-- The following example returns true.

EndsWith('abc', 'bc') Nota: Si usa 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.EndsWith('abc', 'bc') Note: If you are using the SQL Server data provider, this function returns false if the string is stored in a fixed length string column and target is a constant. En este caso, se buscará en toda la cadena, incluyendo los espacios finales de relleno que pueda haber.In this case, the entire string is searched, including any padding trailing spaces. Una posible solución alternativa es recortar los datos de la cadena de longitud fija, como en el ejemplo siguiente: EndsWith(TRIM(string), target)A possible workaround is to trim the data in the fixed length string, as in the following example: EndsWith(TRIM(string), target)
IndexOf(target, string) Devuelve la posición de target dentro de string, o 0 si no se encuentra.Returns the position of target inside string, or 0 if not found. Devuelve 1 para indicar el principio de string.Returns 1 to indicate the beginning of string. La numeración del índice empieza a partir de 1.Index numbering starts from 1.

ArgumentosArguments

target: Cadena que se busca.target: The string that is searched for.

string: Cadena en la que se busca.string: The string that is searched.

Valor devueltoReturn Value

Una clase Int32.An Int32.

EjemploExample

-- The following example returns 4.

IndexOf('xyz', 'abcxyz')
Left(string, length) Devuelve los primeros length caracteres del lado izquierdo de string.Returns the first length characters from the left side of string. Si la longitud de string es menor que length, se devuelve la cadena entera.If the length of string is less than length, the entire string is returned.

ArgumentosArguments

string: OBJETO String.string: A String.

length: Int16, ,Int32 OByte. Int64length: An Int16, Int32, Int64, or Byte. El parámetro length no puede ser menor que cero.length cannot be less than zero.

Valor devueltoReturn Value

Objeto String.A String.

EjemploExample

-- The following example returns abc.

Left('abcxyz', 3)
Length(string) Devuelve la longitud (Int32) de la cadena en caracteres.Returns the (Int32) length, in characters, of the string.

ArgumentosArguments

string: OBJETO String.string: A String.

Valor devueltoReturn Value

Una clase Int32.An Int32.

EjemploExample

-- The following example returns 6.

Legth('abcxyz')
LTrim(string) Devuelve string sin el espacio en blanco inicial.Returns string without leading white space.

ArgumentosArguments

Objeto String.A String.

Valor devueltoReturn Value

Objeto String.A String.

EjemploExample

-- The following example returns abc.

LTrim(' abc')
Replace(string1, string2, string3) Devuelve string1, con todas las apariciones de string2 reemplazadas por string3.Returns string1, with all occurrences of string2 replaced by string3.

ArgumentosArguments

Objeto String.A String.

Valor devueltoReturn Value

Objeto String.A String.

EjemploExample

-- The following example returns abcxyz.

Concat('abc', 'xyz')
Reverse(string) Devuelve string con el orden de los caracteres invertidos.Returns string with the order of the characters reversed.

ArgumentosArguments

Objeto String.A String.

Valor devueltoReturn Value

Objeto String.A String.

EjemploExample

-- The following example returns dcba.

Reverse('abcd')
Right(string, length) Devuelve los últimos length caracteres stringde.Returns the last length characters from the string. Si la longitud de string es menor que length, se devuelve la cadena entera.If the length of string is less than length, the entire string is returned.

ArgumentosArguments

string: OBJETO String.string: A String.

length: Int16, ,Int32 OByte. Int64length: An Int16, Int32, Int64, or Byte. El parámetro length no puede ser menor que cero.length cannot be less than zero.

Valor devueltoReturn Value

Objeto String.A String.

EjemploExample

-- The following example returns xyz.

Right('abcxyz', 3)
RTrim(string) Devuelve string sin el espacio en blanco al final.Returns string without trailing white space.

ArgumentosArguments

Objeto String.A String.

Valor devueltoReturn Value

Objeto String.A String.
Substring(string, start, length) Devuelve la subcadena de la cadena a partir de la posición start, con una longitud de length caracteres.Returns the substring of the string starting at position start, with a length of length characters. Si se inicia a partir de 1, indica el primer carácter de la cadena.A start of 1 indicates the first character of the string. La numeración del índice empieza a partir de 1.Index numbering starts from 1.

ArgumentosArguments

string: OBJETO String.string: A String.

start: Int16 ,Int32Y .Byte Int64start: An Int16, Int32, Int64 and Byte. El parámetro start no puede ser menor que uno.start cannot be less than one.

length: Int16 ,Int32Y .Byte Int64length: An Int16, Int32, Int64 and Byte. El parámetro length no puede ser menor que cero.length cannot be less than zero.

Valor devueltoReturn Value

Objeto String.A String.

EjemploExample

-- The following example returns xyz.

Substring('abcxyz', 4, 3)
StartsWith(string, target) Devuelve true si el objeto string comienza por target.Returns true if string starts with target.

ArgumentosArguments

string: Cadena en la que se busca.string: The string that is searched.

target: La cadena de destino que se busca al principio de string.target: The target string searched for at the start of string.

Valor devueltoReturn Value

True si el objeto string comienza por target; de lo contrario, false.True if string starts with target; otherwise false.

EjemploExample

-- The following example returns true.

StartsWith('abc', 'ab')
ToLower(string) Devuelve una string con los caracteres en mayúscula pasados a minúscula.Returns string with uppercase characters converted to lowercase.

ArgumentosArguments

Objeto String.A String.

Valor devueltoReturn Value

Objeto String.A String.

EjemploExample

-- The following example returns abc.

ToLower('ABC')
ToUpper(string) Devuelve una string con los caracteres en minúscula pasados a mayúscula.Returns string with lowercase characters converted to uppercase.

ArgumentosArguments

Objeto String.A String.

Valor devueltoReturn Value

Objeto String.A String.

EjemploExample

-- The following example returns ABC.

ToUpper('abc')
Trim(string) Devuelve string sin espacios en blanco iniciales y finales.Returns string without leading and trailing white space.

ArgumentosArguments

Objeto String.A String.

Valor devueltoReturn Value

Objeto String.A String.

EjemploExample

-- The following example returns abc.

Trim(' abc ')

Estas funciones devolverán null si se proporciona la entrada null.These functions will return null if given null input.

La funcionalidad equivalente está disponible en el proveedor administrado de Microsoft SQL Client.Equivalent functionality is available in the Microsoft SQL Client Managed Provider. Para obtener más información, vea SqlClient para funciones de Entity Framework.For more information, see SqlClient for Entity Framework Functions.

Vea tambiénSee also