Udostępnij przez

Funkcje ciągów

Dostawca danych .NET Framework dla SQL Server (SqlClient) udostępnia String funkcje, które wykonują operacje na danych wejściowych String i zwracają wynik String lub wartość liczbową. 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 .

Funkcja Opis
ASCII(expression) Zwraca wartość kodu ASCII z lewego znaku wyrażenia ciągu.

Argumenty

expression: dowolne prawidłowe wyrażenie typu ASCII String .

Zwracana wartość

Jeden Int32.

Przykład

SqlServer.ASCII('A')
CHAR(expression) Konwertuje Int32 kod na ciąg ASCII.

Argumenty

expression: An Int32.

Zwracana wartość

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.

Zwracana wartość

Jeden 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ą.

Zwracana wartość

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 jest zwracany w SQL Server 2000) lub Int32 to typ określający, ile znaków z character_expression zostanie zwróconych.

Zwracana wartość

Unicode lub ASCII String.

Przykład

SqlServer.LEFT('SQL Server', 4)
LEN(expression) Zwraca liczbę znaków w określonym wyrażeniu typu String, z pominięciem końcowych spacji.

Argumenty

expression: wyrażenie String typu (Unicode lub ASCII) lub Binary typu

Zwracana wartość

Jeden 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.

Zwracana wartość

Element String.

Przykład

SqlServer.LOWER('AbB')
LTRIM(expression) Zwraca wyrażenie String po usunięciu spacji wiodących.

Argumenty

expression: dowolne prawidłowe wyrażenie String typu.

Zwracana wartość

Element 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.

Zwracana wartość

Unicode String.

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.

Zwracana wartość

Jeden 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 jednoliterowy 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.

Zwracana wartość

Unicode String.

Przykład

SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3) Zamienia wyrażenie znakowe na inne wyrażenie znakowe.

Argumenty

expression1: wyrażenie ciągu znaków 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 zamienny. expression3 może być typem ciągów Unicode lub ASCII.

Przykład

SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression) Powtarza sekwencję znaków określoną liczbę razy.

Argumenty

char_expression: Typ Unicode lub ASCII String .

int_expression: Int64 (nieobsługiwane w programie SQL Server 2000) lub Int32.

Zwracana wartość

Typ Unicode lub ASCII String .

Przykład

SqlServer.REPLICATE('aa',2)
REVERSE(expression) Zwraca ciąg znaków Unicode lub ASCII, w którym pozycje znaków zostały odwrócone względem ciągu wejściowego.

Argumenty

expression: Typ Unicode lub ASCII String .

Zwracana wartość

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 jest zwracany w SQL Server 2000) lub Int32 to typ określający, ile znaków z character_expression zostanie zwróconych.

Zwracana wartość

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 .

Zwracana wartość

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.

Zwracana wartość

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 pojedynczy znak ASCII String dla ciągu spacji.

Argumenty

int_expression: ( Int64 nie zwracany w programie SQL Server 2000) lub Int32 wskazujący liczbę spacji.

Zwracana wartość

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 przecinkiem dziesiętnym.

length: (opcjonalnie) Int32 reprezentujący łączną długość. Obejmuje to punkt dziesiętny, znak, cyfry i spacje. Wartość domyślna to 10.

decimal:(opcjonalny) Element Int32, który reprezentuje 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.

Zwracana wartość

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ść wyznaczająca miejsce 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.

Zwracana wartość

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.

Zwracana wartość

Typ String (ASCII lub Unicode) albo typ Binary.

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.

Zwracana wartość

Jeden 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.

Zwracana wartość

Typ String: ASCII lub Unicode.

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 także

  • Last updated on