System.Data.SqlTypes Namespace

O namespace System.Data.SqlTypes fornece classes para tipos de dados nativos no SQL Server. The System.Data.SqlTypes namespace provides classes for native data types in SQL Server. Essas classes fornecem uma alternativa mais segura e mais rápida aos tipos de dados fornecidos pelo CLR (Common Language Runtime) do .NET Framework. These classes provide a safer, faster alternative to the data types provided by the .NET Framework common language runtime (CLR). Usar as classes nesse namespace ajuda a evitar erros de conversão de tipo causados por perda de precisão. Using the classes in this namespace helps prevent type conversion errors caused by loss of precision. Uma vez que outros tipos de dados são convertidos para e de SqlTypes em segundo plano, criar e usar explicitamente objetos nesse namespace também produz código mais rápido. 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.

Classes

SqlAlreadyFilledException

A classe SqlAlreadyFilledException não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

Representa um tipo de referência mutável que encapsula um Buffer ou Stream.Represents a mutable reference type that wraps either a Buffer or a Stream.

SqlChars

SqlChars é um tipo de referência mutável que encapsula uma matriz Char ou uma instância SqlString.SqlChars is a mutable reference type that wraps a Char array or a SqlString instance.

SqlFileStream

Expõe dados do SQL Server que são armazenados com o atributo de coluna FILESTREAM como uma sequência de bytes.Exposes SQL Server data that is stored with the FILESTREAM column attribute as a sequence of bytes.

SqlNotFilledException

A classe SqlNotFilledException não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A exceção lançada quando a propriedade Value de uma estrutura System.Data.SqlTypes é definida como nula.The exception that is thrown when the Value property of a System.Data.SqlTypes structure is set to null.

SqlTruncateException

A exceção gerada ao definir um valor em uma estrutura System.Data.SqlTypes truncaria esse valor.The exception that is thrown when you set a value into a System.Data.SqlTypes structure would truncate that value.

SqlTypeException

A classe de exceção base de System.Data.SqlTypes.The base exception class for the System.Data.SqlTypes.

SqlTypesSchemaImporterExtensionHelper

A classe SqlTypesSchemaImporterExtensionHelper não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

Representa dados XML armazenados ou recuperados de um servidor.Represents XML data stored in or retrieved from a server.

TypeBigIntSchemaImporterExtension

A classe TypeBigIntSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeBinarySchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeBitSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeCharSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeDateTimeSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeDecimalSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeFloatSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeIntSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeMoneySchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeNCharSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeNTextSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeNumericSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeNVarCharSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeRealSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeSmallDateTimeSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeSmallIntSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeSmallMoneySchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeTextSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeTinyIntSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeUniqueIdentifierSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeVarBinarySchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeVarCharSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.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

A classe TypeVarImageSchemaImporterExtension não foi planejada para uso como um componente autônomo, mas como uma classe da qual outras classes derivam a funcionalidade padrão.The TypeVarImageSchemaImporterExtension class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.

Estruturas

SqlBinary

Representa um fluxo de tamanho variável de dados binários a ser armazenado ou recuperado de um banco de dados.Represents a variable-length stream of binary data to be stored in or retrieved from a database.

SqlBoolean

Representa um valor inteiro que é 1 ou 0 a ser armazenado no banco de dados ou recuperado do banco de dados.Represents an integer value that is either 1 or 0 to be stored in or retrieved from a database.

SqlByte

Representa um inteiro sem sinal de 8 bits, no intervalo de 0 a 255, para ser armazenado no recuperado de um banco de dados.Represents an 8-bit unsigned integer, in the range of 0 through 255, to be stored in or retrieved from a database.

SqlDateTime

Representa os dados de data e hora cujos valores variam de 1º de janeiro de 1753 e 31 de dezembro de 9999, com uma precisão de 3,33 milissegundos para armazenamento ou recuperação de um banco de dados.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. A estrutura SqlDateTime tem uma estrutura de dados subjacente diferente de seu tipo .NET Framework correspondente, DateTime, que pode representar qualquer hora entre 12:00:00 1/1/0001 e 23:59:59 31/12/9999, com precisão de 100 nanossegundos.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. Na verdade, SqlDateTime armazena a diferença relativa a 00:00:00 1/1/1900.SqlDateTime actually stores the relative difference to 00:00:00 AM 1/1/1900. Portanto, uma conversão de "00:00:00 1/1/1900" para um número inteiro retornará 0.Therefore, a conversion from "00:00:00 AM 1/1/1900" to an integer will return 0.

SqlDecimal

Representa um valor numérico entre -10^38 +1 e 10^38 - 1, com precisão e escala fixas.Represents a numeric value between - 10^38 +1 and 10^38 - 1, with fixed precision and scale.

SqlDouble

Representa um número de ponto flutuante no intervalo de -1,79E +308 a 1,79E +308 a ser armazenado ou recuperado de um banco de dados.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

Representa um GUID a ser armazenado ou recuperado de um banco de dados.Represents a GUID to be stored in or retrieved from a database.

SqlInt16

Representa um inteiro com sinal de 16 bits a ser armazenado ou recuperado de um banco de dados.Represents a 16-bit signed integer to be stored in or retrieved from a database.

SqlInt32

Representa um inteiro com sinal de 32 bits a ser armazenado ou recuperado de um banco de dados.Represents a 32-bit signed integer to be stored in or retrieved from a database.

SqlInt64

Representa um inteiro com sinal de 64 bits a ser armazenado ou recuperado de um banco de dados.Represents a 64-bit signed integer to be stored in or retrieved from a database.

SqlMoney

Representa um valor de moeda que vai de -2 63 (ou -922.337.203.685.477,5808) a 2 63 -1 (ou +922.337.203.685.477,5807), com uma precisão de dez milésimos de uma unidade monetária, que será armazenado ou recuperado de um banco de dados.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

Representa um número de ponto flutuante no intervalo de -3,40E +38 a 3,40E +38 a ser armazenado ou recuperado de um banco de dados.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

Representa um fluxo de tamanho variável de caracteres a ser armazenado ou recuperado do banco de dados.Represents a variable-length stream of characters to be stored in or retrieved from the database. SqlString tem uma estrutura de dados subjacente diferente de seu correspondente do tipo de dados String .NET Framework.SqlString has a different underlying data structure from its corresponding .NET Framework String data type.

Interfaces

INullable

Todos os objetos e todas as estruturas System.Data.SqlTypes implementam a interface INullable.All the System.Data.SqlTypes objects and structures implement the INullable interface.

Enumerações

SqlCompareOptions

Especifica os valores da opção de comparação de uma estrutura SqlString.Specifies the compare option values for a SqlString structure.

StorageState

A enumeração StorageState não foi planejada para uso como um componente autônomo, mas como uma enumeração da qual outras classes derivam a funcionalidade padrão.The StorageState enumeration is not intended for use as a stand-alone component, but as an enumeration from which other classes derive standard functionality.

Comentários

Cada tipo de dados no SqlTypes tem seu tipo de dados equivalente no SQL Server, com a mesma representação de dados subjacente.Each data type in SqlTypes has its equivalent data type in SQL Server, with the same underlying data representation. Muitos deles também têm tipos de dados equivalente no CLR.Many of them also have equivalent data types in the CLR. No entanto, SqlDateTime, SqlDecimal, e SqlString têm diferentes estruturas de dados subjacentes com seus tipos de dados .NET Framework correspondentes.However, SqlDateTime, SqlDecimal, and SqlString have different underlying data structures with their corresponding .NET Framework data types.

A tabela a seguir mapeia os membros do SqlTypes namespace para tipos de dados do Microsoft SQL Server e aos membros do SqlDbType enumeração.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 Nativo do SQL ServerNative SQL Server SqlDbType do .NET framework.NET Framework SqlDbType
SqlBinary Binary, image, timestamp, varbinarybinary, image, timestamp, varbinary Binary, Image, TimeStamp, VarBinaryBinary, Image, TimeStamp, VarBinary
SqlBoolean bitbit BitBit
SqlByte tinyinttinyint TinyIntTinyInt
SqlBytes Binary, image, timestamp, varbinarybinary, image, timestamp, varbinary Binary, Image, 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, decimalnumeric, decimal DecimalDecimal
SqlDouble floatfloat FloatFloat
SqlFileStream varbinaryvarbinary VarBinaryVarBinary
SqlGuid uniqueidentifieruniqueidentifier UniqueIdentifierUniqueIdentifier
SqlInt16 smallintsmallint SmallIntSmallInt
SqlInt32 intint intInt
SqlInt64 bigintbigint BigIntBigInt
SqlMoney Money, smallmoneymoney, smallmoney Money, SmallMoneyMoney, SmallMoney
SqlSingle realreal 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

Veja também