Sztringfüggvények

Az SQL Serverhez készült .NET-keretrendszer adatszolgáltatója (SqlClient) olyan függvényeket biztosít String , amelyek műveleteket hajtanak végre egy bemeneten String , és visszaadnak egy String vagy numerikus értéket. Ezek a függvények az SqlServer névterében találhatók, amely az SqlClient használatakor érhető el. A szolgáltató névtértulajdonságával az Entity Framework felderítheti, hogy a szolgáltató melyik előtagot használja adott szerkezetekhez, például típusokhoz és függvényekhez.

Az alábbi táblázat az SqlClient String függvényeket mutatja be.

Funkció Leírás
ASCII(expression) Egy sztringkifejezés bal szélső karakterének ASCII-kódértékét adja vissza.

Argumentumok

expression: BÁRMELY ASCII-típus String érvényes kifejezése.

Visszatérési érték

Egy Int32.

Példa

SqlServer.ASCII('A')
CHAR(expression) Int32 Egy kódot ASCII-sztringgé alakít át.

Argumentumok

expression: An Int32.

Visszatérési érték

Egy ASCII String.

Példa

SqlServer.char(97)
CHARINDEX(expression1, expression2 [, start_location]) A megadott kifejezés kezdőpozícióját adja vissza egy karaktersztringben.

Argumentumok

expression1: A megtalálandó karakterek sorozatát tartalmazó kifejezés. A kifejezés lehet sztring típusú (ASCII vagy Unicode) vagy bináris típusú.

expression2: A megadott sorrendben keresendő kifejezés, általában egy oszlop. A kifejezés lehet sztring típusú (ASCII vagy Unicode) vagy bináris típusú.

start_location:(Optional) Int64 (az SQL Server 2000-ben nem adja vissza) vagy Int32, amely azt a karakterpozíciót jelöli, amellyel megkezdheti a kifejezés1 keresését a kifejezés2-ben. Ha start_location nincs megadva, negatív szám vagy nulla, a keresés a kifejezés2 elején kezdődik.

Visszatérési érték

Egy Int32.

Példa

SqlServer.CHARINDEX('h', 'habcdefgh', 2)
DIFFERENCE(expression, expression) SOUNDEX Két sztring értékeit hasonlítja össze, és kiértékeli a köztük lévő hasonlóságot.

Argumentumok

ASCII- vagy Unicode-típus String . expression lehet állandó, változó vagy oszlop.

Visszatérési érték

Olyan értéket Int32 ad vissza, amely két karakterkifejezés SOUNDEX értékei közötti különbséget jelöli. A tartomány 0 és 4 között van. A 0 gyenge hasonlóságot jelez, vagy nincs hasonlóság, a 4 pedig erős hasonlóságot vagy azonos értékeket jelez.

Példa

// The following example returns a DIFFERENCE value of 4,

//the least possible difference or the best match.

SqlServer.DIFFERENCE('Green','Greene');
LEFT(expression, count) Egy karaktersztring bal oldali részét adja vissza a megadott számú karakterrel.

Argumentumok

expression: Unicode- vagy ASCII-sztringtípus. A CAST függvénnyel explicit módon konvertálhatja a character_expression.

count: Egy Int64 (az SQL Server 2000-ben nem visszaadott) vagy Int32 típus, amely meghatározza, hogy hány karaktert ad vissza a character_expression.

Visszatérési érték

Unicode vagy ASCII String.

Példa

SqlServer.LEFT('SQL Server', 4)
LEN(expression) A megadott sztringkifejezésben szereplő karakterek számát adja vissza, a záró üres karakterek kivételével.

Argumentumok

expression: Unicode vagy ASCII típusú kifejezés String vagy Binary típus

Visszatérési érték

Egy Int32.

Példa

SqlServer.LEN('abcd')
LOWER(expression) A nagybetűs karakteradatok kisbetűssé alakítása után visszaad egy String kifejezést.

Argumentumok

expression: A típus bármely érvényes kifejezése String .

Visszatérési érték

Egy String.

Példa

SqlServer.LOWER('AbB')
LTRIM(expression) A kezdő szóközök eltávolítása után visszaad egy String kifejezést.

Argumentumok

expression: Bármely érvényes típuskifejezés String .

Visszatérési érték

Egy String.

Példa

SqlServer.LTRIM(' d')
NCHAR(expression) A Unicode szabvány által meghatározott Unicode karaktert ad vissza a megadott egész szám kóddal.

Argumentumok

expression: An Int32.

Visszatérési érték

Unicode String.

Példa

SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression) Egy minta első előfordulásának kezdőpozícióját adja vissza egy adott String kifejezésben.

Argumentumok

'%pattern%': ASCII- vagy Unicode-típus String . Helyettesítő karaktereket lehet használni; azonban a % karakternek a mintázat előtt és után kell szerepelnie (kivéve, ha az első vagy utolsó karaktert keresik).

expression: ASCII vagy Unicode String a megadott minta kereséséhez.

Visszatérési érték

Egy Int32.

Példa

SqlServer.PATINDEX('abc', 'ab')
QUOTENAME('char_string' [, 'quote_char']) Egy Unicode-értéket String ad vissza, mely a bemeneti sztringhez elválasztójeleket hozzáadva érvényes SQL Server 2005 tagolt azonosítóvá teszi azt.

Argumentumok

char_string: Unicode String.

quote_char: Elválasztóként használandó egykarakteres karakterlánc. Lehet egy idézőjel ( ' ), bal vagy jobb oldali szögletes zárójel ( [ ] ), vagy dupla idézőjel ( " ). Ha quote_char nincs megadva, a rendszer szögletes zárójeleket használ.

Visszatérési érték

Unicode String.

Példa

SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3) Egy karakterkifejezést lecserél egy másik karakterkifejezésre.

Argumentumok

expression1: A keresendő sztringkifejezés. expression1 Unicode- vagy ASCII-sztringtípus lehet.

expression2:A megtalálandó részszöveg. expression2 Unicode- vagy ASCII-sztringtípus lehet.

expression3; A helyettesítő karakterlánc. expression3 Unicode- vagy ASCII-sztringtípus lehet.

Példa

SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression) Adott számú karakterkifejezés ismétlése.

Argumentumok

char_expression: Unicode vagy ASCII String típusú.

int_expression: Int64 (az SQL Server 2000-ben nem támogatott) vagy Int32.

Visszatérési érték

Unicode vagy ASCII String típusú.

Példa

SqlServer.REPLICATE('aa',2)
REVERSE(expression) Unicode- vagy ASCII-karakterláncot ad vissza, amelyben a bemeneti karakterlánc karakterpozíciói meg vannak fordítva.

Argumentumok

expression: Unicode vagy ASCII String típusú.

Visszatérési érték

Unicode vagy ASCII String típusú.

Példa

SqlServer.REVERSE('abcd')
RIGHT(char_expression, count) A megadott számú karaktert tartalmazó karaktersztring megfelelő részét adja vissza.

Argumentumok

char_expression:Unicode- vagy ASCII-sztringtípus. A CAST függvénnyel explicit módon konvertálhatja a character_expression.

count: Egy Int64 (az SQL Server 2000-ben nem visszaadott) vagy Int32 típus, amely meghatározza, hogy hány karaktert ad vissza a character_expression.

Visszatérési érték

ASCII-típus String .

Példa

SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression) Unicode- vagy ASCII-sztringet ad vissza a záró szóközök eltávolítása után.

Argumentumok

expression: Unicode vagy ASCII String típusú.

Visszatérési érték

Unicode vagy ASCII String típusú.

Példa

SqlServer.RTRIM(' d e ')
SOUNDEX(expression) Egy négy karakterből álló (SOUNDEX) kódot ad vissza két sztring hasonlóságának kiértékeléséhez. Érvek

expression: Unicode- vagy ASCII-sztringtípus.

Visszatérési érték

Egy ASCII String. A négy karakterből álló (SOUNDEX) kód egy sztring, amely két sztring hasonlóságát értékeli ki.

Példa

Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1}

Visszatérések

----- ----- S530 S530
SPACE(int_expression) A szóközök ismétlésének ASCII kódját String adja vissza.

Argumentumok

int_expression: Egy Int64 (az SQL Server 2000-ben nem visszaadott) vagy Int32 a szóközök számát jelző érték.

Visszatérési érték

Egy ASCII String.

Példa

SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]]) Numerikus adatokból konvertált ASCII-t String ad vissza.

Argumentumok

float _expression: Közelítő numerikus (Double) adattípus kifejezése tizedesvesszővel.

length: (nem kötelező) A Int32 teljes hosszt jelképező érték. Ez magában foglalja a tizedesvesszőt, a jelet, a számjegyeket és a szóközöket. Az alapértelmezett érték 10.

decimal:(optional) A Int32 tizedesvessző jobb oldalán lévő helyek számát jelöli. a decimális értéknek 16-nál kisebbnek vagy egyenlőnek kell lennie. Ha a decimális érték meghaladja a 16-ot, az eredményt a tizedesvessző jobb oldalán lévő tizenhat helyre csonkolja a függvény.

Visszatérési érték

Egy ASCII String.

Példa

SqlServer.STR(212.0)
STUFF(str_expression, start, length, str_expression_to_insert) Törli a megadott karakterhosszt, és egy karakterlánc-kifejezés egy megadott kezdőpontjára szúr be egy másik karakterkészletet.

Argumentumok

str_expression: Unicode vagy ASCII String.

start: Egy Int64 (az SQL Server 2000-ben nem visszaadott) érték vagy Int32 érték, amely megadja a törlés és a beszúrás indításának helyét.

length: Egy Int64 (az SQL Server 2000-ben nem visszaadott) vagy Int32 olyan érték, amely megadja a törölni kívánt karakterek számát.

str_expression_to_insert: Unicode vagy ASCII String.

Visszatérési érték

Unicode vagy ASCII String.

Példa

SqlServer.STUFF('abcd', 2, 2, 'zz')
SUBSTRING(str_expression, start, length) Egy kifejezés egy részét String adja vissza.

Argumentumok

str_expression: Egy String típusú kifejezés (ASCII vagy Unicode) vagy egy Binary típusú kifejezés.

start: Egy Int64 (az SQL Server 2000-ben nem visszaadott) vagy Int32 azt határozza meg, hogy hol kezdődik az alsztring. Az 1 a sztring első karakterére hivatkozik.

length: Egy Int64 vagy Int32 adja meg, hogy a kifejezésből hány karaktert ad vissza (az SQL Server 2000-ben nem visszaadott).

Visszatérési érték

ASCII- vagy Unicode-típus vagy String típus vagy Binary típus.

Példa

SqlServer.SUBSTRING('abcd', 2, 2)
UNICODE(expression) A Unicode szabvány által meghatározott egész számértéket adja vissza a bemeneti kifejezés első karakteréhez.

Argumentumok

expression: Unicode String.

Visszatérési érték

Egy Int32.

Példa

SqlServer.UNICODE('a')
UPPER(expression) A kisbetűs karakteradatok nagybetűssé alakítása után visszaad egy String kifejezést.

Argumentumok

expression: ASCII- vagy Unicode-sztring típusú kifejezés.

Visszatérési érték

ASCII- vagy Unicode-típus String .

Példa

SqlServer.UPPER('AbB')

Az SqlClient által támogatott függvényekről String további információt a String Functions (Transact-SQL) című témakörben talál.

Lásd még