SqlDataRecord Класс

Определение

Представляет одиночную строку данных и ее метаданные.Represents a single row of data and its metadata. Этот класс не наследуется.This class cannot be inherited.

public ref class SqlDataRecord : System::Data::IDataRecord
public class SqlDataRecord : System.Data.IDataRecord
type SqlDataRecord = class
    interface IDataRecord
Public Class SqlDataRecord
Implements IDataRecord
Наследование
SqlDataRecord
Реализации

Примеры

В следующем примере показано создание нескольких SqlMetaData объектов, описывающих метаданные столбца записи и создание SqlDataRecord.The following example shows how to create several SqlMetaData objects, which describe the column metadata of a record, and creating a SqlDataRecord. Значения столбцов SqlDataRecord задаются, а SqlDataRecord отправляются в вызывающую программу с помощью класса SqlContext.The column values of the SqlDataRecord are set and the SqlDataRecord is sent to the calling program by using the SqlContext class.

[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 для отправки результирующих наборов клиенту из хранимых процедур управляемого кода.This class is used together with SqlPipe to send result sets to the client from managed code stored-procedures.

При написании приложений среды CLR следует повторно использовать существующие SqlDataRecord объекты, а не создавать их каждый раз.When writing common language runtime (CLR) applications, you should re-use existing SqlDataRecord objects instead of creating new ones every time. Создание большого количества новых объектов SqlDataRecord может значительно привести к истощению памяти и негативно сказаться на производительности.Creating many new SqlDataRecord objects could severely deplete memory and adversely affect performance.

Конструкторы

SqlDataRecord(SqlMetaData[])

Инициализирует новый экземпляр SqlDataRecord схемой на основе массива объектов SqlMetaData, передаваемого в качестве аргумента.Inititializes a new SqlDataRecord instance with the schema based on the array of SqlMetaData objects passed as an argument.

Свойства

FieldCount

Возвращает число столбцов в строке данных.Gets the number of columns in the data row. Это свойство доступно только для чтения.This property is read-only.

Item[Int32]

Возвращает значение типа среды CLR для столбца, указанного аргументом столбца ordinal.Gets the common language runtime (CLR) type value for the column specified by the column ordinal argument.

Item[String]

Возвращает значение типа среды CLR для столбца, указанного аргументом столбца name.Gets the common language runtime (CLR) type value for the column specified by the column name argument.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetBoolean(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде Boolean.Gets the value for the column specified by the ordinal as a Boolean.

GetByte(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде Byte.Gets the value for the column specified by the ordinal as a Byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Возвращает значение столбца, указанное порядковым номером, в виде массива объектов Byte.Gets the value for the column specified by the ordinal as an array of Byte objects.

GetChar(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде Char.Gets the value for the column specified by the ordinal as a Char.

GetChars(Int32, Int64, Char[], Int32, Int32)

Возвращает значение столбца, указанное порядковым номером, в виде массива объектов Char.Gets the value for the column specified by the ordinal as an array of Char objects.

GetData(Int32)
GetDataTypeName(Int32)

Возвращает имя типа данных для столбца, указанного аргументом порядкового номера.Returns the name of the data type for the column specified by the ordinal argument.

GetDateTime(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде DateTime.Gets the value for the column specified by the ordinal as a DateTime.

GetDateTimeOffset(Int32)

Возвращает данные указанного столбца в виде DateTimeOffset.Returns the specified column's data as a DateTimeOffset.

GetDecimal(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде Decimal.Gets the value for the column specified by the ordinal as a Decimal.

GetDouble(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде Double.Gets the value for the column specified by the ordinal as a Double.

GetFieldType(Int32)

Возвращает объект Type, представляющий тип параметра среды CLR, который соответствует типу SQL Server для столбца, указанного аргументом ordinal.Returns a Type object representing the common language runtime (CLR) type that maps to the SQL Server type of the column specified by the ordinal argument.

GetFloat(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде float.Gets the value for the column specified by the ordinal as a float.

GetGuid(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде Guid.Gets the value for the column specified by the ordinal as a Guid.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetInt16(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде Int16.Gets the value for the column specified by the ordinal as a Int16.

GetInt32(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде Int32.Gets the value for the column specified by the ordinal as a Int32.

GetInt64(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде Int64.Gets the value for the column specified by the ordinal as a Int64.

GetName(Int32)

Возвращает имя столбца, указанного аргументом порядкового номера.Returns the name of the column specified by the ordinal argument.

GetOrdinal(String)

Возвращает порядковый номер столбца, указанный по имени столбца.Returns the column ordinal specified by the column name.

GetSqlBinary(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlBinary.Gets the value for the column specified by the ordinal as a SqlBinary.

GetSqlBoolean(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlBoolean.Gets the value for the column specified by the ordinal as a SqlBoolean.

GetSqlByte(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlByte.Gets the value for the column specified by the ordinal as a SqlByte.

GetSqlBytes(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlBytes.Gets the value for the column specified by the ordinal as a SqlBytes.

GetSqlChars(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlChars.Gets the value for the column specified by the ordinal as a SqlChars.

GetSqlDateTime(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlDateTime.Gets the value for the column specified by the ordinal as a SqlDateTime.

GetSqlDecimal(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlDecimal.Gets the value for the column specified by the ordinal as a SqlDecimal.

GetSqlDouble(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlDouble.Gets the value for the column specified by the ordinal as a SqlDouble.

GetSqlFieldType(Int32)

Возвращает объект Type, представляющий тип (в виде типа SQL Server, определенного в System.Data.SqlTypes), который сопоставляется с типом SQL Server столбца.Returns a Type object that represents the type (as a SQL Server type, defined in System.Data.SqlTypes) that maps to the SQL Server type of the column.

GetSqlGuid(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlGuid.Gets the value for the column specified by the ordinal as a SqlGuid.

GetSqlInt16(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlInt16.Gets the value for the column specified by the ordinal as a SqlInt16.

GetSqlInt32(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlInt32.Gets the value for the column specified by the ordinal as a SqlInt32.

GetSqlInt64(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlInt64.Gets the value for the column specified by the ordinal as a SqlInt64.

GetSqlMetaData(Int32)

Возвращает объект SqlMetaData, описывающий метаданные столбца, определенного порядковым номером.Returns a SqlMetaData object, describing the metadata of the column specified by the column ordinal.

GetSqlMoney(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlMoney.Gets the value for the column specified by the ordinal as a SqlMoney.

GetSqlSingle(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlSingle.Gets the value for the column specified by the ordinal as a SqlSingle.

GetSqlString(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlString.Gets the value for the column specified by the ordinal as a SqlString.

GetSqlValue(Int32)

Возвращает значение данных, хранящееся в столбце, выраженном как тип SQL Server, определенный порядковым номером столбца.Returns the data value stored in the column, expressed as a SQL Server type, specified by the column ordinal.

GetSqlValues(Object[])

Возвращает значения для всех столбцов в записи, выраженные в виде типов SQL Server, в массиве.Returns the values for all the columns in the record, expressed as SQL Server types, in an array.

GetSqlXml(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде SqlXml.Gets the value for the column specified by the ordinal as a SqlXml.

GetString(Int32)

Возвращает значение столбца, определенное порядковым номером, в виде String.Gets the value for the column specified by the ordinal as a String.

GetTimeSpan(Int32)

Возвращает данные указанного столбца в виде TimeSpan.Returns the specified column's data as a TimeSpan.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetValue(Int32)

Возвращает значение типа среды CLR для столбца, заданного аргументом порядкового типа.Returns the common language runtime (CLR) type value for the column specified by the ordinal argument.

GetValues(Object[])

Возвращает значения для всех столбцов в записи, выраженные в виде типов среды CLR, в массиве.Returns the values for all the columns in the record, expressed as common language runtime (CLR) types, in an array.

IsDBNull(Int32)

Возвращает значение true, если столбец, указанный параметром порядкового номера, имеет значение NULL.Returns true if the column specified by the column ordinal parameter is null.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
SetBoolean(Int32, Boolean)

Задает для данных, хранимых в столбце, указанное значение Boolean.Sets the data stored in the column to the specified Boolean value.

SetByte(Int32, Byte)

Задает для данных, хранимых в столбце, указанное значение Byte.Sets the data stored in the column to the specified Byte value.

SetBytes(Int32, Int64, Byte[], Int32, Int32)

Задает данные, сохраненные в столбце, в указанный массив значений Byte.Sets the data stored in the column to the specified array of Byte values.

SetChar(Int32, Char)

Задает для данных, хранимых в столбце, указанное значение Char.Sets the data stored in the column to the specified Char value.

SetChars(Int32, Int64, Char[], Int32, Int32)

Задает данные, сохраненные в столбце, в указанный массив значений Char.Sets the data stored in the column to the specified array of Char values.

SetDateTime(Int32, DateTime)

Задает для данных, хранимых в столбце, указанное значение DateTime.Sets the data stored in the column to the specified DateTime value.

SetDateTimeOffset(Int32, DateTimeOffset)

Задает для указанного столбца значение DateTimeOffset.Sets the value of the column specified to the DateTimeOffset value.

SetDBNull(Int32)

Задает для указанного столбца значение DBNull.Sets the value in the specified column to DBNull.

SetDecimal(Int32, Decimal)

Задает для данных, хранимых в столбце, указанное значение Decimal.Sets the data stored in the column to the specified Decimal value.

SetDouble(Int32, Double)

Задает для данных, хранимых в столбце, указанное значение Double.Sets the data stored in the column to the specified Double value.

SetFloat(Int32, Single)

Задает для данных, хранимых в столбце, указанное значение float.Sets the data stored in the column to the specified float value.

SetGuid(Int32, Guid)

Задает для данных, хранимых в столбце, указанное значение Guid.Sets the data stored in the column to the specified Guid value.

SetInt16(Int32, Int16)

Задает для данных, хранимых в столбце, указанное значение Int16.Sets the data stored in the column to the specified Int16 value.

SetInt32(Int32, Int32)

Задает для данных, хранимых в столбце, указанное значение Int32.Sets the data stored in the column to the specified Int32 value.

SetInt64(Int32, Int64)

Задает для данных, хранимых в столбце, указанное значение Int64.Sets the data stored in the column to the specified Int64 value.

SetSqlBinary(Int32, SqlBinary)

Задает для данных, хранимых в столбце, указанное значение SqlBinary.Sets the data stored in the column to the specified SqlBinary value.

SetSqlBoolean(Int32, SqlBoolean)

Задает для данных, хранимых в столбце, указанное значение SqlBoolean.Sets the data stored in the column to the specified SqlBoolean value.

SetSqlByte(Int32, SqlByte)

Задает для данных, хранимых в столбце, указанное значение SqlByte.Sets the data stored in the column to the specified SqlByte value.

SetSqlBytes(Int32, SqlBytes)

Задает для данных, хранимых в столбце, указанное значение SqlBytes.Sets the data stored in the column to the specified SqlBytes value.

SetSqlChars(Int32, SqlChars)

Задает для данных, хранимых в столбце, указанное значение SqlChars.Sets the data stored in the column to the specified SqlChars value.

SetSqlDateTime(Int32, SqlDateTime)

Задает для данных, хранимых в столбце, указанное значение SqlDateTime.Sets the data stored in the column to the specified SqlDateTime value.

SetSqlDecimal(Int32, SqlDecimal)

Задает для данных, хранимых в столбце, указанное значение SqlDecimal.Sets the data stored in the column to the specified SqlDecimal value.

SetSqlDouble(Int32, SqlDouble)

Задает для данных, хранимых в столбце, указанное значение SqlDouble.Sets the data stored in the column to the specified SqlDouble value.

SetSqlGuid(Int32, SqlGuid)

Задает для данных, хранимых в столбце, указанное значение SqlGuid.Sets the data stored in the column to the specified SqlGuid value.

SetSqlInt16(Int32, SqlInt16)

Задает для данных, хранимых в столбце, указанное значение SqlInt16.Sets the data stored in the column to the specified SqlInt16 value.

SetSqlInt32(Int32, SqlInt32)

Задает для данных, хранимых в столбце, указанное значение SqlInt32.Sets the data stored in the column to the specified SqlInt32 value.

SetSqlInt64(Int32, SqlInt64)

Задает для данных, хранимых в столбце, указанное значение SqlInt64.Sets the data stored in the column to the specified SqlInt64 value.

SetSqlMoney(Int32, SqlMoney)

Задает для данных, хранимых в столбце, указанное значение SqlMoney.Sets the data stored in the column to the specified SqlMoney value.

SetSqlSingle(Int32, SqlSingle)

Задает для данных, хранимых в столбце, указанное значение SqlSingle.Sets the data stored in the column to the specified SqlSingle value.

SetSqlString(Int32, SqlString)

Задает для данных, хранимых в столбце, указанное значение SqlString.Sets the data stored in the column to the specified SqlString value.

SetSqlXml(Int32, SqlXml)

Задает для данных, хранимых в столбце, указанное значение SqlXml.Sets the data stored in the column to the specified SqlXml value.

SetString(Int32, String)

Задает для данных, хранимых в столбце, указанное значение String.Sets the data stored in the column to the specified String value.

SetTimeSpan(Int32, TimeSpan)

Задает для указанного столбца значение TimeSpan.Sets the value of the column specified to the TimeSpan.

SetValue(Int32, Object)

Задает новое значение, выраженное как тип среды CLR, для столбца, указанного порядковым номером столбца.Sets a new value, expressed as a common language runtime (CLR) type, for the column specified by the column ordinal.

SetValues(Object[])

Задает новые значения для всех столбцов в SqlDataRecord.Sets new values for all of the columns in the SqlDataRecord. Эти значения представлены в виде типов среды CLR.These values are expressed as common language runtime (CLR) types.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Явные реализации интерфейса

IDataRecord.GetData(Int32)

Не поддерживается в данном выпуске.Not supported in this release.

Применяется к