System.Data.SqlTypes Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dieser Namespace stellt Klassen für native Datentypen in SQL Server bereit. Diese Klassen stellen eine sicherere, schnellere Alternative zu Datentypen bereit, die von der Common Language Runtime (CLR) von .NET Framework bereitgestellt werden. Durch das Verwenden der Klassen in diesem Namespace können durch Verlust an Genauigkeit verursachte Typkonvertierungsfehler besser verhindert werden. Da andere Datentypen im Hintergrund in und aus SqlTypes konvertiert werden, führt das explizite Erstellen und Verwenden von Objekten in diesem Namespace auch zu einem schnelleren Code.
Klassen
| SqlAlreadyFilledException |
Die SqlAlreadyFilledException-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| SqlBytes |
Stellt einen veränderlichen Referenztyp dar, der entweder einen Buffer oder einen Stream umschließt. |
| SqlChars |
SqlChars ist ein veränderlicher Referenztyp, der ein Char-Array oder eine SqlString-Instanz umschließt. |
| SqlFileStream |
Macht SQL Server-Daten verfügbar, die mit dem FILESTREAM-Spaltenattribut als eine Folge von Bytes gespeichert sind. |
| SqlNotFilledException |
Die SqlNotFilledException-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| SqlNullValueException |
Die Ausnahme, die ausgelöst wird, wenn die |
| SqlTruncateException |
Die Ausnahme, die ausgelöst wird, wenn das Festlegen eines Werts in einer System.Data.SqlTypes-Struktur zum Abschneiden dieses Werts führen würde. |
| SqlTypeException |
Die Basisausnahmeklasse für die System.Data.SqlTypes. |
| SqlTypesSchemaImporterExtensionHelper |
Die SqlTypesSchemaImporterExtensionHelper-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| SqlXml |
Stellt XML-Daten dar, die auf einem Server gespeichert oder von diesem abgerufen werden. |
| TypeBigIntSchemaImporterExtension |
Die TypeBigIntSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeBinarySchemaImporterExtension |
Die TypeBinarySchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeBitSchemaImporterExtension |
Die TypeBitSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeCharSchemaImporterExtension |
Die TypeCharSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeDateTimeSchemaImporterExtension |
Die TypeDateTimeSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeDecimalSchemaImporterExtension |
Die TypeDecimalSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeFloatSchemaImporterExtension |
Die TypeFloatSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeIntSchemaImporterExtension |
Die TypeIntSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeMoneySchemaImporterExtension |
Die TypeMoneySchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeNCharSchemaImporterExtension |
Die TypeNCharSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeNTextSchemaImporterExtension |
Die TypeNTextSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeNumericSchemaImporterExtension |
Die TypeNumericSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeNVarCharSchemaImporterExtension |
Die TypeNVarCharSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeRealSchemaImporterExtension |
Die TypeRealSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeSmallDateTimeSchemaImporterExtension |
Die TypeSmallDateTimeSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeSmallIntSchemaImporterExtension |
Die TypeSmallIntSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeSmallMoneySchemaImporterExtension |
Die TypeSmallMoneySchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeTextSchemaImporterExtension |
Die TypeTextSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeTinyIntSchemaImporterExtension |
Die TypeTinyIntSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeUniqueIdentifierSchemaImporterExtension |
Die TypeUniqueIdentifierSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeVarBinarySchemaImporterExtension |
Die TypeVarBinarySchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeVarCharSchemaImporterExtension |
Die TypeVarCharSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
| TypeVarImageSchemaImporterExtension |
Die TypeVarImageSchemaImporterExtension-Klasse ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als Klasse, von der andere Klassen Standardfunktionen ableiten. |
Strukturen
| SqlBinary |
Stellt einen binären Datenstream variabler Länge dar, der in einer Datenbank gespeichert oder aus dieser abgerufen wird. |
| SqlBoolean |
Stellt einen Ganzzahlwert von entweder 1 oder 0 dar, der in einer Datenbank gespeichert oder aus dieser abgerufen werden soll. |
| SqlByte |
Stellt eine 8-Bit-Ganzzahl ohne Vorzeichen im Bereich zwischen 0 und 255 dar, die in einer Datenbank gespeichert oder aus dieser abgerufen werden soll. |
| SqlDateTime |
Stellt die Daten für Datum und Uhrzeit mit einem Wert im Bereich zwischen dem 1. Januar 1753 und dem 31. Dezember 9999 mit einer Genauigkeit von 3,33 Millisekunden dar, die in einer Datenbank gespeichert oder aus dieser abgerufen werden sollen. SqlDateTime besitzt eine andere zugrunde liegende Datenstruktur als der entsprechende .NET-Typ DateTime, der jede Zeit zwischen dem 01.01.0001 12:00:00 Uhr und dem 31.12.9999 23:59:59 Uhr mit einer Genauigkeit von 100 Nanosekunden darstellen kann. SqlDateTime speichert den relativen Unterschied zum 01.01.1900 um 00.00.00 Uhr. Deshalb gibt eine Konvertierung von "00.00.00 Uhr am 01.01.1900" in eine ganze Zahl den Wert 0 (null) zurück. |
| SqlDecimal |
Stellt einen numerischen Wert mit fester Genauigkeit und Dezimalstellen zwischen - 10^38 +1 und 10^38 - 1 dar. |
| SqlDouble |
Stellt eine Gleitkommazahl im Bereich zwischen -1,79E +308 bis 1,79E +308 dar, die in einer Datenbank gespeichert oder aus dieser abgerufen werden soll. |
| SqlGuid |
Stellt eine GUID dar, die in einer Datenbank gespeichert oder aus dieser abgerufen werden soll. |
| SqlInt16 |
Stellt eine 16-Bit-Ganzzahl mit Vorzeichen dar, die in einer Datenbank gespeichert oder aus dieser abgerufen werden soll. |
| SqlInt32 |
Stellt eine 32-Bit-Ganzzahl mit Vorzeichen dar, die in einer Datenbank gespeichert oder aus dieser abgerufen werden soll. |
| SqlInt64 |
Stellt eine 64-Bit-Ganzzahl mit Vorzeichen dar, die in einer Datenbank gespeichert oder aus dieser abgerufen werden soll. |
| SqlMoney |
Stellt einen Währungswert von –2 63 (oder –922.337.203.685.477,5808) bis 263 –1 (oder +922.337.203.685.477,5807) mit einer Genauigkeit eines Zehntausendstels einer Währungseinheit dar, der in einer Datenbank gespeichert oder aus dieser abgerufen werden soll. |
| SqlSingle |
Stellt eine Gleitkommazahl im Bereich zwischen -3,40E +38 bis 3,40E +38 dar, die in einer Datenbank gespeichert oder aus dieser abgerufen werden soll. |
| SqlString |
Stellt einen Zeichenstream variabler Länge dar, der in der Datenbank gespeichert oder dort abgerufen wird. SqlString hat eine andere zugrunde liegende Datenstruktur als der entsprechende String-Datentyp in .NET. |
Schnittstellen
| INullable |
Alle System.Data.SqlTypes-Objekte und -Strukturen implementieren die |
Enumerationen
| SqlCompareOptions |
Gibt die Werte für Vergleichsoptionen einer SqlString-Struktur an. |
| StorageState |
Die StorageState-Enumeration ist nicht für die Verwendung als eigenständige Komponente ausgelegt, sondern als eine Enumeration, von der andere Klassen Standardfunktionen ableiten. |
Hinweise
Jeder Datentyp in SqlTypes hat seinen entsprechenden Datentyp in SQL Server, mit derselben zugrunde liegenden Datendarstellung. Viele von ihnen verfügen auch über gleichwertige Datentypen in der CLR. SqlDateTime, SqlDecimal und SqlString verfügen jedoch über unterschiedliche zugrunde liegende Datenstrukturen mit den entsprechenden .NET Framework Datentypen.
Die folgende Tabelle ordnet die Member des SqlTypes-Namespace Microsoft SQL Server Datentypen und den Membern der -Enumeration SqlDbType zu.
| .NET Framework Sqltypes | Native 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 |