다음을 통해 공유

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

SqlBinary

binary, image, timestamp, varbinary

Binary, Image, TimeStamp, VarBinary

SqlBoolean

bit

Bit

SqlByte

tinyint

TinyInt

SqlDateTime

datetime, smalldatetime

DateTime, SmallDateTime

SqlDecimal

numeric, decimal

Numeric, Decimal

SqlDouble

float

Float

SqlGuid

uniqueidentifier

UniqueId

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

클래스

  클래스 설명
Public class SqlAlreadyFilledException SqlAlreadyFilledException 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class SqlBytes Buffer 또는 Stream을 래핑하는 변경 가능한 참조 형식을 나타냅니다.
Public class SqlChars SqlChars는 Char 배열 또는 SqlString 인스턴스를 래핑하는 변경 가능한 참조 형식입니다.
Public class SqlNotFilledException SqlNotFilledException 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class SqlNullValueException System.Data.SqlTypes 구조체의 Value 속성이 null로 설정되어 있을 때 throw되는 예외입니다.
Public class SqlTruncateException System.Data.SqlTypes 구조체에 값을 설정할 경우 이 값이 잘릴 때 throw되는 예외입니다.
Public class SqlTypeException System.Data.SqlTypes의 기본 예외 클래스입니다.
Public class SqlTypesSchemaImporterExtensionHelper SqlTypesSchemaImporterExtensionHelper 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class SqlXml 서버에서 저장하거나 검색할 XML 데이터를 나타냅니다.
Public class TypeBigIntSchemaImporterExtension TypeBigIntSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeBinarySchemaImporterExtension TypeBinarySchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeBitSchemaImporterExtension TypeBitSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeCharSchemaImporterExtension TypeCharSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeDateTimeSchemaImporterExtension TypeDateTimeSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeDecimalSchemaImporterExtension TypeDecimalSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeFloatSchemaImporterExtension TypeFloatSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeIntSchemaImporterExtension TypeIntSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeMoneySchemaImporterExtension TypeMoneySchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeNCharSchemaImporterExtension TypeNCharSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeNTextSchemaImporterExtension TypeNTextSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeNumericSchemaImporterExtension TypeNumericSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeNVarCharSchemaImporterExtension TypeNVarCharSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeRealSchemaImporterExtension TypeRealSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeSmallDateTimeSchemaImporterExtension TypeSmallDateTimeSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용하지 않고 다른 클래스에 표준 기능을 파생시키는 원본 클래스로 사용합니다.
Public class TypeSmallIntSchemaImporterExtension TypeSmallIntSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeSmallMoneySchemaImporterExtension TypeSmallMoneySchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeTextSchemaImporterExtension TypeTextSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeTinyIntSchemaImporterExtension TypeTinyIntSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeUniqueIdentifierSchemaImporterExtension TypeUniqueIdentifierSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeVarBinarySchemaImporterExtension TypeVarBinarySchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeVarCharSchemaImporterExtension TypeVarCharSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.
Public class TypeVarImageSchemaImporterExtension TypeVarImageSchemaImporterExtension 클래스는 독립 실행형 구성 요소로는 사용할 수 없고 다른 클래스가 표준 기능을 파생하는 원본 클래스로만 사용할 수 있습니다.

인터페이스

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

구조체

  구조체 설명
Public structure SqlBinary 데이터베이스에서 저장하거나 검색할 이진 데이터의 가변 길이 스트림을 나타냅니다.
Public structure SqlBoolean 데이터베이스에서 저장하거나 검색할 정수 값(0 또는 1)을 나타냅니다.
Public structure SqlByte 데이터베이스에서 저장하거나 검색할 8비트 부호 없는 정수를 나타내며, 값 범위는 0 ~ 255입니다.
Public structure 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이 반환됩니다.
Public structure SqlDecimal 전체 자릿수와 소수 자릿수가 고정된 - 10^38 + 1부터 10^38 - 1까지의 숫자 값을 나타냅니다.
Public structure SqlDouble 데이터베이스에서 저장하거나 검색할 부동 소수점 숫자를 나타내며, 값 범위는 -1.79E +308 ~ 1.79E +308입니다.
Public structure SqlGuid 데이터베이스에서 저장하거나 검색할 GUID를 나타냅니다.
Public structure SqlInt16 데이터베이스에서 저장하거나 검색할 16비트 부호 있는 정수를 나타냅니다.
Public structure SqlInt32 데이터베이스에서 저장하거나 검색할 32비트 부호 있는 정수를 나타냅니다.
Public structure SqlInt64 데이터베이스에서 저장하거나 검색할 64비트 부호 있는 정수를 나타냅니다.
Public structure SqlMoney 데이터베이스에서 저장하거나 검색할 통화 단위를 1/10,000의 정밀도로 나타내며, 통화 값 범위는 -2 63 (-922,337,203,685,477.5808) ~ 2 63 -1(+922,337,203,685,477.5807)입니다.
Public structure SqlSingle 데이터베이스에서 저장하거나 검색할 부동 소수점 숫자를 나타내며, 값 범위는 -3.40E +38 ~ 3.40E +38입니다.
Public structure SqlString 데이터베이스에서 저장하거나 검색할 문자의 가변 길이 스트림을 나타냅니다. SqlString에는 해당 .NET Framework String 데이터 형식의 다양한 내부 데이터 구조가 있습니다. String은 항상 현재 스레드의 기본 CultureInfo를 사용하지만 SqlString은 고유한 로캘 ID를 포함하며 플래그를 비교합니다. 두 SqlString 구조체의 비교 결과는 운영 체제 및 현재 스레드 로캘과 관련이 없습니다.

열거형

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