Funciones de cadena (Entity SQL)
El proveedor de datos .NET Framework para SQL Server (SqlClient) proporciona funciones de String que realizan operaciones en una String de entrada y devuelven una String o un resultado con un valor numérico. Estas funciones están en el espacio de nombres SqlServer, que está disponible al utilizar SqlClient. La propiedad del espacio de nombres de un proveedor permite a Entity Framework detectar qué prefijo usa este proveedor para estructuras concretas, como tipos y funciones.
En la tabla siguiente se muestran las funciones String de SqlClient.
| Función | Descripción |
|---|---|
ASCII( expression ) |
Devuelve el valor de código ASCII del carácter situado más a la izquierda de una expresión de cadena. Argumentos expression: cualquier expresión válida de un tipo String ASCII. Valor devuelto Valor de tipo Int32. Ejemplo
|
CHAR( expression ) |
Convierte un código Int32 en una cadena ASCII. Argumentos expression: valor de tipo Int32. Valor devuelto Valor de tipo String ASCII. Ejemplo
|
CHARINDEX( expression1, expression2 [, start_location]) |
Devuelve la posición inicial de la expresión especificada en una cadena de caracteres. Argumentos expression1: expresión que contiene la secuencia de caracteres que se va a buscar. La expresión puede ser de un tipo String (ASCII o Unicode) o Binary. expression2: expresión, que normalmente es una columna, en la que se encuentra la secuencia especificada. La expresión puede ser de un tipo String (ASCII o Unicode) o Binary. start_location: (opcional) valor de tipo Int64 (no se devuelve en SQL Server 2000) o Int32 que representa la posición de caracteres en la que debe comenzar la búsqueda de expression1 en expression2. Si no se especifica start_location, es un número negativo o es igual a cero, la búsqueda comienza al principio de expression2. Valor devuelto Valor de tipo Int32. Ejemplo
|
DIFFERENCE( expression, expression ) |
Compara los valores de SOUNDEX de dos cadenas y evalúa la similitud entre ambas. Argumentos Tipo String Unicode o ASCII. expression puede ser una constante, una variable o una columna. Valor devuelto Devuelve un valor de tipo Int32 que representa la diferencia entre los valores de SOUNDEX de dos expresiones de caracteres. El intervalo está comprendido entre 0 y 4. El valor 0 indica una similitud escasa o inexistente, y el valor 4 indica una elevada similitud o que los valores son iguales. Ejemplo
|
LEFT( expression, count ) |
Devuelve la parte izquierda de una cadena de caracteres con el número de caracteres especificado. Argumentos expression: tipo String Unicode o ASCII. Use la función CAST para convertir character_expression explícitamente. count: valor de tipo Int64 (no se devuelve en SQL Server 2000) o Int32 que especifica cuántos caracteres de character_expression se devolverán. Valor devuelto Valor String Unicode o ASCII. Ejemplo
|
LEN( expression ) |
Devuelve el número de caracteres de la expresión de cadena especificada, excluidos los espacios en blanco finales. Argumentos expression: expresión de un tipo String (ASCII o Unicode) o un tipo Binary. Valor devuelto Valor de tipo Int32. Ejemplo
|
LOWER( expression ) |
Devuelve una expresión de String después de convertir a minúsculas los datos de caracteres en mayúsculas. Argumentos expression: cualquier expresión válida del tipo String. Valor devuelto Valor de tipo String. Ejemplo
|
LTRIM( expression ) |
Devuelve una expresión String tras quitar los espacios iniciales en blanco. Argumentos expression: cualquier expresión válida del tipo String. Valor devuelto Un objeto String. Ejemplo
|
NCHAR( expression ) |
Devuelve el valor de tipo String Unicode correspondiente al código entero dado, tal como se define en el estándar Unicode. Argumentos expression: valor de tipo Int32. Valor devuelto Valor de tipo String Unicode. Ejemplo
|
PATINDEX( '%pattern%', expression) |
Devuelve la posición inicial de la primera aparición de un patrón en una expresión String especificada. Argumentos '%pattern%': valor de tipo String ASCII o Unicode. Se pueden utilizar caracteres comodín; no obstante, el carácter % debe ir delante y detrás del patrón (excepto cuando se busque el primer o último carácter). expression: cadena de tipo String ASCII o Unicode en la que buscar el patrón especificado. Valor devuelto Valor de tipo Int32. Ejemplo
|
QUOTENAME( 'char_string' [, 'quote_char']) |
Devuelve un valor de tipo String Unicode con los delimitadores agregados para convertirla en un identificador delimitado válido de SQL Server 2005. Argumentos char_string: valor de tipo String Unicode. quote_char: cadena de un solo carácter que se utiliza como delimitador. Puede ser una comilla simple ('), un corchete izquierdo o derecho ([ ]) o una comilla doble ("). Si no se especifica quote_char, se utilizarán corchetes. Valor devuelto Valor de tipo String Unicode. Ejemplo
|
REPLACE( expression1, expression2, expression3) |
Repite una expresión de carácter un número especificado de veces. Argumentos expression1: expresión de cadena que se va a buscar. expression1 puede ser de un tipo String Unicode o ASCII. expression2: subcadena que se va a buscar. expression2 puede ser de un tipo String Unicode o ASCII. expression3: cadena de reemplazo. expression3 puede ser de un tipo String Unicode o ASCII. Ejemplo
|
REPLICATE( char_expression, int_expression) |
Repite una expresión de carácter un número especificado de veces. Argumentos char_expression: tipo String Unicode o ASCII. int_expression: Int64 (no se admite en SQL Server 2000) o Int32. Valor devuelto Tipo String Unicode o ASCII. Ejemplo
|
REVERSE( expression ) |
Devuelve un valor de tipo String Unicode o ASCII con las posiciones de los caracteres invertidas con respecto a la cadena de entrada. Argumentos expression: tipo String Unicode o ASCII. Valor devuelto Tipo String Unicode o ASCII. Ejemplo
|
RIGHT( char_expression, count) |
Devuelve la parte derecha de una cadena de caracteres con el número de caracteres especificado. Argumentos char_expression: tipo String Unicode o ASCII. Use la función CAST para convertir character_expression explícitamente. count: valor de tipo Int64 (no se devuelve en SQL Server 2000) o Int32 que especifica cuántos caracteres de character_expression se devolverán. Valor devuelto Un tipo String ASCII. Ejemplo
|
RTRIM( expression ) |
Devuelve un valor de tipo String Unicode o ASCII después de quitar los espacios finales. Argumentos expression: tipo String Unicode o ASCII. Valor devuelto Tipo String Unicode o ASCII. Ejemplo
|
SOUNDEX( expression ) |
Devuelve un código de cuatro caracteres (SOUNDEX) para evaluar la similitud de dos cadenas.Argumentos expression: tipo String Unicode o ASCII. Valor devuelto Valor de tipo String ASCII. Un código de cuatro caracteres (SOUNDEX) es una cadena que evalúa la semejanza de dos cadenas. Ejemplo Valores devueltos |
SPACE( int_expression ) |
Devuelve un valor de tipo String ASCII de espacios repetidos. Argumentos int_expression: valor de tipo Int64 (no se devuelve en SQL Server 2000) o Int32 que indica el número de espacios. Valor devuelto Valor de tipo String ASCII. Ejemplo
|
STR( float_expression [, length [, decimal]]) |
Devuelve un valor String ASCII convertido a partir de datos numéricos. Argumentos float _expression: expresión de un tipo de datos (Double) numérico aproximado con un separador decimal. length: (opcional) valor de tipo Int32 que representa la longitud total. Incluye el separador decimal, el signo, los dígitos y los espacios. El valor predeterminado es 10. decimal: (opcional) valor de tipo Int32 que representa el número de lugares a la derecha del separador decimal. decimal debe ser menor o igual que 16. Si decimal es mayor que 16, el resultado se trunca a dieciséis lugares a la derecha del separador decimal. Valor devuelto Valor de tipo String ASCII. Ejemplo
|
STUFF( str_expression, start, length, str_expression_to_insert) |
Elimina una cantidad especificada de caracteres e inserta otro juego de caracteres a partir del punto inicial especificado de una expresión de cadena. Argumentos str_expression: tipo String Unicode o ASCII. start: valor Int64 (no se devuelve en SQL Server 2000) o Int32 que especifica la ubicación al principio de la eliminación e inserción. length: valor Int64 (no se devuelve en SQL Server 2000) o Int32 que especifica el número de caracteres que se van a eliminar. str_expression_to_insert: valor String Unicode o ASCII. Valor devuelto Valor String Unicode o ASCII. Ejemplo
|
SUBSTRING( str_expression, start, length) |
Devuelve parte de una expresión String. Argumentos str_expression: expresión de un tipo String (ASCII o Unicode) o un tipo Binary. start: valor de tipo Int64 (no se devuelve en SQL Server 2000) o Int32 que especifica dónde comienza la subcadena. 1 se refiere al primer carácter de la cadena. length: valor Int64 (no se devuelve en SQL Server 2000) o Int32 que especifica cuántos caracteres de la expresión se devolverán. Valor devuelto Valor de tipo String (ASCII o Unicode) o Binary. Ejemplo
|
UNICODE( expression ) |
Devuelve el valor entero, según la definición del estándar Unicode, para el primer carácter de la expresión de entrada. Argumentos expression: valor String Unicode. Valor devuelto Valor de tipo Int32. Ejemplo
|
UPPER( expression ) |
Devuelve una expresión String después de convertir a mayúsculas los datos de caracteres que están en minúsculas. Argumentos expression: expresión de un tipo String ASCII o Unicode. Valor devuelto Tipo String ASCII o Unicode. Ejemplo
|
Para obtener más información sobre las funciones String que SqlClient admite, consulte la documentación de la versión de SQL Server que especificó en el manifiesto del proveedor SqlClient:
| SQL Server 2000 | SQL Server 2005 | SQL Server 2008 |
|---|---|---|
Vea también
Conceptos
Proveedor de datos .NET Framework para SQL Server (SqlClient) para las funciones de Entity Framework
Problemas conocidos en el proveedor de datos .NET Framework para SQL Server (SqlClient) de Entity Framework