Řetězcové kanonické funkce

Entity SQL obsahuje kanonické funkce řetězců.

Poznámky

Následující tabulka ukazuje řetězcové kanonické funkce Entity SQL.

Funkce Popis
Concat(string1, string2) Vrátí řetězec, který obsahuje string2 připojené k string1.

Argumenty

string1: Řetězec, ke kterému string2 je připojen.

string2: Řetězec, který je připojen k string1.

Návratová hodnota

Úloha String. Pokud je délka návratového řetězce hodnoty větší než maximální povolená délka, dojde k chybě.

Příklad

-- The following example returns abcxyz.

Concat('abc', 'xyz')
Contains(string, target) Vrátí true hodnotu, pokud target je obsažena v string.

Argumenty

string: Hledaný řetězec.

target: Cílový řetězec, který je vyhledáván.

Návratová hodnota

true je-li target obsažena v string; jinak false.

Příklad

-- The following example returns true.

Contains('abc', 'bc')
EndsWith(string, target) Vrátí true , pokud target končí na string.

Argumenty

string: Hledaný řetězec.

target: Cílový řetězec hledaný na konci string.

Návratová hodnota

True pokud string končí na target; jinak false.

Příklad

-- The following example returns true.

EndsWith('abc', 'bc') Poznámka: Pokud používáte zprostředkovatele dat SQL Serveru, vrátí tato funkcefalse, pokud je řetězec uložen ve sloupci řetězce s pevnou délkou a target je konstanta. V tomto případě se prohledá celý řetězec, včetně jakéhokoli vyplňujícího prostoru na konci. Možným alternativním řešením je oříznutí dat v řetězci s pevnou délkou, jak je znázorněno v následujícím příkladu: EndsWith(TRIM(string), target)
IndexOf(target, string) Vrátí pozici target uvnitř stringnebo 0, pokud nebyla nalezena. Vrátí hodnotu 1 označující začátek string. Číslování indexů začíná od 1.

Argumenty

target: Hledaný řetězec.

string: Hledaný řetězec.

Návratová hodnota

A Int32.

Příklad

-- The following example returns 4.

IndexOf('xyz', 'abcxyz')
Left(string, length) Vrátí první length znaky z levé strany string. Pokud je délka string menší než length, vrátí se celý řetězec.

Argumenty

string: A String.

length: An Int16, Int32, Int64nebo Byte. length nemůže být menší než nula.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns abc.

Left('abcxyz', 3)
Length(string) Vrátí délku řetězce (Int32) ve znacích.

Argumenty

string: A String.

Návratová hodnota

A Int32.

Příklad

-- The following example returns 6.

Length('abcxyz')
LTrim(string) Vrátí string bez počáteční mezery.

Argumenty

Úloha String.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns abc.

LTrim(' abc')
Replace(string1, string2, string3) Vrátí string1, ve kterém jsou všechny výskyty string2 nahrazeny string3.

Argumenty

Úloha String.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns abcxyz.

Concat('abc', 'xyz')
Reverse(string) Vrátí string s obráceným pořadím znaků.

Argumenty

Úloha String.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns dcba.

Reverse('abcd')
Right(string, length) Vrátí poslední length znaky z string. Pokud je délka string menší než length, vrátí se celý řetězec.

Argumenty

string: A String.

length: An Int16, Int32, Int64nebo Byte. length nemůže být menší než nula.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns xyz.

Right('abcxyz', 3)
RTrim(string) Vrátí se string bez koncových prázdných znaků.

Argumenty

Úloha String.

Návratová hodnota

Úloha String.
Substring(string, start, length) Vrátí podřetězce řetězce začínajícího na pozici starts délkou length znaků. Začátek 1 označuje první znak řetězce. Číslování indexů začíná od 1.

Argumenty

string: A String.

start: A Int16, Int32, Int64 a Byte. start nemůže být menší než jedna.

length: Int16, Int32, Int64 a Byte. length nemůže být menší než nula.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns xyz.

Substring('abcxyz', 4, 3)
StartsWith(string, target) Vrátí true , pokud string začíná na target.

Argumenty

string: Hledaný řetězec.

target: Cílový řetězec, který se hledá na začátku string.

Návratová hodnota

True pokud string začíná na target; v opačném případě false.

Příklad

-- The following example returns true.

StartsWith('abc', 'ab')
ToLower(string) Vrátí string s velkými písmeny převedenými na malá písmena.

Argumenty

Úloha String.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns abc.

ToLower('ABC')
ToUpper(string) Vrátí string s malými písmeny převedenými na velká písmena.

Argumenty

Úloha String.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns ABC.

ToUpper('abc')
Trim(string) Vrátí string bez úvodních a koncových mezer.

Argumenty

Úloha String.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns abc.

Trim(' abc ')

Tyto funkce vrátí null, pokud je zadán null jako vstup.

Ekvivalentní funkcionalita je k dispozici v řízeném poskytovateli klienta Microsoft SQL. Další informace naleznete v tématu SqlClient for Entity Framework Functions.

Viz také