Compartilhar via


SqlDataRecord Classe

Definição

Representa uma única linha de dados e seus metadados. Essa classe não pode ser herdada.

public ref class SqlDataRecord : System::Data::IDataRecord
public class SqlDataRecord : System.Data.IDataRecord
type SqlDataRecord = class
    interface IDataRecord
Public Class SqlDataRecord
Implements IDataRecord
Herança
SqlDataRecord
Implementações

Exemplos

O exemplo a seguir mostra como criar vários SqlMetaData objetos, que descrevem os metadados de coluna de um registro e a criação de um SqlDataRecord. Os valores de coluna do SqlDataRecord são definidos e o SqlDataRecord é enviado para o programa de chamada usando a SqlContext classe .

[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

Comentários

Essa classe é usada junto com SqlPipe para enviar conjuntos de resultados para o cliente a partir de procedimentos armazenados de código gerenciado.

Ao escrever aplicativos CLR (Common Language Runtime), você deve reutilização de objetos existentes SqlDataRecord em vez de criar novos cada vez. A criação de muitos objetos novos SqlDataRecord pode esgotar severamente a memória e afetar negativamente o desempenho.

Construtores

SqlDataRecord(SqlMetaData[])

Inicializa uma nova instância SqlDataRecord com o esquema baseado na matriz de objetos SqlMetaData passados como um argumento.

Propriedades

FieldCount

Obtém o número de colunas na linha de dados. Esta propriedade é somente para leitura.

Item[Int32]

Obtém o valor de tipo do CLR (Common Language Runtime) para a coluna especificada pelo argumento ordinal da coluna.

Item[String]

Obtém o valor de tipo do CLR (Common Language Runtime) para a coluna especificada pelo argumento name da coluna.

Métodos

GetBoolean(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um Boolean.

GetByte(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um Byte.

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

Obtém o valor da coluna especificada pelo ordinal como uma matriz de objetos Byte.

GetChar(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um Char.

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

Obtém o valor da coluna especificada pelo ordinal como uma matriz de objetos Char.

GetDataTypeName(Int32)

Retorna o nome do tipo de dados para a coluna especificada pelo argumento ordinal.

GetDateTime(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um DateTime.

GetDateTimeOffset(Int32)

Retorna os dados da coluna especificada como um DateTimeOffset.

GetDecimal(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um Decimal.

GetDouble(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um Double.

GetFieldType(Int32)

Retorna um objeto Type que representa o tipo do CLR (Common Language Runtime) que mapeia para o tipo do SQL Server da coluna especificada pelo argumento ordinal.

GetFloat(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um float.

GetGuid(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um Guid.

GetInt16(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um Int16.

GetInt32(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um Int32.

GetInt64(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um Int64.

GetName(Int32)

Retorna o nome da coluna especificada pelo argumento ordinal.

GetOrdinal(String)

Retorna o ordinal da coluna especificado pelo nome da coluna.

GetSqlBinary(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlBinary.

GetSqlBoolean(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlBoolean.

GetSqlByte(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlByte.

GetSqlBytes(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlBytes.

GetSqlChars(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlChars.

GetSqlDateTime(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlDateTime.

GetSqlDecimal(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlDecimal.

GetSqlDouble(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlDouble.

GetSqlFieldType(Int32)

Retorna um objeto Type que representa o tipo (como um tipo do SQL Server, definido em System.Data.SqlTypes) que mapeia para o tipo da coluna do SQL Server.

GetSqlGuid(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlGuid.

GetSqlInt16(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlInt16.

GetSqlInt32(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlInt32.

GetSqlInt64(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlInt64.

GetSqlMetaData(Int32)

Retorna um objeto SqlMetaData que descreve os metadados da coluna especificados pelo ordinal da coluna.

GetSqlMoney(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlMoney.

GetSqlSingle(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlSingle.

GetSqlString(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlString.

GetSqlValue(Int32)

Retorna o valor dos dados armazenados na coluna, expressos como um tipo do SQL Server, especificada pelo ordinal da coluna.

GetSqlValues(Object[])

Retorna os valores de todas as colunas no registro, expressos como tipos do SQL Server, em uma matriz.

GetSqlXml(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um SqlXml.

GetString(Int32)

Obtém o valor para a coluna especificada pelo ordinal como um String.

GetTimeSpan(Int32)

Retorna os dados da coluna especificada como um TimeSpan.

GetValue(Int32)

Retorna o valor de tipo do CLR (Common Language Runtime) para a coluna especificada pelo argumento ordinal.

GetValues(Object[])

Retorna os valores de todas as colunas no registro, expressos como tipos do CLR (Common Language Runtime), em uma matriz.

IsDBNull(Int32)

Retorna true se a coluna especificada pelo parâmetro do ordinal da coluna é nula.

SetBoolean(Int32, Boolean)

Define os dados armazenados na coluna como o valor Boolean especificado.

SetByte(Int32, Byte)

Define os dados armazenados na coluna como o valor Byte especificado.

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

Define os dados armazenados na coluna como a matriz especificada de valores Byte.

SetChar(Int32, Char)

Define os dados armazenados na coluna como o valor Char especificado.

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

Define os dados armazenados na coluna como a matriz especificada de valores Char.

SetDateTime(Int32, DateTime)

Define os dados armazenados na coluna como o valor DateTime especificado.

SetDateTimeOffset(Int32, DateTimeOffset)

Define o valor da coluna especificada como o valor DateTimeOffset.

SetDBNull(Int32)

Define o valor na coluna especificada como DBNull.

SetDecimal(Int32, Decimal)

Define os dados armazenados na coluna como o valor Decimal especificado.

SetDouble(Int32, Double)

Define os dados armazenados na coluna como o valor Double especificado.

SetFloat(Int32, Single)

Define os dados armazenados na coluna como o valor float especificado.

SetGuid(Int32, Guid)

Define os dados armazenados na coluna como o valor Guid especificado.

SetInt16(Int32, Int16)

Define os dados armazenados na coluna como o valor Int16 especificado.

SetInt32(Int32, Int32)

Define os dados armazenados na coluna como o valor Int32 especificado.

SetInt64(Int32, Int64)

Define os dados armazenados na coluna como o valor Int64 especificado.

SetSqlBinary(Int32, SqlBinary)

Define os dados armazenados na coluna como o valor SqlBinary especificado.

SetSqlBoolean(Int32, SqlBoolean)

Define os dados armazenados na coluna como o valor SqlBoolean especificado.

SetSqlByte(Int32, SqlByte)

Define os dados armazenados na coluna como o valor SqlByte especificado.

SetSqlBytes(Int32, SqlBytes)

Define os dados armazenados na coluna como o valor SqlBytes especificado.

SetSqlChars(Int32, SqlChars)

Define os dados armazenados na coluna como o valor SqlChars especificado.

SetSqlDateTime(Int32, SqlDateTime)

Define os dados armazenados na coluna como o valor SqlDateTime especificado.

SetSqlDecimal(Int32, SqlDecimal)

Define os dados armazenados na coluna como o valor SqlDecimal especificado.

SetSqlDouble(Int32, SqlDouble)

Define os dados armazenados na coluna como o valor SqlDouble especificado.

SetSqlGuid(Int32, SqlGuid)

Define os dados armazenados na coluna como o valor SqlGuid especificado.

SetSqlInt16(Int32, SqlInt16)

Define os dados armazenados na coluna como o valor SqlInt16 especificado.

SetSqlInt32(Int32, SqlInt32)

Define os dados armazenados na coluna como o valor SqlInt32 especificado.

SetSqlInt64(Int32, SqlInt64)

Define os dados armazenados na coluna como o valor SqlInt64 especificado.

SetSqlMoney(Int32, SqlMoney)

Define os dados armazenados na coluna como o valor SqlMoney especificado.

SetSqlSingle(Int32, SqlSingle)

Define os dados armazenados na coluna como o valor SqlSingle especificado.

SetSqlString(Int32, SqlString)

Define os dados armazenados na coluna como o valor SqlString especificado.

SetSqlXml(Int32, SqlXml)

Define os dados armazenados na coluna como o valor SqlXml especificado.

SetString(Int32, String)

Define os dados armazenados na coluna como o valor String especificado.

SetTimeSpan(Int32, TimeSpan)

Define o valor da coluna especificada como o TimeSpan.

SetValue(Int32, Object)

Define um novo valor, expressado como um tipo do CLR (Common Language Runtime), para a coluna especificada pelo ordinal da coluna.

SetValues(Object[])

Define novos valores para todas as colunas no SqlDataRecord. Esses valores são expressos como tipos do CLR (Common Language Runtime).

Implantações explícitas de interface

IDataRecord.GetData(Int32)

Não é compatível nesta versão.

Aplica-se a