文字列正規関数 (Entity SQL)

[アーティクル]
02/24/2011

Entity SQL には、文字列正規関数が含まれています。

解説

次の表に、文字列 Entity SQL 正規関数を示します。

機能	説明
Concat ( string1, string2)	string1 に追加された string2 を含む文字列を返します。引数 string1: string2 の追加先となる文字列。 string2: string1 に追加される文字列。戻り値 String。戻り値の文字列の長さが許容される最大長よりも長い場合は、エラーが発生します。例 `-- The following example returns abcxyz.` `Concat('abc', 'xyz')`
Contains ( string, target)	target が string に含まれる場合は、true を返します。引数 string: 検索条件となる文字列。 target: 検索対象となる文字列。戻り値 target が string に含まれる場合は true。それ以外の場合は false。例 `-- The following example returns true.` `Contains('abc', 'bc')`
EndsWith ( string, target)	target が string で終わる場合は、true を返します。引数 string: 検索条件となる文字列。 target: string の末尾部分で検索対象となる文字列。戻り値 string が target で終わる場合は true。それ以外の場合は false。例 `-- The following example returns true.` `EndsWith('abc', 'bc')` 注 : SQL Server データプロバイダーの使用時に、文字列が固定長文字列の列に格納されており target が定数である場合、この関数は false を返します。この場合、末尾の埋め込み空白も含めて文字列全体が検索されます。この問題を回避するには、データを固定長文字列の長さに合わせて切り詰めます。たとえば、`EndsWith(TRIM(string), target)` のように指定します。
IndexOf( target, string)	string 内における target の位置を返します。見つからない場合は 0 を返します。 string の先頭を示す場合は 1 を返します。インデックスの番号は 1 から始まります。引数 target: 検索対象となる文字列。 string: 検索条件となる文字列。戻り値 Int32。例 `-- The following example returns 4.` `IndexOf('xyz', 'abcxyz')`
Left ( string, length)	string の左側から最初の length 文字を返します。 string の長さが length よりも短い場合は、文字列全体が返されます。引数 string: String。 length: Int16、Int32、Int64、または Byte。 length は 0 未満には設定できません。戻り値 String。例 `-- The following example returns abc.` `Left('abcxyz', 3)`
Length ( string )	文字列の長さ (Int32) を文字数として返します。引数 string: String。戻り値 Int32。例 `-- The following example returns 6.` `Legth('abcxyz')`
LTrim( string )	先頭の空白文字を除いた string を返します。引数 String。戻り値 String。例 `-- The following example returns abc.` `LTrim(' abc')`
Replace ( string1, string2, string3)	すべての string2 を string3 で置き換えた string1 を返します。引数 String。戻り値 String。例 `-- The following example returns abcxyz.` `Concat('abc', 'xyz')`
Reverse ( string )	文字の順序を逆にした string を返します。引数 String。戻り値 String。例 `-- The following example returns dcba.` `Reverse('abcd')`
Right ( string, length)	string の最後の length 文字を返します。 string の長さが length よりも短い場合は、文字列全体が返されます。引数 string: String。 length: Int16、Int32、Int64、または Byte。 length は 0 未満には設定できません。戻り値 String。例 `-- The following example returns xyz.` `Right('abcxyz', 3)`
RTrim( string )	末尾の空白文字を除いた string を返します。引数 String。戻り値 String。
Substring ( string, start, length)	start 位置から長さが length 文字の部分文字列を返します。開始が 1 の場合は、文字列の最初の文字を示します。インデックスの番号は 1 から始まります。引数 string: String。 start: Int16、Int32、Int64、および Byte。 start は 1 未満には設定できません。 length: Int16、Int32、Int64、および Byte。 length は 0 未満には設定できません。戻り値 String。例 `-- The following example returns xyz.` `Substring('abcxyz', 4, 3)`
StartsWith ( string, target)	string が target で始まる場合は、true を返します。引数 string: 検索条件となる文字列。 target: string の開始部分で検索対象となる文字列。戻り値 string が target で始まる場合は true。それ以外の場合は false。例 `-- The following example returns true.` `StartsWith('abc', 'ab')`
ToLower( string )	大文字が小文字に変換された string を返します。引数 String。戻り値 String。例 `-- The following example returns abc.` `ToLower('ABC')`
ToUpper( string )	小文字が大文字に変換された string を返します。引数 String。戻り値 String。例 `-- The following example returns ABC.` `ToUpper('abc')`
Trim( string )	先頭および末尾の空白文字を除いた string を返します。引数 String。戻り値 String。例 `-- The following example returns abc.` `Trim(' abc ')`

null が入力された場合、これらの関数は null を返します。

同等の機能は、Microsoft SQL クライアントマネージプロバイダーでも利用できます。詳細については、「Entity Framework 用 .NET Framework Data Provider for SQL Server (SqlClient) 関数」を参照してください。

参照

概念

正規関数 (Entity SQL)