SqlMetaData 클래스

정의

네임스페이스:

Microsoft.Data.SqlClient.Server

어셈블리:

Microsoft.Data.SqlClient.dll

Package(패키지):

Microsoft.Data.SqlClient v7.1.0

개체에서 사용하는 SqlDataRecord 열의 메타데이터 정보를 지정합니다. 이 클래스는 상속할 수 없습니다.

public ref class SqlMetaData sealed

public sealed class SqlMetaData

type SqlMetaData = class

Public NotInheritable Class SqlMetaData

상속

Object

SqlMetaData

예제

다음 예제에서는 레코드의 열 메타데이터 및 레코드 스트림 SqlDataRecord 생성을 설명하는 여러 SqlMetaData 개체를 만드는 방법을 보여 주었습니다. 이러한 SqlDataRecord 레코드는 속성에 메서드의 반환 값을 할당하여 테이블 반환 매개 변수로 SQL Server 스트리밍할 Value 수 있습니다.

using System;
using System.Collections.Generic;
using System.Data;
using Microsoft.Data.SqlClient.Server;

public static IEnumerable<SqlDataRecord> ReturnNewRecords()
{
    // 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 fields of the first record and stream it to SQL Server.
    record.SetString(0, "Hello World!");
    record.SetInt32(1, 42);
    record.SetDateTime(2, DateTime.Now);
    yield return record;

    // Set the fields of the second record and stream it to SQL Server.
    record.SetInt32(1, 0);
    yield return record;
}

설명

SqlMetaData인스턴스는 일반적으로 한 번 빌드되고 테이블 반환 매개 변수로 SQL Server 스트리밍되는 많은 SqlDataRecord 개체를 생성하는 데 다시 사용됩니다. 자세한 내용은 Table-Valued 매개 변수를 참조하세요.

생성자

속성	Description
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)	지정된 열 이름과 기본 서버를 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다. 이 형식의 생성자는 테이블 반환 매개 변수에서 열이 고유한지 여부, 열의 정렬 순서 및 정렬 열의 서수를 지정할 수 있도록 하여 테이블 반환 매개 변수를 지원합니다.
SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32)	지정된 열 이름, 형식, 전체 자릿수, 소수 자릿수 및 서버 기본값을 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다. 이 형식의 생성자는 테이블 반환 매개 변수에서 열이 고유한지 여부, 열의 정렬 순서 및 정렬 열의 서수를 지정할 수 있도록 하여 테이블 반환 매개 변수를 지원합니다.
SqlMetaData(String, SqlDbType, Byte, Byte)	지정된 열 이름, 형식, 전체 자릿수 및 소수 자릿수를 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다.
SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)	지정된 열 이름, 형식, 최대 길이 및 서버 기본값을 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다. 이 형식의 생성자는 테이블 반환 매개 변수에서 열이 고유한지 여부, 열의 정렬 순서 및 정렬 열의 서수를 지정할 수 있도록 하여 테이블 반환 매개 변수를 지원합니다.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)	지정된 열 이름, 형식, 최대 길이, 전체 자릿수, 소수 자릿수, 로캘 ID, 비교 옵션 및 UDT(사용자 정의 형식)를 사용하여 클래스의 새 인스턴스 SqlMetaData 를 초기화합니다. 이 형식의 생성자는 테이블 반환 매개 변수에서 열이 고유한지 여부, 열의 정렬 순서 및 정렬 열의 서수를 지정할 수 있도록 하여 테이블 반환 매개 변수를 지원합니다.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)	지정된 열 이름, 형식, 최대 길이, 전체 자릿수, 소수 자릿수, 로캘 ID, 비교 옵션 및 UDT(사용자 정의 형식)를 사용하여 클래스의 새 인스턴스 SqlMetaData 를 초기화합니다.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32)	지정된 열 이름, 형식, 최대 길이, 로캘, 비교 옵션 및 서버 기본값을 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다. 이 형식의 생성자는 테이블 반환 매개 변수에서 열이 고유한지 여부, 열의 정렬 순서 및 정렬 열의 서수를 지정할 수 있도록 하여 테이블 반환 매개 변수를 지원합니다.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)	지정된 열 이름, 형식, 최대 길이, 로캘 및 비교 옵션을 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다.
SqlMetaData(String, SqlDbType, Int64)	지정된 열 이름, 형식 및 최대 길이를 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다.
SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)	지정된 열 이름, 데이터베이스 이름, 소유 스키마, 개체 이름 및 기본 서버를 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다. 이 형식의 생성자는 테이블 반환 매개 변수에서 열이 고유한지 여부, 열의 정렬 순서 및 정렬 열의 서수를 지정할 수 있도록 하여 테이블 반환 매개 변수를 지원합니다.
SqlMetaData(String, SqlDbType, String, String, String)	지정된 열 이름, 형식, 데이터베이스 이름, 소유 스키마 및 개체 이름을 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다.
SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)	지정된 열 이름, 형식, 사용자 정의 형식, SQL Server 형식 및 서버 기본값을 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다. 이 형식의 생성자는 테이블 반환 매개 변수에서 열이 고유한지 여부, 열의 정렬 순서 및 정렬 열의 서수를 지정할 수 있도록 하여 테이블 반환 매개 변수를 지원합니다.
SqlMetaData(String, SqlDbType, Type, String)	지정된 열 이름, UDT(사용자 정의 형식) 및 SQL Server 형식을 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다.
SqlMetaData(String, SqlDbType, Type)	지정된 열 이름, 형식 및 UDT(사용자 정의 형식)를 사용하여 클래스의 SqlMetaData 새 인스턴스를 초기화합니다.
SqlMetaData(String, SqlDbType)	지정된 열 이름 및 형식을 SqlMetaData 사용하여 클래스의 새 인스턴스를 초기화합니다.

속성

속성	Description
CompareOptions	열 또는 매개 변수에 사용되는 비교 규칙을 가져옵니다.
DbType	열 또는 매개 변수의 데이터 형식을 가져옵니다.
IsUniqueKey	테이블 반환 매개 변수의 열이 고유한지 나타냅니다.
LocaleId	열 또는 매개 변수의 로캘 ID를 가져옵니다.
Max	TEXT, NTEXT 및 IMAGE 데이터 형식의 길이를 가져옵니다.
MaxLength	열 또는 매개 변수의 최대 길이를 가져옵니다.
Name	열 또는 매개 변수의 이름을 가져옵니다.
Precision	열 또는 매개 변수의 전체 자릿수를 가져옵니다.
Scale	열 또는 매개 변수의 배율을 가져옵니다.
SortOrder	열의 정렬 순서를 반환합니다.
SortOrdinal	정렬 열의 서수 값을 반환합니다.
SqlDbType	열 또는 매개 변수의 데이터 형식을 가져옵니다.
Type	UDT(사용자 정의 형식)의 CLR(공용 언어 런타임) 형식을 가져옵니다.
TypeName	UDT(사용자 정의 형식) 또는 인스턴스가 나타내는 SQL Server 형식의 세 부분으로 구성된 이름을 가져옵니다.
UseServerDefault	이 열에서 기본 서버 값을 사용해야 하는지 여부를 보고합니다.
XmlSchemaCollectionDatabase	이 XML 인스턴스의 스키마 컬렉션이 있는 데이터베이스의 이름을 가져옵니다.
XmlSchemaCollectionName	이 XML 인스턴스에 대한 스키마 컬렉션의 이름을 가져옵니다.
XmlSchemaCollectionOwningSchema	이 XML 인스턴스의 스키마 컬렉션이 있는 소유 관계형 스키마를 가져옵니다.

메서드

속성	Description
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 반환합니다.