System.Data.SqlTypes Пространство имен

Предоставляет классы собственных типов данных, используемых в SQL Server. Эти классы предоставляют более безопасную и быструю альтернативу типа данных, обеспечиваемых CLR (Common Language Runtime)-типами платформы .NET Framework. Использование классов данного пространства имен позволяет избежать ошибок, возникающих вследствие преобразования типов с потерей точности. Кроме того, использование данного пространства имен позволяет значительно повысить производительность, так как при использовании любых других типов данных системе приходится преобразовывать их к типам SqlTypes и обратно.

Классы

SqlAlreadyFilledException

Класс SqlAlreadyFilledException предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

SqlBytes

Представляет изменяемый ссылочный тип, служащий оболочкой для Buffer или Stream.

SqlChars

SqlChars —изменяемый ссылочный тип, служащий оболочкой для массива Char или экземпляра SqlString.

SqlFileStream

Предоставляет данные сервера SQL Server, сохраненные с помощью атрибута столбца FILESTREAM, как последовательность байтов.

SqlNotFilledException

Класс SqlNotFilledException предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

SqlNullValueException

Исключение, возникающее, когда для свойства Value структуры System.Data.SqlTypes установлено значение NULL.

SqlTruncateException

Исключение, генерируемое в том случае, когда в структуре System.Data.SqlTypes задается значение, которое было бы усечено.

SqlTypeException

Базовый класс исключений для System.Data.SqlTypes.

SqlTypesSchemaImporterExtensionHelper

Класс SqlTypesSchemaImporterExtensionHelper предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

SqlXml

Представляет XML-данные, сохраняемые на сервере или извлекаемые с него.

TypeBigIntSchemaImporterExtension

Класс TypeBigIntSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeBinarySchemaImporterExtension

Класс TypeBinarySchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeBitSchemaImporterExtension

Класс TypeBitSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeCharSchemaImporterExtension

Класс TypeCharSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeDateTimeSchemaImporterExtension

Класс TypeDateTimeSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeDecimalSchemaImporterExtension

Класс TypeDecimalSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeFloatSchemaImporterExtension

Класс TypeFloatSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeIntSchemaImporterExtension

Класс TypeIntSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeMoneySchemaImporterExtension

Класс TypeMoneySchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeNCharSchemaImporterExtension

Класс TypeNCharSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeNTextSchemaImporterExtension

Класс TypeNTextSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeNumericSchemaImporterExtension

Класс TypeNumericSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeNVarCharSchemaImporterExtension

Класс TypeNVarCharSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeRealSchemaImporterExtension

Класс TypeRealSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeSmallDateTimeSchemaImporterExtension

Класс TypeSmallDateTimeSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeSmallIntSchemaImporterExtension

Класс TypeSmallIntSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeSmallMoneySchemaImporterExtension

Класс TypeSmallMoneySchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeTextSchemaImporterExtension

Класс TypeTextSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeTinyIntSchemaImporterExtension

Класс TypeTinyIntSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeUniqueIdentifierSchemaImporterExtension

Класс TypeUniqueIdentifierSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeVarBinarySchemaImporterExtension

Класс TypeVarBinarySchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeVarCharSchemaImporterExtension

Класс TypeVarCharSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

TypeVarImageSchemaImporterExtension

Класс TypeVarImageSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.

Структуры

SqlBinary

Представляет поток двоичных данных переменной длины, сохраняемый в базе данных или извлекаемый из нее.

SqlBoolean

Представляет целое значение 1 или 0, сохраняемое в базе данных или извлекаемое из нее.

SqlByte

Представляет 8-разрядное целое число без знака в диапазоне от 0 до 255, сохраняемое в базе данных или извлекаемое из нее.

SqlDateTime

Представляет сохраняемые в базе данных или извлекаемые из нее данные о дате и времени в диапазоне значений от 1 января 1753 г. до 31 декабря 9999 г. с точностью 3,33 миллисекунды. Базовая структура данных структуры SqlDateTime отличается от соответствующего типа .NET, DateTime, который может представлять любое время между 00:00:00 01.01.0001 и 23:59:59 31.12.9999 с точностью 100 наносекунд. В объекте SqlDateTime фактически хранится разница относительно 00:00:00 01.01.1900. Поэтому в результате преобразования "00:00:00 01.01.1900" в целое число будет возвращен 0.

SqlDecimal

Представляет числовое значение с фиксированной точностью и масштабом в диапазоне от - 10^38 +1 и 10^38 - 1.

SqlDouble

Представляет число с плавающей запятой в диапазоне от -1,79E + 308 до 1,79E + 308, сохраняемое в базе данных или извлекаемое из нее.

SqlGuid

Представляет код GUID, сохраняемый в базе данных или извлекаемый из нее.

SqlInt16

Представляет 16-разрядное целое число со знаком, сохраняемое в базе данных или извлекаемое из нее.

SqlInt32

Представляет 32-разрядное целое число со знаком, сохраняемое в базе данных или извлекаемое из нее.

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 отличается от соответствующего типа данных String в .NET.

Интерфейсы

INullable

Во всех объектах и структурах System.Data.SqlTypes реализован интерфейс INullable.

Перечисления

SqlCompareOptions

Задает значения параметров сравнения для структуры SqlString.

StorageState

Перечисление StorageState не предназначено для использования в качестве самостоятельного компонента; оно является перечислением, от которого другие классы наследуют стандартные функциональные возможности.

Комментарии

каждый тип данных в SqlTypes имеет эквивалентный тип данных в SQL Server с тем же базовым представлением данных. Многие из них также имеют эквивалентные типы данных в среде CLR. однако SqlDateTime, SqlDecimal и SqlString имеют разные базовые структуры данных с соответствующими платформа .NET Framework типами данных.

следующая таблица сопоставляет элементы пространства имен SqlTypes с Microsoft SQL Server типами данных и элементами SqlDbType перечисления.

платформа .NET Framework SqlTypes Машинный SQL Server .NET Framework SqlDbType
SqlBinary двоичный, образ, метка времени, varbinary Двоичный, образ, метка времени, VarBinary
SqlBoolean bit bit
SqlByte tinyint TinyInt
SqlBytes двоичный, образ, метка времени, varbinary Двоичный, образ, метка времени, VarBinary
SqlChars char, nchar, Text, ntext, nvarchar, varchar Char, NChar, Text, ntext, NVarChar, VarChar
SqlDateTime datetime, smalldatetime DateTime, SmallDateTime
SqlDecimal Числовой, десятичный 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

См. также раздел