System.Data.SqlTypes 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供 SQL Server 中原生資料類型的類別。 相較於 .NET Framework Common Language Runtime (CLR) 所提供的資料型別,這些類別提供更安全、快速的替代方案。 使用這個命名空間內的類別,有助於防止因精確度喪失所造成的型別轉換錯誤。 因為其他資料類型是祕密地轉換至/自 SqlTypes,所以明確建立和使用這個命名空間內的物件也會產生更快速的程式碼。
類別
結構
SqlBinary |
表示要存放在資料庫或從資料庫中擷取之二進位資料的可變長度資料流。 |
SqlBoolean |
表示要存放在資料庫或從資料庫擷取的 1 或 0 之整數值。 |
SqlByte |
表示要存放在資料庫或從資料庫擷取的 8 位元不帶正負號的整數 (Unsigned Integer),範圍介於 0 到 255 之間。 |
SqlDateTime |
表示要存放在資料庫或從資料庫擷取的日期與時間資料,值範圍從 1753 年 1 月 1 日至 9999 年 12 月 31 日,精確度為 3.33 毫秒。 SqlDateTime 結構的底層資料結構與其對應的 .NET 型別 DateTime 不同,後者可以表示介於 0001/1/1 上午 12:00:00 到 9999/12/31 下午 11:59:59 之間的任何時間,精確度可達 100 奈秒。 SqlDateTime 實際儲存的則是與 1900 年 1 月 1 日上午 00:00:00 的相對差異。 因此將 "00:00:00 AM 1/1/1900" 轉換成整數的結果將傳回 0。 |
SqlDecimal |
表示具有固定整數位數和小數位數的數值,介於 - 10^38 +1 和 10^38 - 1 之間。 |
SqlDouble |
表示 -1.79E +308 到 1.79E +308 範圍內的浮點數 (儲存於資料庫或從資料庫擷取)。 |
SqlGuid |
表示要存放在資料庫或從資料庫擷取的 GUID。 |
SqlInt16 |
表示要在資料庫中儲存或擷取的 16 位元帶正負號的整數。 |
SqlInt32 |
表示要在資料庫中儲存或擷取的 32 位元帶正負號的整數 (Signed Integer)。 |
SqlInt64 |
表示要在資料庫中儲存或擷取的 64 位元帶正負號的整數。 |
SqlMoney |
表示要存放在資料庫或從資料庫擷取的貨幣值,範圍從 -2 63 (或 -922,337,203,685,477.5808) 到 2 63 -1 (或 +922,337,203,685,477.5807),正確率為貨幣單位的萬分之一。 |
SqlSingle |
表示 -3.40E +38 到 3.40E +38 範圍內的浮點數 (儲存於資料庫或從資料庫擷取)。 |
SqlString |
表示要儲存在資料庫或自資料庫擷取之字元的可變長度資料流。 SqlString 的底層資料結構與其對應的 .NET String 資料型別 不同。 |
介面
INullable |
所有的 System.Data.SqlTypes 物件和結構都會實作 |
列舉
SqlCompareOptions |
指定 SqlString 結構的比較選項。 |
StorageState |
StorageState 列舉型別 (Enumeration) 並非要做為獨立的元件使用,而是要做為其他類別衍生標準功能的列舉型別。 |
備註
SqlTypes 中的每個資料類型在 SQL Server 中都有相等的資料類型,且具有相同的基礎資料標記法。 其中許多都在 CLR 中也有相等的資料類型。 但是, SqlDateTime、 SqlDecimal 和 SqlString 有不同的基礎資料結構與其對應的 .NET Framework 資料類型。
下表對應 SqlTypes 命名空間的成員,以 Microsoft SQL Server 資料類型和列舉的成員 SqlDbType 。
.NET FrameworkSqlTypes | 原生 SQL Server | .NET Framework SqlDbType |
---|---|---|
SqlBinary | binary、image、timestamp、Varbinary | Binary、Image、TimeStamp、VarBinary |
SqlBoolean | bit | bit |
SqlByte | TINYINT | TinyInt |
SqlBytes | binary、image、timestamp、Varbinary | Binary、Image、TimeStamp、VarBinary |
SqlChars | char、Nchar、text、Ntext、Nvarchar、Varchar | Char、NChar、Text、Ntext、NVarChar、VarChar |
SqlDateTime | datetime, smalldatetime | DateTime、SmallDateTime |
SqlDecimal | numeric、decimal | Decimal |
SqlDouble | FLOAT | Float |
SqlFileStream | varbinary | VarBinary |
SqlGuid | UNIQUEIDENTIFIER | UniqueIdentifier |
SqlInt16 | SMALLINT | SmallInt |
SqlInt32 | int | Int |
SqlInt64 | BIGINT | BigInt |
SqlMoney | money、smallmoney | Money、SmallMoney |
SqlSingle | real | Real |
SqlString | char、Nchar、text、Ntext、Nvarchar、Varchar | Char、NChar、Text、Ntext、NVarChar、VarChar |
SqlXml | Xml | Xml |