Funkcje ciągów

Program .NET Framework Dostawca danych dla programu SQL Server (SqlClient) udostępnia String funkcje, które wykonują operacje na danych wejściowych String i zwracają String wynik wartości liczbowej lub. Te funkcje znajdują się w przestrzeni nazw SqlServer, która jest dostępna podczas korzystania z programu SqlClient. Właściwość przestrzeni nazw dostawcy umożliwia programowi Entity Framework wykrywanie, który prefiks jest używany przez tego dostawcę dla określonych konstrukcji, takich jak typy i funkcje.

W poniższej tabeli przedstawiono funkcje SqlClient String .

Function	opis
ASCII(expression)	Zwraca wartość kodu ASCII z lewego znaku wyrażenia ciągu. Argumenty expression: dowolne prawidłowe wyrażenie typu ASCII String . Wartość zwracana An Int32. Przykład SqlServer.ASCII('A')
CHAR(expression)	Konwertuje Int32 kod na ciąg ASCII. Argumenty expression: An Int32. Wartość zwracana ASCII String. Przykład SqlServer.char(97)
CHARINDEX(expression1, expression2 [, start_location])	Zwraca pozycję początkową określonego wyrażenia w ciągu znaku. Argumenty expression1: Wyrażenie zawierające sekwencję znaków, które mają zostać znalezione. Wyrażenie może mieć typ Ciąg (ASCII lub Unicode) lub typ binarny. expression2: Wyrażenie, zazwyczaj kolumna, która ma być wyszukiwana dla określonej sekwencji. Wyrażenie może mieć typ Ciąg (ASCII lub Unicode) lub typ binarny. start_location:(Optional) Int64 (nie zwracany w programie SQL Server 2000) lub Int32, który reprezentuje pozycję znaku, aby rozpocząć wyszukiwanie wyrażenia1 w wyrażeniu2. Jeśli nie określono start_location, jest liczbą ujemną lub jest zero, wyszukiwanie rozpoczyna się na początku wyrażenia2. Wartość zwracana An Int32. Przykład SqlServer.CHARINDEX('h', 'habcdefgh', 2)
DIFFERENCE(expression, expression)	Porównuje SOUNDEX wartości dwóch ciągów i ocenia podobieństwo między nimi. Argumenty Typ ASCII lub Unicode String . expression może być stałą, zmienną lub kolumną. Wartość zwracana Zwraca wartość reprezentującą różnicę Int32 między wartościami SOUNDEX dwóch wyrażeń znaków. Zakres wynosi od 0 do 4. 0 wskazuje słabą podobieństwo lub brak podobieństwa, a 4 wskazuje silną podobieństwo lub te same wartości. Przykład // The following example returns a DIFFERENCE value of 4, //the least possible difference or the best match. SqlServer.DIFFERENCE('Green','Greene');
LEFT(expression, count)	Zwraca lewą część ciągu znaków z określoną liczbą znaków. Argumenty expression: Typ ciągu Unicode lub ASCII. Użyj funkcji CAST, aby jawnie przekonwertować character_expression. count: ( Int64 nie zwracany w programie SQL Server 2000) lub Int32 typ określający liczbę znaków character_expression zostanie zwróconych. Wartość zwracana Unicode lub ASCII String. Przykład SqlServer.LEFT('SQL Server', 4)
LEN(expression)	Zwraca liczbę znaków w określonym wyrażeniu Ciąg z wyłączeniem końcowych wartości pustych. Argumenty expression: wyrażenie String typu (Unicode lub ASCII) lub Binary typu Wartość zwracana An Int32. Przykład SqlServer.LEN('abcd')
LOWER(expression)	String Zwraca wyrażenie po przekonwertowaniu danych z wielkimi literami na małe litery. Argumenty expression: dowolne prawidłowe wyrażenie String typu. Wartość zwracana Klasa String. Przykład SqlServer.LOWER('AbB')
LTRIM(expression)	String Zwraca wyrażenie po usunięciu spacji wiodących. Argumenty expression: dowolne prawidłowe wyrażenie String typu. Wartość zwracana Klasa String. Przykład SqlServer.LTRIM(' d')
NCHAR(expression)	Zwraca kod Unicode String z określonym kodem całkowitym zdefiniowanym przez standard Unicode. Argumenty expression: An Int32. Wartość zwracana StringUnicode . Przykład SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression)	Zwraca pozycję początkową pierwszego wystąpienia wzorca w określonym String wyrażeniu. Argumenty '%pattern%': typ ASCII lub Unicode String . Można użyć symboli wieloznacznych; jednak znak % musi znajdować się przed i po wzorcu (z wyjątkiem wyszukiwań dla pierwszych lub ostatnich znaków). expression: ASCII lub Unicode String , aby wyszukać określony wzorzec. Wartość zwracana An Int32. Przykład SqlServer.PATINDEX('abc', 'ab')
QUOTENAME('char_string' [, 'quote_char'])	Zwraca kod Unicode String z dodanymi ogranicznikami, aby ciąg wejściowy był prawidłowym identyfikatorem rozdzielanym przez program SQL Server 2005. Argumenty char_string: Unicode String. quote_char: ciąg jednoznaczny do użycia jako ogranicznik. Może to być pojedynczy cudzysłów ( ' ), lewy lub prawy nawias ([ ] ) lub podwójny cudzysłów ( " ). Jeśli quote_char nie zostanie określony, używane są nawiasy kwadratowe. Wartość zwracana StringUnicode . Przykład SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3)	Zamienia wyrażenie znaku na inne wyrażenie znaku. Argumenty expression1: wyrażenie ciągu do wyszukania. expression1 może być typem ciągów Unicode lub ASCII. expression2:Podciąg, który ma zostać znaleziony. expression2 może być typem ciągów Unicode lub ASCII. expression3; Ciąg zastępczy. expression3 może być typem ciągów Unicode lub ASCII. Przykład SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression)	Powtarza wyrażenie znaku dla określonej liczby razy. Argumenty char_expression: Typ Unicode lub ASCII String . int_expression: Int64 (nieobsługiwane w programie SQL Server 2000) lub Int32. Wartość zwracana Typ Unicode lub ASCII String . Przykład SqlServer.REPLICATE('aa',2)
REVERSE(expression)	Zwraca ciąg Unicode lub ASCII ze swoimi pozycjami znaków odwróconymi z ciągu wejściowego. Argumenty expression: Typ Unicode lub ASCII String . Wartość zwracana Typ Unicode lub ASCII String . Przykład SqlServer.REVERSE('abcd')
RIGHT(char_expression, count)	Zwraca prawą część ciągu znaków z określoną liczbą znaków. Argumenty char_expression:Typ ciągu Unicode lub ASCII. Użyj funkcji CAST, aby jawnie przekonwertować character_expression. count: ( Int64 nie zwracany w programie SQL Server 2000) lub Int32 typ określający liczbę znaków character_expression zostanie zwróconych. Wartość zwracana Typ ASCII String . Przykład SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression)	Zwraca ciąg Unicode lub ASCII po usunięciu spacji końcowych. Argumenty expression: Typ Unicode lub ASCII String . Wartość zwracana Typ Unicode lub ASCII String . Przykład SqlServer.RTRIM(' d e ')
SOUNDEX(expression)	Zwraca czteroznakowy kod (SOUNDEX), aby ocenić podobieństwo dwóch ciągów.Argumenty expression: Typ ciągu Unicode lub ASCII. Wartość zwracana ASCII String. Czteroznakowy kod (SOUNDEX) to ciąg, który ocenia podobieństwo dwóch ciągów. Przykład Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1} Zwroty ----- ----- S530 S530
SPACE(int_expression)	Zwraca ASCII String powtarzających się spacji. Argumenty int_expression: ( Int64 nie zwracany w programie SQL Server 2000) lub Int32 wskazujący liczbę spacji. Wartość zwracana ASCII String. Przykład SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]])	Zwraca wartość ASCII String przekonwertowaną z danych liczbowych. Argumenty float _expression: wyrażenie przybliżonego typu danych liczbowych (Double) z separatorem dziesiętnym. length: (opcjonalnie) Obiekt Int32 reprezentujący łączną długość. Obejmuje to punkt dziesiętny, znak, cyfry i spacje. Wartość domyślna to 10. decimal:(optional) Obiekt Int32 reprezentujący liczbę miejsc po prawej stronie przecinka dziesiętnego. Liczba dziesiętna musi być mniejsza lub równa 16. Jeśli liczba dziesiętna jest większa niż 16, wynik zostanie obcięty do szesnastu miejsc po prawej stronie punktu dziesiętnego. Wartość zwracana ASCII String. Przykład SqlServer.STR(212.0)
STUFF(str_expression, start, length, str_expression_to_insert)	Usuwa określoną długość znaków i wstawia inny zestaw znaków w określonym punkcie początkowym w wyrażeniu ciągu. Argumenty str_expression: Unicode lub ASCII String. start: Element Int64 (nie zwracany w programie SQL Server 2000) lub Int32 wartość określająca lokalizację do rozpoczęcia usuwania i wstawiania. length: ( Int64 nie zwracany w programie SQL Server 2000) lub Int32 wartość określającą liczbę znaków do usunięcia. str_expression_to_insert: Unicode lub ASCII String. Wartość zwracana Unicode lub ASCII String. Przykład SqlServer.STUFF('abcd', 2, 2, 'zz')
SUBSTRING(str_expression, start, length)	Zwraca część String wyrażenia. Argumenty str_expression: wyrażenie String typu (ASCII lub Unicode) lub Binary typu. start: ( Int64 nie jest zwracany w programie SQL Server 2000) lub Int32 określa, gdzie rozpoczyna się podciąg. 1 odnosi się do pierwszego znaku w ciągu. length: ( Int64 nie jest zwracany w programie SQL Server 2000) lub Int32 określa, ile znaków wyrażenia zostanie zwróconych. Wartość zwracana Typ String (ASCII lub Unicode) lub Binary typ. Przykład SqlServer.SUBSTRING('abcd', 2, 2)
UNICODE(expression)	Zwraca wartość całkowitą zdefiniowaną przez standard Unicode dla pierwszego znaku wyrażenia wejściowego. Argumenty expression: Unicode String. Wartość zwracana An Int32. Przykład SqlServer.UNICODE('a')
UPPER(expression)	String Zwraca wyrażenie po przekonwertowaniu małych liter na wielkie litery. Argumenty expression: wyrażenie typu ASCII lub Unicode String. Wartość zwracana Typ ASCII lub Unicode String . Przykład SqlServer.UPPER('AbB')

Aby uzyskać więcej informacji na temat String funkcji, które obsługuje sqlClient, zobacz Funkcje ciągów (Transact-SQL).

Zobacz też

• Klient SQL dla funkcji programu Entity Framework
• Znane problemy klienta SQL dla programu Entity Framework