System.Data.SqlTypes 네임스페이스
업데이트: 2007년 11월
System.Data.SqlTypes 네임스페이스는 SQL Server에서 네이티브 데이터 형식을 위한 클래스를 제공합니다. 이러한 클래스는 .NET Framework CLR(공용 언어 런타임)에서 제공하는 데이터 형식보다 안전하고 빠른 데이터 형식을 제공합니다. 이 네임스페이스의 클래스를 사용하면 정밀도 손실로 인한 형식 변환 오류를 방지하는 데 도움이 됩니다. 다른 데이터 형식과 SqlTypes 간의 변환이 자동으로 발생하기 때문에 이 네임스페이스에 있는 개체를 명시적으로 만들어 사용하면 처리 속도가 빠른 코드도 생성됩니다.
SqlTypes의 각 데이터 형식에 해당하는 데이터 형식이 SQL Server에 있으며 내부 데이터 표현도 동일합니다. 또한 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 | Decimal | |
float | Float | |
varbinary | VarBinary | |
uniqueidentifier | UniqueIdentifier | |
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 인스턴스를 래핑하는 변경 가능한 참조 형식입니다. |
| SqlFileStream | FILESTREAM 열 특성에 바이트 시쿼스로 저장된 SQL Server 데이터를 노출합니다. |
| 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 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다. |
| 구조체 | 설명 | |
|---|---|---|
| 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 데이터 형식과 다릅니다. |
| 열거형 | 설명 | |
|---|---|---|
| SqlCompareOptions | SqlString 구조체의 비교 옵션 값을 지정합니다. |
| StorageState | StorageState 열거형은 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 열거형으로만 사용할 수 있습니다. |
