SqlDataRecord Classe

Definição

Namespace:

Microsoft.Data.SqlClient.Server

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Representa uma única linha de dados e seus metadados.

C#

public class SqlDataRecord : System.Data.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 .

C#

//using Microsoft.Data.SqlClient.Server;

[Microsoft.Data.SqlClient.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);
}

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 a cada vez. A criação de muitos novos SqlDataRecord objetos 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