System.Data.SqlTypes-Namespace

Der System.Data.SqlTypes-Namespace stellt Klassen für systemeigene Datentypen in SQL Server 2005 bereit. Diese Klassen stellen eine sicherere, schnellere Alternative zu Datentypen bereit, die von .NET Framework-CLR (Common Language Runtime) 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.

Für jeden Datentyp in SqlTypes ist in SQL Server 2005 ein entsprechender Datentyp vorhanden, der die gleiche zugrunde liegende Datendarstellung aufweist. Viele dieser Datentypen verfügen auch über entsprechende Datentypen in der CLR. SqlDateTime, SqlDecimal und SqlString weisen jedoch andere zugrunde liegende Datenstrukturen als die entsprechenden .NET Framework-Datentypen auf.

In der folgenden Tabelle werden die Member des SqlTypes-Namespaces Microsoft SQL Server-Datentypen und Membern der SqlDbType-Enumeration zugeordnet.

.NET Framework-SqlTypes	SQL Server systemeigen	.NET Framework-SqlDbType
SqlBinary	binary, image, timestamp, varbinary	Binary, Image, TimeStamp, VarBinary
SqlBoolean	bit	Bit
SqlByte	tinyint	TinyInt
SqlDateTime	datetime, smalldatetime	DateTime, SmallDateTime
SqlDecimal	numeric, decimal	Numeric, Decimal
SqlDouble	float	Float
SqlGuid	uniqueidentifier	UniqueId
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

Klassen

	Klasse	Beschreibung
	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 Verweistyp dar, der entweder einen Buffer oder einen Stream einschließt.
	SqlChars	SqlChars ist ein veränderlicher Verweistyp, der ein Char-Array oder eine SqlString-Instanz einschließt.
	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.

Schnittstellen

	Schnittstelle	Beschreibung
	INullable	Alle System.Data.SqlTypes-Objekte und -Strukturen implementieren die INullable-Schnittstelle.

Strukturen

	Struktur	Beschreibung
	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 Framework-Typ, DateTime, der jede Zeit zwischen dem 01.01.0001 um 12.00.00 Uhr und dem 31.12.9999 um 23.59.59 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 -263 (oder -9.223.372.036.854.775.808) bis 263 -1 (oder +9.223.372.036.854.775.807) 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 mit variabler Länge dar, der in der Datenbank gespeichert oder daraus abgerufen werden soll. SqlString besitzt eine andere zugrunde liegende Datenstruktur als sein entsprechender .NET Framework String-Datentyp. Der String verwendet immer die Standard-CultureInfo des aktuellen Threads, aber derSqlString enthält eigene Gebietsschemabezeichner und Vergleichsflags. Das Vergleichsergebnis von zwei SqlString-Strukturen ist unabhängig vom Betriebssystem und dem aktuellen Threadgebietsschema.

Enumerationen

	Enumeration	Beschreibung
	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.