Active Property

In This Topic

Gets or sets whether a DbDataTable is filled with data from a data source.

Syntax

Visual Basic
C#

'Declaration
 
Public Property Active As Boolean

public bool Active {get; set;}

Property Value

true if a DbDataTable is populated with data from a data source; otherwise, false. The default value is false.

Remarks

Set Active property to true to populate the DbDataTable with the data returned from executing SelectCommand. Setting the property to false clears the data and frees the resources allocated on the server, if any.

Example

This sample shows how to use DbDataTable. The routine accepts DbTable-compatible object and IDbCommand implementor object as parameters. After SQL query text has been set the data is retrieved from the table.

csharp

static void UseDataTable(DbDataTable myDataTable, DbCommand myCommand)
{
  myCommand.CommandText = "SELECT * FROM Test.Dept";
  myDataTable.SelectCommand = myCommand;
  try
  {
        myDataTable.FetchAll = true;
    myDataTable.Active = true;
    foreach(DataRow myRow in myDataTable.Rows)
    {
      foreach(DataColumn myCol in myDataTable.Columns)
      {
        Console.Write(myRow[myCol]+"\t");
      }
      Console.WriteLine();
    }
  }
  finally
  {
    myDataTable.Active = false;
  }
}

Visual Basic

Public Sub UseDataTable(ByVal myDataTable As DbDataTable, ByVal myCommand As DbCommand)
  myCommand.CommandText = "SELECT * FROM Test.Dept"
  myDataTable.SelectCommand = myCommand
  Try
        myDataTable.FetchAll = True
    myDataTable.Active = True
    Dim myRow As DataRow
    Dim myCol As DataColumn
    For Each myRow In myDataTable.Rows
      For Each myCol In myDataTable.Columns
        Console.Write(myRow(myCol) & Chr(9))
      Next myCol
      Console.WriteLine()
    Next myRow
  Finally
    myDataTable.Active = False
  End Try
End Sub

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

DbDataTable Class
DbDataTable Members
SelectCommand Property

Send Feedback