SqlDataRecord 클래스

정의

네임스페이스:

Microsoft.Data.SqlClient.Server

어셈블리:

Microsoft.Data.SqlClient.dll

Package(패키지):

Microsoft.Data.SqlClient v7.1.0

데이터의 단일 행과 해당 메타데이터를 나타냅니다.

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 이 설정되고 테이블 반환 매개 변수로 SQL Server 여러 행을 스트리밍하는 데도 동일하게 SqlDataRecord 사용될 수 있습니다.

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

// Stream rows to SQL Server as a table-valued parameter.
public static IEnumerable<SqlDataRecord> CreateNewRecord()
{
   // Re-use a single SqlDataRecord instance rather than allocating a new one for each row.
   // Each row's values are read before SqlCommand advances to the next one.
   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);

   // Stream the first record to SQL Server.
   yield return record;

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

설명

이 클래스는 테이블 반환 매개 변수의 단일 행에 대해 설명합니다. 레코드의 SqlMetaData 열 메타데이터를 설명하는 개체 배열에서 하나를 생성하고, Set Type> 메서드로 채우고, 형식 설정< 메서드에 IEnumerable<SqlDataRecord> 포함하고, 이를 IEnumerable<SqlDataRecord> 할당합니다Value.

여러 행을 보낼 때 최상의 성능을 위해 반복기에서 단일 SqlDataRecord 인스턴스를 IEnumerable<SqlDataRecord> 다시 사용합니다. 새 열 값과 yield return 각 행에 대해 동일한 인스턴스를 설정합니다. SqlCommand 는 다음으로 넘어가기 전에 각 레코드를 읽습니다.

생성자

속성	Description
SqlDataRecord(SqlMetaData[])	인수로 전달된 개체의 SqlMetaData 배열을 기반으로 스키마를 사용하여 새 SqlDataRecord 인스턴스를 초기화합니다.

속성

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

메서드

속성	Description
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)	인수로 Type 지정된 열의 SQL Server 형식에 매핑되는 CLR(공용 언어 런타임) 형식을 나타내는 개체를 ordinal 반환합니다.
GetFloat(Int32)	서수 Single로 지정된 열의 값을 가져옵니다.
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)	열의 Type SQL Server 형식에 매핑되는 형식(정의된 System.Data.SqlTypesSQL Server 형식)을 나타내는 개체를 반환합니다.
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)	열에 저장된 데이터를 지정된 Single 값으로 설정합니다.
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(공용 언어 런타임) 형식으로 표현됩니다.

명시적 인터페이스 구현

속성	Description
IDataRecord.GetData(Int32)	이 릴리스에서는 지원되지 않습니다.