Dela via


Strängfunktioner

.NET Framework-dataprovidern för SQL Server (SqlClient) tillhandahåller String funktioner som utför åtgärder på indata String och returnerar ett String eller numeriskt värderesultat. Dessa funktioner finns i SqlServer-namnområdet, som är tillgängligt när du använder SqlClient. Med en providers namnområdesegenskap kan Entity Framework identifiera vilket prefix som används av den här providern för specifika konstruktioner, till exempel typer och funktioner.

I följande tabell visas funktionerna SqlClient String .

Function beskrivning
ASCII(expression) Returnerar ASCII-kodvärdet för det vänstra tecknet i ett stränguttryck.

Argument

expression: Ett giltigt uttryck för en ASCII-typ String .

Returvärde

En Int32.

Exempel

SqlServer.ASCII('A')
CHAR(expression) Konverterar en Int32 kod till en ASCII-sträng.

Argument

expression: En Int32.

Returvärde

En ASCII String.

Exempel

SqlServer.char(97)
CHARINDEX(expression1, expression2 [, start_location]) Returnerar startpositionen för det angivna uttrycket i en teckensträng.

Argument

expression1: Ett uttryck som innehåller sekvensen med tecken som ska hittas. Uttrycket kan vara av typen String (ASCII eller Unicode) eller av en binär typ.

expression2: Ett uttryck, vanligtvis en kolumn, som ska sökas efter den angivna sekvensen. Uttrycket kan vara av typen String (ASCII eller Unicode) eller av en binär typ.

start_location:(Optional) An Int64 (returneras inte i SQL Server 2000) eller Int32 som representerar teckenpositionen för att börja söka efter expression1 i expression2. Om start_location inte anges, är ett negativt tal eller är noll, startar sökningen i början av uttrycket2.

Returvärde

En Int32.

Exempel

SqlServer.CHARINDEX('h', 'habcdefgh', 2)
DIFFERENCE(expression, expression) Jämför värdena för SOUNDEX två strängar och utvärderar likheten mellan dem.

Argument

En ASCII- eller Unicode-typ String . expression kan vara en konstant, en variabel eller en kolumn.

Returvärde

Returnerar ett Int32 som representerar skillnaden mellan SOUNDEX-värdena för två teckenuttryck. Intervallet är från 0 till 4. 0 indikerar en svag likhet eller ingen likhet, och 4 indikerar en stark likhet eller samma värden.

Exempel

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

//the least possible difference or the best match.

SqlServer.DIFFERENCE('Green','Greene');
LEFT(expression, count) Returnerar den vänstra delen av en teckensträng med det angivna antalet tecken.

Argument

expression: En Unicode- eller ASCII-strängtyp. Använd funktionen CAST för att explicit konvertera character_expression.

count: En Int64 (returneras inte i SQL Server 2000) eller Int32 typ som anger hur många tecken i character_expression som ska returneras.

Returvärde

En Unicode eller ASCII String.

Exempel

SqlServer.LEFT('SQL Server', 4)
LEN(expression) Returnerar antalet tecken i det angivna stränguttrycket, exklusive avslutande blanksteg.

Argument

expression: Ett uttryck av en String (Unicode- eller ASCII-typ) eller en Binary typ

Returvärde

En Int32.

Exempel

SqlServer.LEN('abcd')
LOWER(expression) Returnerar ett String uttryck efter konvertering av versaler till gemener.

Argument

expression: Ett giltigt uttryck av typen String .

Returvärde

En String.

Exempel

SqlServer.LOWER('AbB')
LTRIM(expression) Returnerar ett String uttryck när inledande blanksteg har tagits bort.

Argument

expression: Ett giltigt uttryck av String typen.

Returvärde

En String.

Exempel

SqlServer.LTRIM(' d')
NCHAR(expression) Returnerar en Unicode String med den angivna heltalskoden enligt unicode-standarden.

Argument

expression: En Int32.

Returvärde

En Unicode String.

Exempel

SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression) Returnerar startpositionen för den första förekomsten av ett mönster i ett angivet String uttryck.

Argument

'%pattern%': En ASCII- eller Unicode-typ String . Jokertecken kan användas. %-tecknet måste dock komma före och efter mönstret (förutom i sökningar efter första eller sista tecken).

expression: En ASCII eller Unicode String för att söka efter det angivna mönstret.

Returvärde

En Int32.

Exempel

SqlServer.PATINDEX('abc', 'ab')
QUOTENAME('char_string' [, 'quote_char']) Returnerar en Unicode String med avgränsarna tillagda för att göra indatasträngen till en giltig SQL Server 2005 avgränsad identifierare.

Argument

char_string: En Unicode String.

quote_char: En sträng med ett tecken som ska användas som avgränsare. Kan vara ett enkelt citattecken ( ' ), en vänster eller höger hakparentes ( [ ] ) eller ett dubbelt citattecken ( " ). Om quote_char inte anges används hakparenteser.

Returvärde

En Unicode String.

Exempel

SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3) Ersätter ett teckenuttryck med ett annat teckenuttryck.

Argument

expression1: Stränguttrycket som ska sökas igenom. expression1 kan vara en Unicode- eller ASCII-strängtyp.

expression2:Delsträngen som ska hittas. expression2 kan vara en Unicode- eller ASCII-strängtyp.

expression3; Ersättningssträngen. expression3 kan vara en Unicode- eller ASCII-strängtyp.

Exempel

SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression) Upprepar ett teckenuttryck för ett angivet antal gånger.

Argument

char_expression: En Unicode- eller ASCII-typ String .

int_expression: Int64 (stöds inte i SQL Server 2000) eller Int32.

Returvärde

En Unicode- eller ASCII-typ String .

Exempel

SqlServer.REPLICATE('aa',2)
REVERSE(expression) Returnerar en Unicode- eller ASCII-sträng med dess teckenpositioner omvända från indatasträngen.

Argument

expression: En Unicode- eller ASCII-typ String .

Returvärde

En Unicode- eller ASCII-typ String .

Exempel

SqlServer.REVERSE('abcd')
RIGHT(char_expression, count) Returnerar den högra delen av en teckensträng med det angivna antalet tecken.

Argument

char_expression:En Unicode- eller ASCII-strängtyp. Använd funktionen CAST för att explicit konvertera character_expression.

count: En Int64 (returneras inte i SQL Server 2000) eller Int32 typ som anger hur många tecken i character_expression som ska returneras.

Returvärde

En ASCII-typ String .

Exempel

SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression) Returnerar en Unicode- eller ASCII-sträng när avslutande blanksteg har tagits bort.

Argument

expression: En Unicode- eller ASCII-typ String .

Returvärde

En Unicode- eller ASCII-typ String .

Exempel

SqlServer.RTRIM(' d e ')
SOUNDEX(expression) Returnerar en SOUNDEX-kod (fyra tecken) för att utvärdera likheten mellan två strängar.Argument

expression: En Unicode- eller ASCII-strängtyp.

Returvärde

En ASCII String. En SOUNDEX-kod (fyra tecken) är en sträng som utvärderar likheten mellan två strängar.

Exempel

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

Returer

----- ----- S530 S530
SPACE(int_expression) Returnerar ett ASCII String med upprepade blanksteg.

Argument

int_expression: En Int64 (returneras inte i SQL Server 2000) eller Int32 som anger antalet blanksteg.

Returvärde

En ASCII String.

Exempel

SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]]) Returnerar en ASCII String som konverterats från numeriska data.

Argument

float _expression: Ett uttryck för ungefärlig numerisk datatyp (Double) med en decimalpunkt.

length: (valfritt) En Int32 som representerar den totala längden. Detta inkluderar decimaltecken, tecken, siffror och blanksteg. Standardvärdet är 10.

decimal:(alternativ) Ett Int32 som representerar antalet platser till höger om decimaltecknet. decimaltecknet måste vara mindre än eller lika med 16. Om decimaltecknet är mer än 16 trunkeras resultatet till sexton platser till höger om decimaltecknet.

Returvärde

En ASCII String.

Exempel

SqlServer.STR(212.0)
STUFF(str_expression, start, length, str_expression_to_insert) Tar bort en angiven längd på tecken och infogar en annan uppsättning tecken vid en angiven startpunkt i ett stränguttryck.

Argument

str_expression: En Unicode eller ASCII String.

start: Ett Int64 (returneras inte i SQL Server 2000) eller Int32 värde som anger platsen för att starta borttagningen och infogningen.

length: Ett Int64 (returneras inte i SQL Server 2000) eller Int32 värde som anger antalet tecken som ska tas bort.

str_expression_to_insert: En Unicode eller ASCII String.

Returvärde

En Unicode eller ASCII String.

Exempel

SqlServer.STUFF('abcd', 2, 2, 'zz')
SUBSTRING(str_expression, start, length) Returnerar en del av ett String uttryck.

Argument

str_expression: Ett uttryck av en String (ASCII- eller Unicode-typ) eller en Binary typ.

start: En Int64 (returneras inte i SQL Server 2000) eller Int32 som anger var delsträngen startar. 1 refererar till det första tecknet i strängen.

length: En Int64 (returneras inte i SQL Server 2000) eller Int32 som anger hur många tecken i uttrycket som ska returneras.

Returvärde

En String (ASCII- eller Unicode-typ) eller en Binary typ.

Exempel

SqlServer.SUBSTRING('abcd', 2, 2)
UNICODE(expression) Returnerar heltalsvärdet, som definierats av Unicode-standarden, för det första tecknet i indatauttrycket.

Argument

expression: En Unicode String.

Returvärde

En Int32.

Exempel

SqlServer.UNICODE('a')
UPPER(expression) Returnerar ett String uttryck efter konvertering av gemener till versaler.

Argument

expression: Ett uttryck för en ASCII eller en Unicode-strängtyp.

Returvärde

En ASCII- eller Unicode-typ String .

Exempel

SqlServer.UPPER('AbB')

Mer information om de String funktioner som SqlClient stöder finns i String Functions (Transact-SQL).

Se även