System.Data.SqlTypes 네임스페이스

SQL Server의 원시 데이터 형식에 대한 클래스를 제공합니다. 이러한 클래스는 .NET Framework CLR(공용 언어 런타임)에서 제공하는 데이터 형식보다 안전하고 빠른 데이터 형식을 제공합니다. 이 네임스페이스의 클래스를 사용하면 정밀도 손실로 인한 형식 변환 오류를 방지하는 데 도움이 됩니다. 다른 데이터 형식과 SqlTypes 간의 변환이 자동으로 발생하기 때문에 이 네임스페이스에 있는 개체를 명시적으로 만들어 사용하면 처리 속도가 빠른 코드도 생성됩니다.

클래스

SqlAlreadyFilledException	SqlAlreadyFilledException 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
SqlBytes	Buffer 또는 Stream을 래핑하는 변경 가능한 참조 형식을 나타냅니다.
SqlChars	SqlChars는 Char 배열 또는 SqlString 인스턴스를 래핑하는 변경 가능한 참조 형식입니다.
SqlNotFilledException	SqlNotFilledException 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
SqlNullValueException	System.Data.SqlTypes 구조체의 Value 속성이 null로 설정된 경우 throw되는 예외입니다.
SqlTruncateException	System.Data.SqlTypes 구조체에 값을 설정할 경우 이 값이 잘릴 때 throw되는 예외입니다.
SqlTypeException	System.Data.SqlTypes의 기본 예외 클래스입니다.
SqlXml	서버에서 저장하거나 검색할 XML 데이터를 나타냅니다.

구조체

SqlBinary	데이터베이스에서 저장하거나 검색할 이진 데이터의 가변 길이 스트림을 나타냅니다.
SqlBoolean	데이터베이스에서 저장하거나 검색할 정수 값(0 또는 1)을 나타냅니다.
SqlByte	데이터베이스에서 저장하거나 검색할 8비트 부호 없는 정수를 나타내며, 값 범위는 0 ~ 255입니다.
SqlDateTime	데이터베이스에서 검색할 날짜와 시간 데이터(1753년 1월 1일~9999년 12월 31)를 3.33밀리초의 정밀도로 나타냅니다. SqlDateTime 구조체는 해당하는 .NET 형식인 DateTime과는 다른 내부 데이터 구조를 갖습니다. .NET 형식은 12:00:00 AM(0001년 1월 1일)부터 11:59:59 PM(9999년 12월 31일)까지의 모든 시간을 100나노초의 정밀도로 나타낼 수 있습니다. SqlDateTime은 실제로 00:00:00 AM(1900년 1월 1일)을 기준으로 상대적 차이를 저장합니다. 그러므로 "00:00:00 AM(1900년 1월 1일)"을 정수로 변환하면 0이 반환됩니다.
SqlDecimal	전체 자릿수와 소수 자릿수가 고정된 - 10^38 + 1부터 10^38 - 1까지의 숫자 값을 나타냅니다.
SqlDouble	데이터베이스에서 저장하거나 검색할 부동 소수점 숫자를 나타내며, 값 범위는 -1.79E +308 ~ 1.79E +308입니다.
SqlGuid	데이터베이스에서 저장하거나 검색할 GUID를 나타냅니다.
SqlInt16	데이터베이스에서 저장하거나 검색할 16비트 부호 있는 정수를 나타냅니다.
SqlInt32	데이터베이스에서 저장하거나 검색할 32비트 부호 있는 정수를 나타냅니다.
SqlInt64	데이터베이스에서 저장하거나 검색할 64비트 부호 있는 정수를 나타냅니다.
SqlMoney	데이터베이스에서 저장하거나 검색할 통화 단위를 1/10,000의 정밀도로 나타내며, 통화 값 범위는 -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의 기본 데이터 구조는 해당하는 .NET String 데이터 형식과 다릅니다.

인터페이스

INullable

모든 System.Data.SqlTypes 개체 및 구조체는 INullable 인터페이스를 구현합니다.

열거형

SqlCompareOptions	SqlString 구조체의 비교 옵션 값을 지정합니다.
StorageState	StorageState 열거형은 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 열거형으로만 사용할 수 있습니다.

설명

SqlTypes의 각 데이터 형식은 동일한 기본 데이터 표현을 사용하여 SQL Server 동일한 데이터 형식을 가합니다. 이들 중 상당수는 CLR에 동일한 데이터 형식도 있습니다. 그러나 SqlDateTime, SqlDecimal 및 SqlString에는 해당 .NET Framework 데이터 형식과 다른 기본 데이터 구조가 있습니다.

다음 표에서는 SqlTypes 네임스페이스의 멤버를 Microsoft SQL Server 데이터 형식 및 열거형의 멤버에 SqlDbType 매핑합니다.

sqlTypes .NET Framework	네이티브 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

추가 정보

• SQL Server 데이터 형식 매핑(ADO.NET)
• SQL Server 데이터 형식 및 ADO.NET