Řetězcové kanonické funkce

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

Poznámky

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

Function Popis
Concat(string1, string2) Vrátí řetězec, který obsahuje string2 připojenou hodnotu 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á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 funkce false , 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ě všech odsazení koncových mezer. 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) v znakůch.

Argumenty

string: A String.

Návratová hodnota

A Int32.

Příklad

-- The following example returns 6.

Length('abcxyz')
LTrim(string) Vrátí bez string počáteční prázdné 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, se všemi výskyty string2 nahrazeno string3.

Argumenty

Úloha String.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns abcxyz.

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

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 znaku 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, Int32Int64 a Byte. start nemůže být menší než jedna.

length: A Int16, Int32Int64 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 hledaný 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í bez string úvodního a koncového prázdného místa.

Argumenty

Úloha String.

Návratová hodnota

Úloha String.

Příklad

-- The following example returns abc.

Trim(' abc ')

Tyto funkce se vrátí null , pokud je zadaný null vstup.

Ekvivalentní funkce jsou k dispozici ve zprostředkovateli spravovaném klientem Microsoft SQL. Další informace naleznete v tématu SqlClient for Entity Framework Functions.

Viz také