SqlDataRecord 클래스

참조

정의

네임스페이스:: Microsoft.SqlServer.Server

어셈블리:: System.Data.SqlClient.dll

어셈블리:: System.Data.dll

패키지:: System.Data.SqlClient v4.8.5

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

데이터의 단일 행과 해당 메타데이터를 나타냅니다. 이 클래스는 상속될 수 없습니다.

public ref class SqlDataRecord : System::Data::IDataRecord

public class SqlDataRecord : System.Data.IDataRecord

type SqlDataRecord = class
    interface IDataRecord

Public Class SqlDataRecord
Implements IDataRecord

상속: Object
SqlDataRecord

구현: IDataRecord

예제

다음 예제에서는 레코드의 열 메타데이터를 설명하고 를 만드는 여러 SqlMetaData 개체를 만드는 SqlDataRecord방법을 보여줍니다. 의 SqlDataRecord 열 값이 설정되고 는 SqlDataRecord 클래스를 사용하여 SqlContext 호출 프로그램으로 전송됩니다.

[Microsoft.SqlServer.Server.SqlProcedure]
public static void CreateNewRecord()
{

   // Variables.
   SqlDataRecord record;

   // Create a new record with the column metadata. The constructor is
   // able to accept a variable number of parameters.
   record = new SqlDataRecord(new SqlMetaData[] { new SqlMetaData("Column1", SqlDbType.NVarChar, 12),
                                                  new SqlMetaData("Column2", SqlDbType.Int),
                                                  new SqlMetaData("Column3", SqlDbType.DateTime) });

   // 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 record As SqlDataRecord
   
   ' Create a new record with the column metadata.  The constructor is 
   ' able to accept a variable number of parameters.     
   record = New SqlDataRecord(New SqlMetaData() {New SqlMetaData("Column1", SqlDbType.NVarChar, 12), _
                                                 New SqlMetaData("Column2", SqlDbType.Int), _
                                                 New SqlMetaData("Column3", SqlDbType.DateTime)})

   ' 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

설명

이 클래스는 와 SqlPipe 함께 사용하여 관리 코드 저장 프로시저에서 클라이언트로 결과 집합을 보냅니다.

공용 언어 런타임 (CLR) 애플리케이션을 작성할 때 다시 사용할지 기존 SqlDataRecord 때마다 새로 만드는 대신 개체입니다. 많은 새 SqlDataRecord 개체를 만들면 메모리가 심각하게 고갈되고 성능에 부정적인 영향을 줄 수 있습니다.

생성자

SqlDataRecord(SqlMetaData[])

인수로 전달되는 SqlDataRecord 개체의 배열에 기초한 스키마를 사용하여 새 SqlMetaData 인스턴스를 초기화합니다.

속성

FieldCount	데이터 행의 열 수를 가져옵니다. 이 속성은 읽기 전용입니다.
Item[Int32]	열 `ordinal` 인수로 지정된 열의 CLR(공용 언어 런타임) 형식 값을 가져옵니다.
Item[String]	열 `name` 인수로 지정된 열의 CLR(공용 언어 런타임) 형식 값을 가져옵니다.

메서드

GetBoolean(Int32)	서수로 지정된 열의 값을 Boolean로 가져옵니다.
GetByte(Int32)	서수로 지정된 열의 값을 Byte로 가져옵니다.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	서수로 지정된 열의 값을 Byte 개체의 배열로 가져옵니다.
GetChar(Int32)	서수로 지정된 열의 값을 Char로 가져옵니다.
GetChars(Int32, Int64, Char[], Int32, Int32)	서수로 지정된 열의 값을 Char 개체의 배열로 가져옵니다.
GetDataTypeName(Int32)	서수 인수로 지정된 열의 데이터 형식 이름을 반환합니다.
GetDateTime(Int32)	서수로 지정된 열의 값을 DateTime로 가져옵니다.
GetDateTimeOffset(Int32)	지정된 열의 데이터를 DateTimeOffset으로 반환합니다.
GetDecimal(Int32)	서수로 지정된 열의 값을 Decimal로 가져옵니다.
GetDouble(Int32)	서수로 지정된 열의 값을 Double로 가져옵니다.
GetFieldType(Int32)	`ordinal` 인수로 지정된 열의 SQL Server 형식에 매핑되는 CLR(공용 언어 런타임) 형식을 나타내는 Type 개체를 반환합니다.
GetFloat(Int32)	서수로 지정된 열의 값을 `float`로 가져옵니다.
GetGuid(Int32)	서수로 지정된 열의 값을 Guid로 가져옵니다.
GetInt16(Int32)	서수로 지정된 열의 값을 Int16로 가져옵니다.
GetInt32(Int32)	서수로 지정된 열의 값을 Int32로 가져옵니다.
GetInt64(Int32)	서수로 지정된 열의 값을 Int64로 가져옵니다.
GetName(Int32)	서수 인수로 지정된 열의 이름을 반환합니다.
GetOrdinal(String)	열 이름으로 지정된 열 서수를 반환합니다.
GetSqlBinary(Int32)	서수로 지정된 열의 값을 SqlBinary로 가져옵니다.
GetSqlBoolean(Int32)	서수로 지정된 열의 값을 SqlBoolean로 가져옵니다.
GetSqlByte(Int32)	서수로 지정된 열의 값을 SqlByte로 가져옵니다.
GetSqlBytes(Int32)	서수로 지정된 열의 값을 SqlBytes로 가져옵니다.
GetSqlChars(Int32)	서수로 지정된 열의 값을 SqlChars로 가져옵니다.
GetSqlDateTime(Int32)	서수로 지정된 열의 값을 SqlDateTime로 가져옵니다.
GetSqlDecimal(Int32)	서수로 지정된 열의 값을 SqlDecimal로 가져옵니다.
GetSqlDouble(Int32)	서수로 지정된 열의 값을 SqlDouble로 가져옵니다.
GetSqlFieldType(Int32)	열의 SQL Server 형식에 매핑되는 형식( Type 에 정의된 SQL Server 형식)을 나타내는 System.Data.SqlTypes개체를 반환합니다.
GetSqlGuid(Int32)	서수로 지정된 열의 값을 SqlGuid로 가져옵니다.
GetSqlInt16(Int32)	서수로 지정된 열의 값을 SqlInt16로 가져옵니다.
GetSqlInt32(Int32)	서수로 지정된 열의 값을 SqlInt32로 가져옵니다.
GetSqlInt64(Int32)	서수로 지정된 열의 값을 SqlInt64로 가져옵니다.
GetSqlMetaData(Int32)	열 서수로 지정된 열의 메타데이터를 설명하는 SqlMetaData 개체를 반환합니다.
GetSqlMoney(Int32)	서수로 지정된 열의 값을 SqlMoney로 가져옵니다.
GetSqlSingle(Int32)	서수로 지정된 열의 값을 SqlSingle로 가져옵니다.
GetSqlString(Int32)	서수로 지정된 열의 값을 SqlString로 가져옵니다.
GetSqlValue(Int32)	열 서수로 지정되고, SQL Server 형식으로 표현되는 열에 저장된 데이터 값을 반환합니다.
GetSqlValues(Object[])	SQL Server 형식으로 표현된 레코드의 모든 열 값을 배열로 반환합니다.
GetSqlXml(Int32)	서수로 지정된 열의 값을 SqlXml로 가져옵니다.
GetString(Int32)	서수로 지정된 열의 값을 String로 가져옵니다.
GetTimeSpan(Int32)	지정된 열의 데이터를 TimeSpan으로 반환합니다.
GetValue(Int32)	서수 인수로 지정된 열에 대한 CLR(공용 언어 런타임) 형식 값을 반환합니다.
GetValues(Object[])	CLR(공용 언어 런타임) 형식으로 표현된 레코드의 모든 열 값을 배열로 반환합니다.
IsDBNull(Int32)	열 서수 매개 변수로 지정한 열이 null이면 true를 반환합니다.
SetBoolean(Int32, Boolean)	열에 저장된 데이터를 지정된 Boolean 값으로 설정합니다.
SetByte(Int32, Byte)	열에 저장된 데이터를 지정된 Byte 값으로 설정합니다.
SetBytes(Int32, Int64, Byte[], Int32, Int32)	이 열에 저장된 데이터를 Byte 값의 지정된 배열로 설정합니다.
SetChar(Int32, Char)	열에 저장된 데이터를 지정된 Char 값으로 설정합니다.
SetChars(Int32, Int64, Char[], Int32, Int32)	이 열에 저장된 데이터를 Char 값의 지정된 배열로 설정합니다.
SetDateTime(Int32, DateTime)	열에 저장된 데이터를 지정된 DateTime 값으로 설정합니다.
SetDateTimeOffset(Int32, DateTimeOffset)	지정된 열의 값을 DateTimeOffset 값으로 설정합니다.
SetDBNull(Int32)	지정된 열의 값을 DBNull로 설정합니다.
SetDecimal(Int32, Decimal)	열에 저장된 데이터를 지정된 Decimal 값으로 설정합니다.
SetDouble(Int32, Double)	열에 저장된 데이터를 지정된 Double 값으로 설정합니다.
SetFloat(Int32, Single)	열에 저장된 데이터를 지정된 `float` 값으로 설정합니다.
SetGuid(Int32, Guid)	열에 저장된 데이터를 지정된 Guid 값으로 설정합니다.
SetInt16(Int32, Int16)	열에 저장된 데이터를 지정된 Int16 값으로 설정합니다.
SetInt32(Int32, Int32)	열에 저장된 데이터를 지정된 Int32 값으로 설정합니다.
SetInt64(Int32, Int64)	열에 저장된 데이터를 지정된 Int64 값으로 설정합니다.
SetSqlBinary(Int32, SqlBinary)	열에 저장된 데이터를 지정된 SqlBinary 값으로 설정합니다.
SetSqlBoolean(Int32, SqlBoolean)	열에 저장된 데이터를 지정된 SqlBoolean 값으로 설정합니다.
SetSqlByte(Int32, SqlByte)	열에 저장된 데이터를 지정된 SqlByte 값으로 설정합니다.
SetSqlBytes(Int32, SqlBytes)	열에 저장된 데이터를 지정된 SqlBytes 값으로 설정합니다.
SetSqlChars(Int32, SqlChars)	열에 저장된 데이터를 지정된 SqlChars 값으로 설정합니다.
SetSqlDateTime(Int32, SqlDateTime)	열에 저장된 데이터를 지정된 SqlDateTime 값으로 설정합니다.
SetSqlDecimal(Int32, SqlDecimal)	열에 저장된 데이터를 지정된 SqlDecimal 값으로 설정합니다.
SetSqlDouble(Int32, SqlDouble)	열에 저장된 데이터를 지정된 SqlDouble 값으로 설정합니다.
SetSqlGuid(Int32, SqlGuid)	열에 저장된 데이터를 지정된 SqlGuid 값으로 설정합니다.
SetSqlInt16(Int32, SqlInt16)	열에 저장된 데이터를 지정된 SqlInt16 값으로 설정합니다.
SetSqlInt32(Int32, SqlInt32)	열에 저장된 데이터를 지정된 SqlInt32 값으로 설정합니다.
SetSqlInt64(Int32, SqlInt64)	열에 저장된 데이터를 지정된 SqlInt64 값으로 설정합니다.
SetSqlMoney(Int32, SqlMoney)	열에 저장된 데이터를 지정된 SqlMoney 값으로 설정합니다.
SetSqlSingle(Int32, SqlSingle)	열에 저장된 데이터를 지정된 SqlSingle 값으로 설정합니다.
SetSqlString(Int32, SqlString)	열에 저장된 데이터를 지정된 SqlString 값으로 설정합니다.
SetSqlXml(Int32, SqlXml)	열에 저장된 데이터를 지정된 SqlXml 값으로 설정합니다.
SetString(Int32, String)	열에 저장된 데이터를 지정된 String 값으로 설정합니다.
SetTimeSpan(Int32, TimeSpan)	지정된 열의 값을 TimeSpan으로 설정합니다.
SetValue(Int32, Object)	열 서수로 지정된 열에 대한 CLR(공용 언어 런타임) 형식의 새 값을 설정합니다.
SetValues(Object[])	SqlDataRecord의 모든 열에 대한 새 값을 설정합니다. 이러한 값은 CLR(공용 언어 런타임) 형식으로 표현됩니다.

명시적 인터페이스 구현

IDataRecord.GetData(Int32)

이 릴리스에서 지원되지 않습니다.

적용 대상

SqlDataRecord 클래스

정의

예제

설명

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 리소스