Tekenreeksfuncties

De .NET Framework-gegevensprovider voor SQL Server (SqlClient) biedt String functies die bewerkingen uitvoeren op een invoer String en een resultaat van een String of numerieke waarde retourneren. Deze functies bevinden zich in de SqlServer-naamruimte, die beschikbaar is wanneer u SqlClient gebruikt. Met de eigenschap naamruimte van een provider kan het Entity Framework detecteren welk voorvoegsel door deze provider wordt gebruikt voor specifieke constructies, zoals typen en functies.

In de volgende tabel ziet u de SqlClient-functies String .

Functie	Beschrijving
ASCII(expression)	Retourneert de ASCII-codewaarde van het meest linkse teken van een tekenreeksexpressie. Argumenten expression: Elke geldige expressie van een ASCII-type String . Retourwaarde Een Int32. Voorbeeld SqlServer.ASCII('A')
CHAR(expression)	Converteert een Int32 code naar een ASCII-tekenreeks. Argumenten expression: Een Int32. Retourwaarde Een ASCII String. Voorbeeld SqlServer.char(97)
CHARINDEX(expression1, expression2 [, start_location])	Retourneert de beginpositie van de opgegeven expressie in een tekenreeks. Argumenten expression1: Een expressie die de reeks tekens bevat die moeten worden gevonden. De expressie kan van een tekenreekstype (ASCII of Unicode) of van een binair type zijn. expression2: Een expressie, meestal een kolom, die moet worden doorzocht op de opgegeven reeks. De expressie kan van een tekenreekstype (ASCII of Unicode) of van een binair type zijn. start_location:(Optional) Een int64 (niet geretourneerd in SQL Server 2000) of Int32 die de tekenpositie vertegenwoordigt om te zoeken naar expressie1 in expressie2. Als start_location niet is opgegeven, een negatief getal is of nul is, begint de zoekopdracht aan het begin van expressie2. Retourwaarde Een Int32. Voorbeeld SqlServer.CHARINDEX('h', 'habcdefgh', 2)
DIFFERENCE(expression, expression)	Vergelijkt de SOUNDEX waarden van twee tekenreeksen en evalueert de overeenkomst tussen deze tekenreeksen. Argumenten Een ASCII- of Unicode-type String . expression kan een constante, een variabele of een kolom zijn. Retourwaarde Retourneert een Int32 waarde die het verschil aangeeft tussen de SOUNDEX-waarden van twee tekenexpressies. Het bereik is van 0 tot en met 4. 0 geeft een zwakke gelijkenis aan of geen gelijkenis, en 4 geeft een sterke gelijkenis of dezelfde waarden aan. Voorbeeld // The following example returns a DIFFERENCE value of 4, //the least possible difference or the best match. SqlServer.DIFFERENCE('Green','Greene');
LEFT(expression, count)	Retourneert het linkerdeel van een tekenreeks met het opgegeven aantal tekens. Argumenten expression: een Unicode- of ASCII-tekenreekstype. Gebruik de functie CAST om expliciet character_expression te converteren. count: Een Int64 (niet geretourneerd in SQL Server 2000) of Int32 type dat aangeeft hoeveel tekens van character_expression worden geretourneerd. Retourwaarde Een Unicode of ASCII String. Voorbeeld SqlServer.LEFT('SQL Server', 4)
LEN(expression)	Retourneert het aantal tekens in de opgegeven tekenreeksexpressie, met uitzondering van lege tekens. Argumenten expression: Een expressie van een String type (Unicode of ASCII) of een Binary type Retourwaarde Een Int32. Voorbeeld SqlServer.LEN('abcd')
LOWER(expression)	Retourneert een String expressie na het converteren van hoofdlettergegevens naar kleine letters. Argumenten expression: Een geldige expressie van het String type. Retourwaarde A String. Voorbeeld SqlServer.LOWER('AbB')
LTRIM(expression)	Retourneert een String expressie na het verwijderen van voorloopspaties. Argumenten expression: Elke geldige expressie van het String type. Retourwaarde A String. Voorbeeld SqlServer.LTRIM(' d')
NCHAR(expression)	Retourneert een Unicode String met de opgegeven geheel getalcode, zoals gedefinieerd door de Unicode-standaard. Argumenten expression: Een Int32. Retourwaarde Een Unicode String. Voorbeeld SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression)	Retourneert de beginpositie van het eerste exemplaar van een patroon in een opgegeven String expressie. Argumenten '%pattern%': een ASCII- of Unicode-type String . Jokertekens kunnen worden gebruikt; het teken % moet echter vóór en na het patroon komen (behalve bij zoekopdrachten naar eerste of laatste tekens). expression: Een ASCII of Unicode String om naar het opgegeven patroon te zoeken. Retourwaarde Een Int32. Voorbeeld SqlServer.PATINDEX('abc', 'ab')
QUOTENAME('char_string' [, 'quote_char'])	Retourneert een Unicode String met de scheidingstekens die zijn toegevoegd om de invoertekenreeks een geldige sql Server 2005-id met scheidingstekens te maken. Argumenten char_string: Een Unicode String. quote_char: Een tekenreeks met één teken die moet worden gebruikt als scheidingsteken. Kan één aanhalingsteken ( ' ), een haakje links of rechts ([ ] ) of een dubbel aanhalingsteken (" ) zijn. Als quote_char dit niet is opgegeven, worden vierkante haken gebruikt. Retourwaarde Een Unicode String. Voorbeeld SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3)	Hiermee vervangt u een tekenexpressie door een andere tekenexpressie. Argumenten expression1: De tekenreeksexpressie die moet worden doorzocht. expression1 kan een Unicode- of ASCII-tekenreekstype zijn. expression2:De subtekenreeks die moet worden gevonden. expression2 kan een Unicode- of ASCII-tekenreekstype zijn. expression3; De vervangende tekenreeks. expression3 kan een Unicode- of ASCII-tekenreekstype zijn. Voorbeeld SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression)	Herhaalt een tekenexpressie gedurende een opgegeven aantal keren. Argumenten char_expression: een Unicode- of ASCII-type String . int_expression: Int64 (niet ondersteund in SQL Server 2000) of Int32. Retourwaarde Een Unicode- of ASCII-type String . Voorbeeld SqlServer.REPLICATE('aa',2)
REVERSE(expression)	Retourneert een Unicode- of ASCII-tekenreeks met de tekenposities die zijn omgekeerd van de invoertekenreeks. Argumenten expression: een Unicode- of ASCII-type String . Retourwaarde Een Unicode- of ASCII-type String . Voorbeeld SqlServer.REVERSE('abcd')
RIGHT(char_expression, count)	Retourneert het rechterdeel van een tekenreeks met het opgegeven aantal tekens. Argumenten char_expression:A Unicode- of ASCII-tekenreekstype. Gebruik de functie CAST om expliciet character_expression te converteren. count: Een Int64 (niet geretourneerd in SQL Server 2000) of Int32 type dat aangeeft hoeveel tekens van character_expression worden geretourneerd. Retourwaarde Een ASCII-type String . Voorbeeld SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression)	Retourneert een Unicode- of ASCII-tekenreeks na het verwijderen van volgspaties. Argumenten expression: een Unicode- of ASCII-type String . Retourwaarde Een Unicode- of ASCII-type String . Voorbeeld SqlServer.RTRIM(' d e ')
SOUNDEX(expression)	Retourneert een SOUNDEX-code (vier tekens) om de gelijkenis van twee tekenreeksen te evalueren.Argumenten expression: een Unicode- of ASCII-tekenreekstype. Retourwaarde Een ASCII String. Een SOUNDEX-code (vier tekens) is een tekenreeks die de gelijkenis van twee tekenreeksen evalueert. Voorbeeld Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1} Retouren ----- ----- S530 S530
SPACE(int_expression)	Retourneert een ASCII String van herhaalde spaties. Argumenten int_expression: Een Int64 (niet geretourneerd in SQL Server 2000) of Int32 die het aantal spaties aangeeft. Retourwaarde Een ASCII String. Voorbeeld SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]])	Hiermee wordt een ASCII String geretourneerd die is geconverteerd van numerieke gegevens. Argumenten float _expression: Een expressie van het gegevenstype bij benadering van numeriek (Double) met een decimaalteken. length: (optioneel) Een Int32 die de totale lengte aangeeft. Dit omvat decimale punten, tekens, cijfers en spaties. De standaardwaarde is 10. decimal:(optional) Een Int32 getal dat het aantal posities rechts van het decimaalteken aangeeft. decimaal moet kleiner zijn dan of gelijk zijn aan 16. Als decimaal meer dan 16 is, wordt het resultaat afgekapt tot zestien plaatsen rechts van het decimaalteken. Retourwaarde Een ASCII String. Voorbeeld SqlServer.STR(212.0)
STUFF(str_expression, start, length, str_expression_to_insert)	Hiermee verwijdert u een opgegeven lengte van tekens en voegt u een andere set tekens in op een opgegeven beginpunt in een tekenreeksexpressie. Argumenten str_expression: Een Unicode of ASCII String. start: Een Int64 (niet geretourneerd in SQL Server 2000) of Int32 waarde die de locatie aangeeft waarop de verwijdering en invoeging moeten worden gestart. length: Een Int64 (niet geretourneerd in SQL Server 2000) of Int32 een waarde die het aantal tekens aangeeft dat moet worden verwijderd. str_expression_to_insert: Een Unicode of ASCII String. Retourwaarde Een Unicode of ASCII String. Voorbeeld SqlServer.STUFF('abcd', 2, 2, 'zz')
SUBSTRING(str_expression, start, length)	Retourneert een deel van een String expressie. Argumenten str_expression: Een expressie van een String type (ASCII of Unicode) of een Binary type. start: Een Int64 (niet geretourneerd in SQL Server 2000) of Int32 die aangeeft waar de subtekenreeks wordt gestart. 1 verwijst naar het eerste teken in de tekenreeks. length: Een Int64 (niet geretourneerd in SQL Server 2000) of Int32 die aangeeft hoeveel tekens van de expressie worden geretourneerd. Retourwaarde Een String type (ASCII of Unicode) of een Binary type. Voorbeeld SqlServer.SUBSTRING('abcd', 2, 2)
UNICODE(expression)	Retourneert de gehele waarde, zoals gedefinieerd door de Unicode-standaard, voor het eerste teken van de invoerexpressie. Argumenten expression: Een Unicode String. Retourwaarde Een Int32. Voorbeeld SqlServer.UNICODE('a')
UPPER(expression)	Retourneert een String expressie na het converteren van gegevens uit kleine letters naar hoofdletters. Argumenten expression: Een expressie van een ASCII of een Unicode-tekenreekstype. Retourwaarde Een ASCII of een Unicode-type String . Voorbeeld SqlServer.UPPER('AbB')

Zie String Functions (Transact-SQL) voor meer informatie over de String functies die SqlClient ondersteunt.

Zie ook

• SqlClient voor Entity Framework Functions
• Bekende problemen in SqlClient voor Entity Framework