ExactTargetCommand Class

In This Topic

Represents a SQL statement or stored procedure to execute against ExactTarget.

Syntax

Visual Basic
C#

'Declaration
 
Public Class ExactTargetCommand 
   Inherits Devart.Data.SqlShimCommand
   Implements System.ComponentModel.IComponent, System.Data.IDbCommand, System.ICloneable, System.IDisposable

public class ExactTargetCommand : Devart.Data.SqlShimCommand, System.ComponentModel.IComponent, System.Data.IDbCommand, System.ICloneable, System.IDisposable

Remarks

The ExactTargetCommand class provides the following methods for executing commands against ExactTarget:

Item	Description
ExecuteReader	Executes commands that return rows.
ExecutePageReader	Returns a specific subset of rows when paging through the results of a query.
ExecuteNonQuery	Executes SQL commands such as INSERT, DELETE, UPDATE.
ExecuteScalar	Retrieves a single value (for example, an aggregate value) from a data source.

If execution of the command results in a fatal ExactTargetException, the ExactTargetConnection may close. However, the user can reopen the connection and continue.

This class supports cross-form data binding with the InterForm Technology.

Example

The following example uses the ExecuteReader method of ExactTargetCommand, along with ExactTargetDataReader and ExactTargetConnection, to select rows from a table.

csharp

public void ReadMyData(string myConnString)
{
  string mySelectQuery = "SELECT ID, Name FROM Email";
  ExactTargetConnection exactTargetConnection = new ExactTargetConnection(myConnString);
  ExactTargetCommand exactTargetCommand = new ExactTargetCommand(mySelectQuery,exactTargetConnection);
  exactTargetConnection.Open();
  ExactTargetDataReader exactTargetReader = exactTargetCommand.ExecuteReader();
  try
  {
    while (exactTargetReader.Read())
    {
      Console.WriteLine(exactTargetReader.GetInt32(0).ToString() + ", " + exactTargetReader.GetString(1));
    }
  }
  finally
  {
  // always call Close when done reading.
  exactTargetReader.Close();
  // always call Close when done reading.
  exactTargetConnection.Close();
  }
}

Visual Basic

Public Sub ReadMyData(myConnString As String)
  Dim mySelectQuery As String = "SELECT ID, Name FROM Email"
  Dim exactTargetConnection As New ExactTargetConnection(myConnString)
  Dim exactTargetCommand As New ExactTargetCommand(mySelectQuery, exactTargetConnection)
  exactTargetConnection.Open()
  Dim exactTargetReader As ExactTargetDataReader = exactTargetCommand.ExecuteReader()
  Try
    While exactTargetReader.Read()
      Console.WriteLine(exactTargetReader.GetInt32(0).ToString() + ", " _
        + exactTargetReader.GetString(1))
    End While
  Finally
      ' always call Close when done reading.
      exactTargetReader.Close()
      ' always call Close when done with connection.
      exactTargetConnection.Close()
  End Try
End Sub

Inheritance Hierarchy

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Data.Common.DbCommand
            Devart.Common.DbCommandBase
               Devart.Data.SqlShimCommand
                  Devart.Data.ExactTarget.ExactTargetCommand

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ExactTargetCommand Members
Devart.Data.ExactTarget Namespace
ExactTargetDataReader Class
ExactTargetConnection Class

Send Feedback