dotConnect for Salesforce Marketing Cloud Documentation
Devart.Data.ExactTarget Namespace / ExactTargetCommand Class
Members Example

In This Topic
    ExactTargetCommand Class
    In This Topic
    Represents a SQL statement or stored procedure to execute against ExactTarget.
    Syntax
    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.
    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();
      }
    }
    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

    See Also