System.Data.SqlTypes Namespace

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 Value-Eigenschaft einer System.Data.SqlTypes-Struktur auf NULL festgelegt wird.
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 INullable-Schnittstelle.

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

Siehe auch

• SQL Server-Datentypzuordnungen (ADO.NET)
• SQL Server-Datentypen und ADO.NET