SqlMetaData 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
SqlDataRecord 개체의 매개 변수와 열에서 메타데이터 정보를 지정하고 검색합니다. 이 클래스는 상속될 수 없습니다.
public ref class SqlMetaData sealedpublic sealed class SqlMetaDatatype SqlMetaData = classPublic NotInheritable Class SqlMetaData- 상속
-
SqlMetaData
예제
다음 예제에서는 레코드의 열 메타데이터를 설명하는 여러 SqlMetaData 개체를 만들고 를 만드는 방법을 보여 주었습니다 SqlDataRecord. 의 SqlDataRecord 열 값이 설정되고 SqlDataRecord 는 클래스를 사용하여 SqlContext 호출 프로그램으로 전송됩니다.
[Microsoft.SqlServer.Server.SqlProcedure]
public static void CreateNewRecord()
{
// Variables.
SqlMetaData column1Info;
SqlMetaData column2Info;
SqlMetaData column3Info;
SqlDataRecord record;
// Create the column metadata.
column1Info = new SqlMetaData("Column1", SqlDbType.NVarChar, 12);
column2Info = new SqlMetaData("Column2", SqlDbType.Int);
column3Info = new SqlMetaData("Column3", SqlDbType.DateTime);
// Create a new record with the column metadata.
record = new SqlDataRecord(new SqlMetaData[] { column1Info,
column2Info,
column3Info });
// Set the record fields.
record.SetString(0, "Hello World!");
record.SetInt32(1, 42);
record.SetDateTime(2, DateTime.Now);
// Send the record to the calling program.
SqlContext.Pipe.Send(record);
}
<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub CreateNewRecord()
' Variables.
Dim column1Info As SqlMetaData
Dim column2Info As SqlMetaData
Dim column3Info As SqlMetaData
Dim record As SqlDataRecord
' Create the column metadata.
column1Info = new SqlMetaData("Column1", SqlDbType.NVarChar, 12)
column2Info = new SqlMetaData("Column2", SqlDbType.Int)
column3Info = new SqlMetaData("Column3", SqlDbType.DateTime)
' Create a new record with the column metadata.
record = new SqlDataRecord(new SqlMetaData() { column1Info, _
column2Info, _
column3Info })
' Set the record fields.
record.SetString(0, "Hello World!")
record.SetInt32(1, 42)
record.SetDateTime(2, DateTime.Now)
' Send the record to the calling program.
SqlContext.Pipe.Send(record)
End Sub
생성자
| SqlMetaData(String, SqlDbType) |
지정한 열 이름과 형식을 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. |
| SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32) |
지정한 열 이름과 기본 서버를 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. 이러한 생성자 형식은 열이 테이블 반환 매개 변수, 열의 정렬 순서 및 정렬 열의 서수에서 고유한지 여부를 지정할 수 있도록 허용함으로써 테이블 반환 매개 변수를 지원합니다. |
| SqlMetaData(String, SqlDbType, Byte, Byte) |
지정한 열 이름, 형식, 전체 자릿수 및 소수 자릿수를 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. |
| SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32) |
지정한 열 이름, 형식, 전체 자릿수, 소수 자릿수 및 서버 기본값을 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. 이러한 생성자 형식은 열이 테이블 반환 매개 변수, 열의 정렬 순서 및 정렬 열의 서수에서 고유한지 여부를 지정할 수 있도록 허용함으로써 테이블 반환 매개 변수를 지원합니다. |
| SqlMetaData(String, SqlDbType, Int64) |
지정한 열 이름, 형식 및 최대 길이를 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. |
| SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32) |
지정한 열 이름, 형식, 최대 길이 및 서버 기본값을 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. 이러한 생성자 형식은 열이 테이블 반환 매개 변수, 열의 정렬 순서 및 정렬 열의 서수에서 고유한지 여부를 지정할 수 있도록 허용함으로써 테이블 반환 매개 변수를 지원합니다. |
| SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type) |
지정한 열 이름, 형식, 최대 길이, 전체 자릿수, 소수 자릿수, 로캘 ID, 비교 옵션 및 UDT(사용자 정의 형식)를 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. |
| SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32) |
지정한 열 이름, 형식, 최대 길이, 전체 자릿수, 소수 자릿수, 로캘 ID, 비교 옵션 및 UDT(사용자 정의 형식)를 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. 이러한 생성자 형식은 열이 테이블 반환 매개 변수, 열의 정렬 순서 및 정렬 열의 서수에서 고유한지 여부를 지정할 수 있도록 허용함으로써 테이블 반환 매개 변수를 지원합니다. |
| SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions) |
지정한 열 이름, 형식, 최대 길이, 로캘 및 비교 옵션을 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. |
| SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32) |
지정한 열 이름, 형식, 최대 길이, 로캘, 비교 옵션 및 서버 기본값을 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. 이러한 생성자 형식은 열이 테이블 반환 매개 변수, 열의 정렬 순서 및 정렬 열의 서수에서 고유한지 여부를 지정할 수 있도록 허용함으로써 테이블 반환 매개 변수를 지원합니다. |
| SqlMetaData(String, SqlDbType, String, String, String) |
지정한 열 이름, 형식, 데이터베이스 이름, 소유하는 스키마 및 개체 이름을 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. |
| SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32) |
지정한 열 이름, 형식, 데이터베이스 이름, 소유하는 스키마, 개체 이름 및 기본 서버를 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. 이러한 생성자 형식은 열이 테이블 반환 매개 변수, 열의 정렬 순서 및 정렬 열의 서수에서 고유한지 여부를 지정할 수 있도록 허용함으로써 테이블 반환 매개 변수를 지원합니다. |
| SqlMetaData(String, SqlDbType, Type) |
지정한 열 이름, 형식 및 UDT(사용자 정의 형식)를 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. |
| SqlMetaData(String, SqlDbType, Type, String) |
지정한 열 이름, UDT(사용자 정의 형식) 및 SQLServer 형식을 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. |
| SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32) |
지정한 열 이름, 형식, 사용자 정의 형식, SQLServer 형식 및 서버 기본값을 사용하여 SqlMetaData 클래스의 새 인스턴스를 초기화합니다. 이러한 생성자 형식은 열이 테이블 반환 매개 변수, 열의 정렬 순서 및 정렬 열의 서수에서 고유한지 여부를 지정할 수 있도록 허용함으로써 테이블 반환 매개 변수를 지원합니다. |
속성
| CompareOptions |
열 또는 매개 변수에 사용되는 비교 규칙을 가져옵니다. |
| DbType |
열 또는 매개 변수의 데이터 형식을 가져옵니다. |
| IsUniqueKey |
테이블 반환 매개 변수의 열이 고유한지 여부를 나타냅니다. |
| LocaleId |
열 또는 매개 변수의 로캘 ID를 가져옵니다. |
| Max |
|
| MaxLength |
열 또는 매개 변수의 최대 길이를 가져옵니다. |
| Name |
열 또는 매개 변수의 이름을 가져옵니다. |
| Precision |
열 또는 매개 변수의 전체 자릿수를 가져옵니다. |
| Scale |
열 또는 매개 변수의 소수 자릿수를 가져옵니다. |
| SortOrder |
열의 정렬 순서를 반환합니다. |
| SortOrdinal |
정렬 열의 서수를 반환합니다. |
| SqlDbType |
열 또는 매개 변수의 데이터 형식을 가져옵니다. |
| Type |
UDT(사용자 정의 형식)의 CLR(공용 언어 런타임) 형식을 가져옵니다. |
| TypeName |
인스턴스에 표시되는 UDT(사용자 정의 형식) 또는 SQL Server 형식의 세 부분으로 구성된 이름을 가져옵니다. |
| UseServerDefault |
이 열에서 기본 서버 값을 사용해야 하는지 여부를 보고합니다. |
| XmlSchemaCollectionDatabase |
이 XML 인스턴스의 스키마 컬렉션이 있는 데이터베이스의 이름을 가져옵니다. |
| XmlSchemaCollectionName |
이 XML 인스턴스의 스키마 컬렉션의 이름을 가져옵니다. |
| XmlSchemaCollectionOwningSchema |
이 XML 인스턴스의 스키마 컬렉션이 있는 소유하는 관계형 스키마를 가져옵니다. |
메서드
| Adjust(Boolean) |
메타데이터를 기준으로 지정한 Boolean 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Byte) |
메타데이터를 기준으로 지정한 Byte 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Byte[]) |
메타데이터를 기준으로 지정한 Byte 값 배열의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Char) |
메타데이터를 기준으로 지정한 Char 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Char[]) |
메타데이터를 기준으로 지정한 Char 값 배열의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(DateTime) |
메타데이터를 기준으로 지정한 DateTime 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(DateTimeOffset) |
메타데이터를 기준으로 지정한 DateTimeOffset 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Decimal) |
메타데이터를 기준으로 지정한 Decimal 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Double) |
메타데이터를 기준으로 지정한 Double 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Guid) |
메타데이터를 기준으로 지정한 Guid 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Int16) |
메타데이터를 기준으로 지정한 Int16 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Int32) |
메타데이터를 기준으로 지정한 Int32 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Int64) |
메타데이터를 기준으로 지정한 Int64 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Object) |
메타데이터를 기준으로 지정한 Object 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(Single) |
메타데이터를 기준으로 지정한 Single 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlBinary) |
메타데이터를 기준으로 지정한 SqlBinary 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlBoolean) |
메타데이터를 기준으로 지정한 SqlBoolean 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlByte) |
메타데이터를 기준으로 지정한 SqlByte 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlBytes) |
메타데이터를 기준으로 지정한 SqlBytes 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlChars) |
메타데이터를 기준으로 지정한 SqlChars 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlDateTime) |
메타데이터를 기준으로 지정한 SqlDateTime 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlDecimal) |
메타데이터를 기준으로 지정한 SqlDecimal 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlDouble) |
메타데이터를 기준으로 지정한 SqlDouble 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlGuid) |
메타데이터를 기준으로 지정한 SqlGuid 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlInt16) |
메타데이터를 기준으로 지정한 SqlInt16 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlInt32) |
메타데이터를 기준으로 지정한 SqlInt32 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlInt64) |
메타데이터를 기준으로 지정한 SqlInt64 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlMoney) |
메타데이터를 기준으로 지정한 SqlMoney 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlSingle) |
메타데이터를 기준으로 지정한 SqlSingle 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlString) |
메타데이터를 기준으로 지정한 SqlString 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(SqlXml) |
메타데이터를 기준으로 지정한 SqlXml 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(String) |
메타데이터를 기준으로 지정한 String 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| Adjust(TimeSpan) |
메타데이터를 기준으로 지정한 TimeSpan 값의 유효성을 검사하고 필요한 경우 이 값을 조정합니다. |
| InferFromValue(Object, String) |
지정한 개체에서 메타데이터를 유추하고 SqlMetaData 인스턴스로 반환합니다. |