SqlCommand SqlCommand SqlCommand SqlCommand Constructors

Definition

Überlädt

SqlCommand() SqlCommand() SqlCommand()

Initialisiert eine neue Instanz der SqlCommand-Klasse.Initializes a new instance of the SqlCommand class.

SqlCommand(String) SqlCommand(String) SqlCommand(String) SqlCommand(String)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage.Initializes a new instance of the SqlCommand class with the text of the query.

SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage und einer SqlConnection.Initializes a new instance of the SqlCommand class with the text of the query and a SqlConnection.

SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage, einer SqlConnection und der SqlTransaction.Initializes a new instance of the SqlCommand class with the text of the query, a SqlConnection, and the SqlTransaction.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem angegebenen Befehlstext sowie mit der angegebenen Verbindung, Transaktion und Verschlüsselungseinstellung.Initializes a new instance of the SqlCommand class with specified command text, connection, transaction, and encryption setting.

SqlCommand() SqlCommand() SqlCommand()

Initialisiert eine neue Instanz der SqlCommand-Klasse.Initializes a new instance of the SqlCommand class.

public:
 SqlCommand();
public SqlCommand ();
Public Sub New ()

Beispiele

Das folgende Beispiel erstellt eine SqlCommand und legt die CommandTimeout Eigenschaft.The following example creates a SqlCommand and sets the CommandTimeout property.

public void CreateSqlCommand() 
{
   SqlCommand command = new SqlCommand();
   command.CommandTimeout = 15;
   command.CommandType = CommandType.Text;
}
Public Sub CreateSqlCommand()
    Dim command As New SqlCommand()
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

Hinweise

Basiskonstruktor initialisiert alle Felder auf ihre Standardwerte zurück.The base constructor initializes all fields to their default values. In der folgende Tabelle werden die anfänglichen Eigenschaftenwerte für eine Instanz von SqlCommand.The following table shows initial property values for an instance of SqlCommand.

EigenschaftenProperties AnfangswertInitial value
CommandText eine leere Zeichenfolge ("")empty string ("")
CommandTimeout 3030
CommandType CommandType.Text
Connection NullNull

Sie können den Wert für eine dieser Eigenschaften über einen separaten Aufruf der Eigenschaft ändern.You can change the value for any of these properties through a separate call to the property.

Siehe auch

SqlCommand(String) SqlCommand(String) SqlCommand(String) SqlCommand(String)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage.Initializes a new instance of the SqlCommand class with the text of the query.

public:
 SqlCommand(System::String ^ cmdText);
public SqlCommand (string cmdText);
new System.Data.SqlClient.SqlCommand : string -> System.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String)

Parameter

cmdText
String String String String

Der Text der Abfrage.The text of the query.

Beispiele

Das folgende Beispiel erstellt eine SqlCommand, und übergeben Sie die Verbindung und der Befehlstext Text.The following example creates a SqlCommand, passing in the connection string and command text.

public void CreateCommand() 
 {
    string queryString = "SELECT * FROM Categories ORDER BY CategoryID";
    SqlCommand command = new SqlCommand(queryString);
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }
Public Sub CreateCommand()
    Dim queryString As String = "SELECT * FROM Categories ORDER BY CategoryID"
    Dim command As New SqlCommand(queryString)
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub 

Hinweise

Wenn eine Instanz des SqlCommand erstellt wird, werden die folgenden Lese-/Schreibzugriff auf die ursprünglichen Werte Eigenschaften festgelegt werden.When an instance of SqlCommand is created, the following read/write properties are set to initial values.

EigenschaftenProperties AnfangswertInitial value
CommandText cmdText
CommandTimeout 3030
CommandType CommandType.Text
Connection NULLnull

Sie können den Wert für eine dieser Eigenschaften über einen separaten Aufruf der Eigenschaft ändern.You can change the value for any of these properties through a separate call to the property.

Siehe auch

SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage und einer SqlConnection.Initializes a new instance of the SqlCommand class with the text of the query and a SqlConnection.

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection);
public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection);
new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection -> System.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String, connection As SqlConnection)

Parameter

cmdText
String String String String

Der Text der Abfrage.The text of the query.

connection
SqlConnection SqlConnection SqlConnection SqlConnection

Eine SqlConnection, die die Verbindung mit einer Instanz von SQL Server darstellt.A SqlConnection that represents the connection to an instance of SQL Server.

Beispiele

Das folgende Beispiel erstellt eine SqlCommand und legt einige ihrer Eigenschaften.The following example creates a SqlCommand and sets some of its properties.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        SqlDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine(String.Format("{0}, {1}",
                reader[0], reader[1]));
        }
    }
}
Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)

        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
            While reader.Read()
            Console.WriteLine(String.Format("{0}, {1}", _
                reader(0), reader(1)))
        End While
    End Using
End Sub

Hinweise

In der folgende Tabelle werden die anfänglichen Eigenschaftenwerte für eine Instanz von SqlCommand.The following table shows initial property values for an instance of SqlCommand.

EigenschaftenProperties AnfangswertInitial value
CommandText cmdText
CommandTimeout 3030
CommandType CommandType.Text
Connection Ein neues SqlConnection , das der Wert für die connection Parameter.A new SqlConnection that is the value for the connection parameter.

Sie können den Wert für diese Parameter ändern, indem Sie die entsprechende Eigenschaft festlegen.You can change the value for any of these parameters by setting the related property.

Siehe auch

SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage, einer SqlConnection und der SqlTransaction.Initializes a new instance of the SqlCommand class with the text of the query, a SqlConnection, and the SqlTransaction.

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlTransaction ^ transaction);
public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlTransaction transaction);
new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlTransaction -> System.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction)

Parameter

cmdText
String String String String

Der Text der Abfrage.The text of the query.

connection
SqlConnection SqlConnection SqlConnection SqlConnection

Eine SqlConnection, die die Verbindung mit einer Instanz von SQL Server darstellt.A SqlConnection that represents the connection to an instance of SQL Server.

transaction
SqlTransaction SqlTransaction SqlTransaction SqlTransaction

Die SqlTransaction, in der der SqlCommand ausgeführt wird.The SqlTransaction in which the SqlCommand executes.

Hinweise

In der folgende Tabelle werden die anfänglichen Eigenschaftenwerte für eine Instanz von SqlCommand.The following table shows initial property values for an instance of SqlCommand.

EigenschaftenProperties AnfangswertInitial value
CommandText cmdText
CommandTimeout 3030
CommandType CommandType.Text
Connection Ein neues SqlConnection , das der Wert für die connection Parameter.A new SqlConnection that is the value for the connection parameter.

Sie können den Wert für diese Parameter ändern, indem Sie die entsprechende Eigenschaft festlegen.You can change the value for any of these parameters by setting the related property.

Siehe auch

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem angegebenen Befehlstext sowie mit der angegebenen Verbindung, Transaktion und Verschlüsselungseinstellung.Initializes a new instance of the SqlCommand class with specified command text, connection, transaction, and encryption setting.

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlTransaction ^ transaction, System::Data::SqlClient::SqlCommandColumnEncryptionSetting columnEncryptionSetting);
public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlTransaction transaction, System.Data.SqlClient.SqlCommandColumnEncryptionSetting columnEncryptionSetting);
new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlTransaction * System.Data.SqlClient.SqlCommandColumnEncryptionSetting -> System.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction, columnEncryptionSetting As SqlCommandColumnEncryptionSetting)

Parameter

cmdText
String String String String

Der Text der Abfrage.The text of the query.

connection
SqlConnection SqlConnection SqlConnection SqlConnection

Eine SqlConnection, die die Verbindung mit einer Instanz von SQL Server darstellt.A SqlConnection that represents the connection to an instance of SQL Server.

transaction
SqlTransaction SqlTransaction SqlTransaction SqlTransaction

Die SqlTransaction, in der der SqlCommand ausgeführt wird.The SqlTransaction in which the SqlCommand executes.

columnEncryptionSetting
SqlCommandColumnEncryptionSetting SqlCommandColumnEncryptionSetting SqlCommandColumnEncryptionSetting SqlCommandColumnEncryptionSetting

Die Verschlüsselungseinstellung.The encryption setting. Weitere Informationen finden Sie unter Always Encrypted.For more information, see Always Encrypted.

Gilt für: