Share via


Método ServerConnection.ExecuteReader (String)

Executa instruções Transact-SQL que retornam um ou vários conjuntos de resultados.

Namespace:  Microsoft.SqlServer.Management.Common
Assembly:  Microsoft.SqlServer.ConnectionInfo (em Microsoft.SqlServer.ConnectionInfo.dll)

Sintaxe

'Declaração
Public Function ExecuteReader ( _
    sqlCommand As String _
) As SqlDataReader
'Uso
Dim instance As ServerConnection 
Dim sqlCommand As String 
Dim returnValue As SqlDataReader 

returnValue = instance.ExecuteReader(sqlCommand)
public SqlDataReader ExecuteReader(
    string sqlCommand
)
public:
SqlDataReader^ ExecuteReader(
    String^ sqlCommand
)
member ExecuteReader : 
        sqlCommand:string -> SqlDataReader
public function ExecuteReader(
    sqlCommand : String
) : SqlDataReader

Parâmetros

  • sqlCommand
    Tipo: String
    Um valor String que especifica o comando Transact-SQL a ser executado.

Valor de retorno

Tipo: SqlDataReader
Um valor do objeto SqlDataReader que contém um ou mais conjuntos de resultados.

Comentários

O objeto de SqlDataReader é retornado para permitir que o cliente processar os dados sem exigi-la ler todas as informações na memória.

Exemplos

C#

ServerConnection conn = new ServerConnection();
conn.DatabaseName = "AdventureWorks2012";
SqlDataReader reader = conn.ExecuteReader("SELECT Name, CostRate FROM Production.Location");
while (reader.Read())
{
   string name = (string)reader["Name"];
   decimal cRate = (decimal)reader["CostRate"];
   Console.WriteLine(name + "(" + cRate + ")");
}
reader.Close();

PowerShell

$conn = new-object Microsoft.SqlServer.Management.Common.ServerConnection
$conn.DatabaseName = "AdventureWorks2012"
$reader = $conn.ExecuteReader("SELECT Name, CostRate FROM Production.Location")
while ($reader.Read())
{
   $name = $reader.GetValue(0);
   $cRate = $reader.GetValue(1);
   Write-Host $name,"(",$cRate,")"
}
$reader.Close()

Consulte também

Referência

ServerConnection Classe

Sobrecarregado ExecuteReader

Namespace Microsoft.SqlServer.Management.Common