SqlCommand Constructor(String,SqlConnection)

In This Topic

Syntax
Remarks
Example
Requirements
See Also

Initializes a new instance of the SqlCommand class with the text of the query and a %% object.

Syntax

Visual Basic
C#

public SqlCommand( 
   string commandText,
   SqlConnection connection
)

'Declaration
 
Public Function New( _
   ByVal commandText As String, _
   ByVal connection As SqlConnection _
)

Parameters

commandText: The text of the query.
connection: A SqlConnection object that represents the connection to SQL Server.

Remarks

The following table shows initial property values for an instance of SqlCommand.

Properties	Initial value
CommandText	commandText
CommandTimeout	30
CommandType	System.Data.CommandType.Text
Connection	connection

Example

The following example creates a SqlCommand and sets some of its properties.

csharp

public void CreateCommand()
{
  SqlConnection myConnection = new SqlConnection(
      "User Id=sa;Server=localhost;Initial Catalog=Test;");
  string mySelectQuery = "SELECT * FROM Test.Dept";
  SqlCommand myCommand = new SqlCommand(mySelectQuery, myConnection);
  myCommand.FetchSize = 100;
}

Visual Basic

Public Sub CreateCommand()
  Dim myConnection As New SqlConnection( _
    "User Id=sa;Server=localhost;Initial Catalog=Test;")
  Dim mySelectQuery As String = _
    "SELECT * FROM Test.Dept"
  Dim myCommand As New SqlCommand(mySelectQuery, myConnection)
  myCommand.FetchSize = 100
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

SqlCommand Class
SqlCommand Members
Overload List
SqlDataReader Class
SqlConnection Class

Send Feedback