SqlDataRecord Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет одиночную строку данных и ее метаданные. Этот класс не наследуется.
public ref class SqlDataRecord : System::Data::IDataRecordpublic class SqlDataRecord : System.Data.IDataRecordtype SqlDataRecord = class
interface IDataRecordPublic Class SqlDataRecord
Implements IDataRecord- Наследование
-
SqlDataRecord
- Реализации
Примеры
В следующем примере показано, как создать несколько 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] |
Возвращает значение типа среды CLR для столбца, указанного аргументом столбца |
| Item[String] |
Возвращает значение типа среды 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) |
Возвращает объект Type, представляющий тип параметра среды CLR, который соответствует типу SQL Server для столбца, указанного аргументом |
| GetFloat(Int32) |
Возвращает значение столбца, определенное порядковым номером, в виде |
| 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.SqlTypes), который сопоставляется с типом SQL 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) |
Возвращает значение true, если столбец, указанный параметром порядкового номера, имеет значение NULL. |
| 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) |
Задает для данных, хранимых в столбце, указанное значение |
| 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) |
Не поддерживается в данном выпуске. |