SqlDataRecord Classe

  • Referência

Definição

Namespace:
Microsoft.SqlServer.Server
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacote:
System.Data.SqlClient v4.8.5

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
Object
SqlDataRecord
Implementações
IDataRecord

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