System.Data.SqlTypes 네임스페이스
System.Data.SqlTypes 네임스페이스는 SQL Server 2005의 네이티브 데이터 형식에 대한 클래스를 제공합니다. 이러한 클래스는 .NET Framework CLR(공용 언어 런타임)에서 제공하는 데이터 형식보다 안전하고 빠른 데이터 형식을 제공합니다. 이 네임스페이스의 클래스를 사용하면 정밀도 손실로 인한 형식 변환 오류를 방지하는 데 도움이 됩니다. 다른 데이터 형식과 SqlTypes 간의 변환이 자동으로 발생하기 때문에 이 네임스페이스에 있는 개체를 명시적으로 만들어 사용하면 처리 속도가 빠른 코드도 생성됩니다.
SqlTypes의 각 데이터 형식에 해당하는 데이터 형식이 SQL Server 2005에 있으며 내부 데이터 표현도 동일합니다. 또한 SqlTypes의 각 데이터 형식에 해당하는 데이터 형식이 CLR에도 대부분 있습니다. 그러나 SqlDateTime, SqlDecimal 및 SqlString은 해당하는 .NET Framework 데이터 형식과 다른 내부 데이터 구조를 갖고 있습니다.
다음 표에서는 SqlTypes 네임스페이스의 멤버를 Microsoft SQL Server 데이터 형식과 SqlDbType 열거형의 멤버로 매핑합니다.
.NET Framework SqlTypes |
네이티브 SQL Server |
.NET Framework SqlDbType |
---|---|---|
binary, image, timestamp, varbinary |
Binary, Image, TimeStamp, VarBinary |
|
bit |
Bit |
|
tinyint |
TinyInt |
|
datetime, smalldatetime |
DateTime, SmallDateTime |
|
numeric, decimal |
Numeric, Decimal |
|
float |
Float |
|
uniqueidentifier |
UniqueId |
|
smallint |
SmallInt |
|
int |
Int |
|
bigint |
BigInt |
|
money, smallmoney |
Money, SmallMoney |
|
real |
Real |
|
char, nchar, text, ntext, nvarchar, varchar |
Char, NChar, Text, Ntext, NVarChar, VarChar |
|
xml |
Xml |
클래스
클래스 | 설명 | |
---|---|---|
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의 기본 예외 클래스입니다. | |
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 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다. |
인터페이스
인터페이스 | 설명 | |
---|---|---|
INullable | 모든 System.Data.SqlTypes 개체 및 구조체는 INullable 인터페이스를 구현합니다. |
구조체
구조체 | 설명 | |
---|---|---|
SqlBinary | 데이터베이스에서 저장하거나 검색할 이진 데이터의 가변 길이 스트림을 나타냅니다. | |
SqlBoolean | 데이터베이스에서 저장하거나 검색할 정수 값(0 또는 1)을 나타냅니다. | |
SqlByte | 데이터베이스에서 저장하거나 검색할 8비트 부호 없는 정수를 나타내며, 값 범위는 0 ~ 255입니다. | |
SqlDateTime | 데이터베이스에서 검색할 날짜와 시간 데이터(1753년 1월 1일~9999년 12월 31)를 3.33밀리초의 정밀도로 나타냅니다. SqlDateTime 구조체는 해당하는 .NET Framework 형식인 DateTime과는 다른 내부 데이터 구조를 갖습니다. .NET Framework 형식은 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 Framework String 데이터 형식의 다양한 내부 데이터 구조가 있습니다. String은 항상 현재 스레드의 기본 CultureInfo를 사용하지만 SqlString은 고유한 로캘 ID를 포함하며 플래그를 비교합니다. 두 SqlString 구조체의 비교 결과는 운영 체제 및 현재 스레드 로캘과 관련이 없습니다. |
열거형
열거형 | 설명 | |
---|---|---|
SqlCompareOptions | SqlString 구조체의 비교 옵션 값을 지정합니다. | |
StorageState | StorageState 열거형은 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 열거형으로만 사용할 수 있습니다. |