閱讀英文版本

分享方式：

SqlString 結構

  • 參考

定義

命名空間:
System.Data.SqlTypes
組件:
System.Data.Common.dll
組件:
System.Data.SqlClient.dll
組件:
System.Data.dll
組件:
netstandard.dll
來源:
SQLString.cs
來源:
SQLString.cs
來源:
SQLString.cs

表示要儲存在資料庫或自資料庫擷取之字元的可變長度資料流。 SqlString 的底層資料結構與其對應的 .NET String 資料型別 不同。

C# 
public struct SqlString : IComparable, System.Data.SqlTypes.INullable, System.Xml.Serialization.IXmlSerializable
C# 
public struct SqlString : IComparable, IEquatable<System.Data.SqlTypes.SqlString>, System.Data.SqlTypes.INullable, System.Xml.Serialization.IXmlSerializable
C# 
public struct SqlString : IComparable, System.Data.SqlTypes.INullable
C# 
[System.Serializable]
public struct SqlString : IComparable, System.Data.SqlTypes.INullable, System.Xml.Serialization.IXmlSerializable
繼承
Object
ValueType
SqlString
屬性
SerializableAttribute
實作
INullable IComparable IXmlSerializable IEquatable<SqlString>

備註

String 一律會使用目前線程中的預設值 CultureInfo ，但 SqlString 包含自己的地區設定標識符並比較旗標。 兩 SqlString 個結構的比較結果與操作系統和目前的線程地區設定無關。

當您使用 SqlString 比較運算符時，請注意，如果自變數的 LCID 不同，比較函式會擲回例外狀況，因為它們無法進行比較。 例如，語句

SqlString mySqlString = new SqlString("abc");

相當於

SqlString mySqlString = new SqlString("abc", CultureInfo.CurrentCulture.LCID);

建構函式

SqlString(Int32, SqlCompareOptions, Byte[])

使用指定的地區設定 ID、比較選項和資料，初始化 SqlString 結構的新執行個體。
SqlString(Int32, SqlCompareOptions, Byte[], Boolean)

初始化 SqlString 類別的新執行個體。
SqlString(Int32, SqlCompareOptions, Byte[], Int32, Int32)

初始化 SqlString 類別的新執行個體。
SqlString(Int32, SqlCompareOptions, Byte[], Int32, Int32, Boolean)

初始化 SqlString 類別的新執行個體。
SqlString(String)

使用指定的字串，初始化 SqlString 結構的新執行個體。
SqlString(String, Int32)

使用指定的字串與地區設定 ID (Locale ID) 值，初始化 SqlString 結構的新執行個體。
SqlString(String, Int32, SqlCompareOptions)

用指定的字串、地區設定 ID 和比較選項值，初始化 SqlString 結構的新執行個體。

欄位

BinarySort

指定排序應該根據字元數值，而非其字母順序值。
BinarySort2

指定排序應該根據字元的數值，而非其字母順序值。
IgnoreCase

指定 SqlString 比較必須應該忽略大小寫。
IgnoreKanaType

指定字串比較必須忽略假名類型。
IgnoreNonSpace

指定字串比較必須忽略非空格組合的字元，例如變音符號 (Diacritic)。
IgnoreWidth

指定字串比較必須忽略字元寬度。
Null

表示 DBNull，可以指派至 SqlString 結構的執行個體。

屬性

CompareInfo

取得 CompareInfo 物件，其定義應該如何為這個 SqlString 結構執行字串比較。
CultureInfo

取得 CultureInfo 結構，其表示有關這個 SqlString 物件的文化特性 (Culture) 資訊。
IsNull

表示這個 SqlString 結構是否為 Null。
LCID

指定 SqlString 結構的地理地區設定和語言。
SqlCompareOptions

一個或多個 SqlCompareOptions 列舉 (Enumeration) 值的組合表示應該將這個 SqlString 與其他 SqlString 結構相比較的方式。
Value

取得存放在這個 SqlString 結構中的字串。 這個屬性是唯讀的。

方法

Add(SqlString, SqlString)

將兩個指定的 SqlString 參數串連，以建立新的 SqlString 結構。
Clone()

建立這個 SqlString 物件的複本。
CompareOptionsFromSqlCompareOptions(SqlCompareOptions)

取得指定 SqlCompareOptions 值的相等 CompareOptions 列舉。
CompareTo(Object)

將這個 SqlString 物件與提供的 Object 相比較，並傳回它們相對值的指示。
CompareTo(SqlString)

將這個 SqlString 執行個體與提供的 SqlString 相比較，並傳回它們相對值的指示。
Concat(SqlString, SqlString)

將兩個指定的 SqlString 結構串連在一起。
Equals(Object)

將提供的物件參數與 Value 物件的 SqlString 屬性相比較。
Equals(SqlString)

指出目前的實例是否等於相同類型的另一個實例。
Equals(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，以判斷它們是否相等。
GetHashCode()

取得這個執行個體的雜湊程式碼。
GetNonUnicodeBytes()

取得位元組的陣列，包含 ANSI 格式的 SqlString 內容。
GetUnicodeBytes()

取得位元組的陣列，包含 Unicode 格式的 SqlString 內容。
GetXsdType(XmlSchemaSet)

傳回指定之 XmlSchemaSet 的 XML 結構描述定義語言 (XSD)。
GreaterThan(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，判斷第一個運算元是否大於第二個。
GreaterThanOrEqual(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，判斷第一個運算元是否大於或等於第二個。
LessThan(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，判斷第一個運算元是否小於第二個。
LessThanOrEqual(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，判斷第一個運算元是否小於或等於第二個。
NotEquals(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，以判斷它們是否不相等。
ToSqlBoolean()

將這個 SqlString 結構轉換為 SqlBoolean。
ToSqlByte()

將這個 SqlString 結構轉換為 SqlByte。
ToSqlDateTime()

將這個 SqlString 結構轉換為 SqlDateTime。
ToSqlDecimal()

將這個 SqlString 結構轉換為 SqlDecimal。
ToSqlDouble()

將這個 SqlString 結構轉換為 SqlDouble。
ToSqlGuid()

將這個 SqlString 結構轉換為 SqlGuid。
ToSqlInt16()

將這個 SqlString 結構轉換為 SqlInt16。
ToSqlInt32()

將這個 SqlString 結構轉換為 SqlInt32。
ToSqlInt64()

將這個 SqlString 結構轉換為 SqlInt64。
ToSqlMoney()

將這個 SqlString 結構轉換為 SqlMoney。
ToSqlSingle()

將這個 SqlString 結構轉換為 SqlSingle。
ToString()

將 SqlString 物件轉換成 String。

運算子

Addition(SqlString, SqlString)

將兩個指定的 SqlString 結構串連在一起。
Equality(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，以判斷它們是否相等。
Explicit(SqlBoolean to SqlString)

將指定的 SqlBoolean 結構轉換成 SqlString。
Explicit(SqlByte to SqlString)

將指定的 SqlByte 結構轉換成 SqlString。
Explicit(SqlDateTime to SqlString)

將指定的 SqlDateTime 參數轉換成 SqlString。
Explicit(SqlDecimal to SqlString)

將指定的 SqlDecimal 參數轉換成 SqlString。
Explicit(SqlDouble to SqlString)

將指定的 SqlDouble 參數轉換成 SqlString。
Explicit(SqlGuid to SqlString)

將指定的 SqlGuid 參數轉換成 SqlString。
Explicit(SqlInt16 to SqlString)

將指定的 SqlInt16 參數轉換成 SqlString。
Explicit(SqlInt32 to SqlString)

將指定的 SqlInt32 參數轉換成 SqlString。
Explicit(SqlInt64 to SqlString)

將指定的 SqlInt64 參數轉換成 SqlString。
Explicit(SqlMoney to SqlString)

將指定的 SqlMoney 參數轉換成 SqlString。
Explicit(SqlSingle to SqlString)

將指定的 SqlSingle 參數轉換成 SqlString。
Explicit(SqlString to String)

將 SqlString 轉換成 String。
GreaterThan(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，判斷第一個運算元是否大於第二個。
GreaterThanOrEqual(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，判斷第一個運算元是否大於或等於第二個。
Implicit(String to SqlString)

將 String 參數轉換成 SqlString。
Inequality(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，以判斷它們是否不相等。
LessThan(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，判斷第一個運算元是否小於第二個。
LessThanOrEqual(SqlString, SqlString)

執行兩個 SqlString 運算元的邏輯比對，判斷第一個運算元是否小於或等於第二個。

明確介面實作

IXmlSerializable.GetSchema()

此成員支援 .NET Framework 基礎結構，並不能直接使用於您的程式碼中。
IXmlSerializable.ReadXml(XmlReader)

此成員支援 .NET Framework 基礎結構，並不能直接使用於您的程式碼中。
IXmlSerializable.WriteXml(XmlWriter)

此成員支援 .NET Framework 基礎結構，並不能直接使用於您的程式碼中。

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

另請參閱