System.Data.SqlTypes Namespace

Пространство имен System.Data.SqlTypes предоставляет классы собственных типов данных, используемых в SQL Server. The System.Data.SqlTypes namespace provides classes for native data types in SQL Server. Эти классы предоставляют более безопасную и быструю альтернативу типа данных, обеспечиваемых CLR (Common Language Runtime)-типами платформы .NET Framework. These classes provide a safer, faster alternative to the data types provided by the .NET Framework common language runtime (CLR). Использование классов данного пространства имен позволяет избежать ошибок, возникающих вследствие преобразования типов с потерей точности. Using the classes in this namespace helps prevent type conversion errors caused by loss of precision. Кроме того, использование данного пространства имен позволяет значительно повысить производительность, так как при использовании любых других типов данных системе приходится преобразовывать их к типам SqlTypes и обратно. Because other data types are converted to and from SqlTypes behind the scenes, explicitly creating and using objects within this namespace also yields faster code.

Классы

SqlAlreadyFilledException

Класс SqlAlreadyFilledException предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The SqlAlreadyFilledException class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

SqlBytes

Представляет изменяемый ссылочный тип, служащий оболочкой для Buffer или Stream.Represents a mutable reference type that wraps either a Buffer or a Stream.

SqlChars

SqlChars —изменяемый ссылочный тип, служащий оболочкой для массива Char или экземпляра SqlString.SqlChars is a mutable reference type that wraps a Char array or a SqlString instance.

SqlFileStream

Предоставляет доступ к данным на SQL Server, хранящихся в столбце с атрибутом FILESTREAM, в виде последовательности байтов.Exposes SQL Server data that is stored with the FILESTREAM column attribute as a sequence of bytes.

SqlNotFilledException

Класс SqlNotFilledException предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The SqlNotFilledException class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

SqlNullValueException

Исключение, возникающее, когда для свойства Value структуры System.Data.SqlTypes установлено значение NULL.The exception that is thrown when the Value property of a System.Data.SqlTypes structure is set to null.

SqlTruncateException

Исключение, генерируемое в том случае, когда в структуре System.Data.SqlTypes задается значение, которое было бы усечено.The exception that is thrown when you set a value into a System.Data.SqlTypes structure would truncate that value.

SqlTypeException

Базовый класс исключений для System.Data.SqlTypes.The base exception class for the System.Data.SqlTypes.

SqlTypesSchemaImporterExtensionHelper

Класс SqlTypesSchemaImporterExtensionHelper предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The SqlTypesSchemaImporterExtensionHelper class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

SqlXml

Представляет XML-данные, сохраняемые на сервере или извлекаемые с него.Represents XML data stored in or retrieved from a server.

TypeBigIntSchemaImporterExtension

Класс TypeBigIntSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeBigIntSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeBinarySchemaImporterExtension

Класс TypeBinarySchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeBinarySchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeBitSchemaImporterExtension

Класс TypeBitSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeBitSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeCharSchemaImporterExtension

Класс TypeCharSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeCharSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeDateTimeSchemaImporterExtension

Класс TypeDateTimeSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeDateTimeSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeDecimalSchemaImporterExtension

Класс TypeDecimalSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeDecimalSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeFloatSchemaImporterExtension

Класс TypeFloatSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeFloatSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeIntSchemaImporterExtension

Класс TypeIntSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeIntSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeMoneySchemaImporterExtension

Класс TypeMoneySchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeMoneySchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeNCharSchemaImporterExtension

Класс TypeNCharSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeNCharSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeNTextSchemaImporterExtension

Класс TypeNTextSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeNTextSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeNumericSchemaImporterExtension

Класс TypeNumericSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeNumericSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeNVarCharSchemaImporterExtension

Класс TypeNVarCharSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeNVarCharSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeRealSchemaImporterExtension

Класс TypeRealSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeRealSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeSmallDateTimeSchemaImporterExtension

Класс TypeSmallDateTimeSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeSmallDateTimeSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeSmallIntSchemaImporterExtension

Класс TypeSmallIntSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeSmallIntSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeSmallMoneySchemaImporterExtension

Класс TypeSmallMoneySchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeSmallMoneySchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeTextSchemaImporterExtension

Класс TypeTextSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeTextSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeTinyIntSchemaImporterExtension

Класс TypeTinyIntSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeTinyIntSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeUniqueIdentifierSchemaImporterExtension

Класс TypeUniqueIdentifierSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeUniqueIdentifierSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeVarBinarySchemaImporterExtension

Класс TypeVarBinarySchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeVarBinarySchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeVarCharSchemaImporterExtension

Класс TypeVarCharSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeVarCharSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

TypeVarImageSchemaImporterExtension

Класс TypeVarImageSchemaImporterExtension предназначен для использования не в качестве самостоятельного компонента, а в качестве базового класса, от которого другие классы наследуют стандартные функциональные возможности.The TypeVarImageSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

Структуры

SqlBinary

Представляет поток двоичных данных переменной длины, сохраняемый в базе данных или извлекаемый из нее.Represents a variable-length stream of binary data to be stored in or retrieved from a database.

SqlBoolean

Представляет целое значение 1 или 0, сохраняемое в базе данных или извлекаемое из нее.Represents an integer value that is either 1 or 0 to be stored in or retrieved from a database.

SqlByte

Представляет 8-разрядное целое число без знака в диапазоне от 0 до 255, сохраняемое в базе данных или извлекаемое из нее.Represents an 8-bit unsigned integer, in the range of 0 through 255, to be stored in or retrieved from a database.

SqlDateTime

Представляет сохраняемые в базе данных или извлекаемые из нее данные о дате и времени в диапазоне значений от 1 января 1753 г. до 31 декабря 9999 г. с точностью 3,33 миллисекунды.Represents the date and time data ranging in value from January 1, 1753 to December 31, 9999 to an accuracy of 3.33 milliseconds to be stored in or retrieved from a database. Базовая структура данных структуры SqlDateTime отличается от соответствующего типа платформы .NET Framework, DateTime, который может представлять любое время между 00:00:00 01.01.0001 и 23:59:59 31.12.9999 с точностью 100 наносекунд.The SqlDateTime structure has a different underlying data structure from its corresponding .NET Framework type, DateTime, which can represent any time between 12:00:00 AM 1/1/0001 and 11:59:59 PM 12/31/9999, to the accuracy of 100 nanoseconds. В объекте SqlDateTime фактически хранится разница относительно 00:00:00 01.01.1900.SqlDateTime actually stores the relative difference to 00:00:00 AM 1/1/1900. Поэтому в результате преобразования "00:00:00 01.01.1900" в целое число будет возвращен 0.Therefore, a conversion from "00:00:00 AM 1/1/1900" to an integer will return 0.

SqlDecimal

Представляет числовое значение с фиксированной точностью и масштабом в диапазоне от - 10^38 +1 и 10^38 - 1.Represents a numeric value between - 10^38 +1 and 10^38 - 1, with fixed precision and scale.

SqlDouble

Представляет число с плавающей запятой в диапазоне от -1,79E + 308 до 1,79E + 308, сохраняемое в базе данных или извлекаемое из нее.Represents a floating-point number within the range of -1.79E +308 through 1.79E +308 to be stored in or retrieved from a database.

SqlGuid

Представляет код GUID, сохраняемый в базе данных или извлекаемый из нее.Represents a GUID to be stored in or retrieved from a database.

SqlInt16

Представляет 16-разрядное целое число со знаком, сохраняемое в базе данных или извлекаемое из нее.Represents a 16-bit signed integer to be stored in or retrieved from a database.

SqlInt32

Представляет 32-разрядное целое число со знаком, сохраняемое в базе данных или извлекаемое из нее.Represents a 32-bit signed integer to be stored in or retrieved from a database.

SqlInt64

Представляет 64-разрядное целое число со знаком, сохраняемое в базе данных или извлекаемое из нее.Represents a 64-bit signed integer to be stored in or retrieved from a database.

SqlMoney

Представляет значение валюты в диапазоне от –2 63 (или –922 337 203 685 477,5808) до 2 63 –1 (или +922 337 203 685 477,5807) с точностью до десятитысячных единицы валюты, сохраняемое в базе данных или извлекаемое из нее.Represents a currency value ranging from -2 63 (or -922,337,203,685,477.5808) to 2 63 -1 (or +922,337,203,685,477.5807) with an accuracy to a ten-thousandth of currency unit to be stored in or retrieved from a database.

SqlSingle

Представляет число с плавающей запятой в диапазоне от -3,40E +38 до 3,40E +38, сохраняемое в базе данных или извлекаемое из нее.Represents a floating point number within the range of -3.40E +38 through 3.40E +38 to be stored in or retrieved from a database.

SqlString

Представляет поток символов переменной длины, сохраняемый в базе данных или извлекаемый из нее.Represents a variable-length stream of characters to be stored in or retrieved from the database. SqlString имеет базовую структуру данных, отличную от соответствующего типа данных String платформы .NET Framework.SqlString has a different underlying data structure from its corresponding .NET Framework String data type.

Интерфейсы

INullable

Во всех объектах и структурах System.Data.SqlTypes реализован интерфейс INullable.All the System.Data.SqlTypes objects and structures implement the INullable interface.

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

SqlCompareOptions

Задает значения параметров сравнения для структуры SqlString.Specifies the compare option values for a SqlString structure.

StorageState

Перечисление StorageState не предназначено для использования в качестве самостоятельного компонента; оно является перечислением, от которого другие классы наследуют стандартные функциональные возможности.The StorageState enumeration is not intended for use as a stand-alone component, but as an enumeration from which other classes derive standard functionality.

Комментарии

Каждому типу данных в SqlTypes имеет эквивалентный тип данных в SQL Server с аналогичным базовым представлением данных.Each data type in SqlTypes has its equivalent data type in SQL Server, with the same underlying data representation. Многие из них также имеют эквивалентные типы данных в среде CLR.Many of them also have equivalent data types in the CLR. Тем не менее SqlDateTime, SqlDecimal, и SqlString у разных базовых структур данных в соответствующие им типы данных .NET Framework.However, SqlDateTime, SqlDecimal, and SqlString have different underlying data structures with their corresponding .NET Framework data types.

В следующей таблице сопоставлены члены SqlTypes пространство имен для типов данных Microsoft SQL Server и членами SqlDbType перечисления.The following table maps the members of the SqlTypes namespace to Microsoft SQL Server data types and to the members of the SqlDbType enumeration.

.NET framework SqlTypes.NET Framework SqlTypes Собственный SQL ServerNative SQL Server .NET framework SqlDbType.NET Framework SqlDbType
SqlBinary Binary, image, timestamp, varbinarybinary, image, timestamp, varbinary Двоичные данные, изображения, TimeStamp, VarBinaryBinary, Image, TimeStamp, VarBinary
SqlBoolean bitbit РазрядBit
SqlByte tinyinttinyint TinyIntTinyInt
SqlBytes Binary, image, timestamp, varbinarybinary, image, timestamp, varbinary Двоичные данные, изображения, TimeStamp, VarBinaryBinary, Image, TimeStamp, VarBinary
SqlChars char, nchar, text, ntext, nvarchar, varcharchar, nchar, text, ntext, nvarchar, varchar Char, NChar, Text, Ntext, NVarChar, VarCharChar, NChar, Text, Ntext, NVarChar, VarChar
SqlDateTime DateTime, smalldatetimedatetime, smalldatetime DateTime, SmallDateTimeDateTime, SmallDateTime
SqlDecimal Числовой, десятичныйnumeric, decimal Десятичное числоDecimal
SqlDouble floatfloat FloatFloat
SqlFileStream varbinaryvarbinary VarBinaryVarBinary
SqlGuid uniqueidentifieruniqueidentifier UniqueIdentifierUniqueIdentifier
SqlInt16 smallintsmallint SmallIntSmallInt
SqlInt32 intint IntInt
SqlInt64 bigintbigint BigIntBigInt
SqlMoney Money, smallmoney.money, smallmoney Money, SmallMoney.Money, SmallMoney
SqlSingle действительныеreal RealReal
SqlString char, nchar, text, ntext, nvarchar, varcharchar, nchar, text, ntext, nvarchar, varchar Char, NChar, Text, Ntext, NVarChar, VarCharChar, NChar, Text, Ntext, NVarChar, VarChar
SqlXml xmlxml XmlXml