SqlDataRecord Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa uma única linha de dados e seus metadados.
public ref class SqlDataRecord : System::Data::IDataRecordpublic class SqlDataRecord : System.Data.IDataRecordtype SqlDataRecord = class
interface IDataRecordPublic 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, em seguida, criar uma instância reutilizável SqlDataRecord . Os valores de coluna do SqlDataRecord conjunto e o mesmo SqlDataRecord podem ser usados para transmitir várias linhas para SQL Server como um parâmetro com valor de tabela.
using System;
using System.Collections.Generic;
using System.Data;
using Microsoft.Data.SqlClient.Server;
// Stream rows to SQL Server as a table-valued parameter.
public static IEnumerable<SqlDataRecord> CreateNewRecord()
{
// Re-use a single SqlDataRecord instance rather than allocating a new one for each row.
// Each row's values are read before SqlCommand advances to the next one.
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);
// Stream the first record to SQL Server.
yield return record;
// Set the fields of the second record and stream it to SQL Server.
record.SetInt32(1, 0);
yield return record;
}
Comentários
Essa classe descreve uma única linha de um parâmetro com valor de tabela. Construir um de uma matriz de SqlMetaData objetos que descrevem os metadados de coluna do registro, preenchê-lo com os métodos Set<Type> , incluí-lo em um IEnumerable<SqlDataRecord> e atribuí-lo IEnumerable<SqlDataRecord> a Value.
Para obter o melhor desempenho ao enviar várias linhas, reutilize uma única SqlDataRecord instância em um IEnumerable<SqlDataRecord> iterador: defina novos valores de coluna e yield return a mesma instância para cada linha.
SqlCommand lerá cada registro antes de avançar para o próximo.
Construtores
| Nome | Description |
|---|---|
| SqlDataRecord(SqlMetaData[]) |
Inicializa uma nova SqlDataRecord instância com o esquema com base na matriz de SqlMetaData objetos passados como um argumento. |
Propriedades
| Nome | Description |
|---|---|
| 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 CLR (Common Language Runtime) para a coluna especificada pelo argumento de coluna |
| Item[String] |
Obtém o valor de tipo CLR (Common Language Runtime) para a coluna especificada pelo argumento de coluna |
Métodos
| Nome | Description |
|---|---|
| GetBoolean(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um Boolean. |
| GetByte(Int32) |
Obtém o valor da 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 Byte objetos. |
| GetChar(Int32) |
Obtém o valor da 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 Char objetos. |
| GetDataTypeName(Int32) |
Retorna o nome do tipo de dados para a coluna especificada pelo argumento ordinal. |
| GetDateTime(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um DateTime. |
| GetDateTimeOffset(Int32) |
Retorna os dados da coluna especificada como um DateTimeOffset. |
| GetDecimal(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um Decimal. |
| GetDouble(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um Double. |
| GetFieldType(Int32) |
Retorna um Type objeto que representa o tipo CLR (Common Language Runtime) mapeado para o tipo SQL Server da coluna especificada pelo |
| GetFloat(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um Single. |
| GetGuid(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um Guid. |
| GetInt16(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um Int16. |
| GetInt32(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um Int32. |
| GetInt64(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um Int64. |
| GetName(Int32) |
Retorna o nome da coluna especificada pelo argumento ordinal. |
| GetOrdinal(String) |
Retorna o ordinal de coluna especificado pelo nome da coluna. |
| GetSqlBinary(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlBinary. |
| GetSqlBoolean(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlBoolean. |
| GetSqlByte(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlByte. |
| GetSqlBytes(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlBytes. |
| GetSqlChars(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlChars. |
| GetSqlDateTime(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlDateTime. |
| GetSqlDecimal(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlDecimal. |
| GetSqlDouble(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlDouble. |
| GetSqlFieldType(Int32) |
Retorna um Type objeto que representa o tipo (como um tipo de SQL Server, definido em System.Data.SqlTypes) que é mapeado para o tipo SQL Server da coluna. |
| GetSqlGuid(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlGuid. |
| GetSqlInt16(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlInt16. |
| GetSqlInt32(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlInt32. |
| GetSqlInt64(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlInt64. |
| GetSqlMetaData(Int32) |
Retorna um SqlMetaData objeto, descrevendo os metadados da coluna especificada pelo ordinal de coluna. |
| GetSqlMoney(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlMoney. |
| GetSqlSingle(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlSingle. |
| GetSqlString(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlString. |
| GetSqlValue(Int32) |
Retorna o valor de dados armazenado na coluna, expresso como um tipo de SQL Server, especificado pela coluna ordinal. |
| GetSqlValues(Object[]) |
Retorna os valores de todas as colunas no registro, expressos como tipos SQL Server, em uma matriz. |
| GetSqlXml(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um SqlXml. |
| GetString(Int32) |
Obtém o valor da coluna especificada pelo ordinal como um String. |
| GetTimeSpan(Int32) |
Retorna os dados da coluna especificada como um TimeSpan. |
| GetValue(Int32) |
Retorna o valor do tipo 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 CLR (Common Language Runtime), em uma matriz. |
| IsDBNull(Int32) |
Retorna |
| SetBoolean(Int32, Boolean) |
Define os dados armazenados na coluna como o valor especificado Boolean . |
| SetByte(Int32, Byte) |
Define os dados armazenados na coluna como o valor especificado Byte . |
| SetBytes(Int32, Int64, Byte[], Int32, Int32) |
Define os dados armazenados na coluna como a matriz de Byte valores especificada. |
| SetChar(Int32, Char) |
Define os dados armazenados na coluna como o valor especificado Char . |
| SetChars(Int32, Int64, Char[], Int32, Int32) |
Define os dados armazenados na coluna como a matriz de Char valores especificada. |
| SetDateTime(Int32, DateTime) |
Define os dados armazenados na coluna como o valor especificado DateTime . |
| SetDateTimeOffset(Int32, DateTimeOffset) |
Define o valor da coluna especificada para o DateTimeOffset valor. |
| SetDBNull(Int32) |
Define o valor na coluna especificada como DBNull. |
| SetDecimal(Int32, Decimal) |
Define os dados armazenados na coluna como o valor especificado Decimal . |
| SetDouble(Int32, Double) |
Define os dados armazenados na coluna como o valor especificado Double . |
| SetFloat(Int32, Single) |
Define os dados armazenados na coluna como o valor especificado Single . |
| SetGuid(Int32, Guid) |
Define os dados armazenados na coluna como o valor especificado Guid . |
| SetInt16(Int32, Int16) |
Define os dados armazenados na coluna como o valor especificado Int16 . |
| SetInt32(Int32, Int32) |
Define os dados armazenados na coluna como o valor especificado Int32 . |
| SetInt64(Int32, Int64) |
Define os dados armazenados na coluna como o valor especificado Int64 . |
| SetSqlBinary(Int32, SqlBinary) |
Define os dados armazenados na coluna como o valor especificado SqlBinary . |
| SetSqlBoolean(Int32, SqlBoolean) |
Define os dados armazenados na coluna como o valor especificado SqlBoolean . |
| SetSqlByte(Int32, SqlByte) |
Define os dados armazenados na coluna como o valor especificado SqlByte . |
| SetSqlBytes(Int32, SqlBytes) |
Define os dados armazenados na coluna como o valor especificado SqlBytes . |
| SetSqlChars(Int32, SqlChars) |
Define os dados armazenados na coluna como o valor especificado SqlChars . |
| SetSqlDateTime(Int32, SqlDateTime) |
Define os dados armazenados na coluna como o valor especificado SqlDateTime . |
| SetSqlDecimal(Int32, SqlDecimal) |
Define os dados armazenados na coluna como o valor especificado SqlDecimal . |
| SetSqlDouble(Int32, SqlDouble) |
Define os dados armazenados na coluna como o valor especificado SqlDouble . |
| SetSqlGuid(Int32, SqlGuid) |
Define os dados armazenados na coluna como o valor especificado SqlGuid . |
| SetSqlInt16(Int32, SqlInt16) |
Define os dados armazenados na coluna como o valor especificado SqlInt16 . |
| SetSqlInt32(Int32, SqlInt32) |
Define os dados armazenados na coluna como o valor especificado SqlInt32 . |
| SetSqlInt64(Int32, SqlInt64) |
Define os dados armazenados na coluna como o valor especificado SqlInt64 . |
| SetSqlMoney(Int32, SqlMoney) |
Define os dados armazenados na coluna como o valor especificado SqlMoney . |
| SetSqlSingle(Int32, SqlSingle) |
Define os dados armazenados na coluna como o valor especificado SqlSingle . |
| SetSqlString(Int32, SqlString) |
Define os dados armazenados na coluna como o valor especificado SqlString . |
| SetSqlXml(Int32, SqlXml) |
Define os dados armazenados na coluna como o valor especificado SqlXml . |
| SetString(Int32, String) |
Define os dados armazenados na coluna como o valor especificado String . |
| SetTimeSpan(Int32, TimeSpan) |
Define o valor da coluna especificada como TimeSpan. |
| SetValue(Int32, Object) |
Define um novo valor, expresso como um tipo CLR (Common Language Runtime), para a coluna especificada pelo ordinal de coluna. |
| SetValues(Object[]) |
Define novos valores para todas as colunas no SqlDataRecord. Esses valores são expressos como tipos CLR (Common Language Runtime). |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Não há suporte nesta versão. |