SqlCommand Konstruktoren

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Assemblys:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der SqlCommand-Klasse.

Überlädt

SqlCommand()	Initialisiert eine neue Instanz der SqlCommand-Klasse.
SqlCommand(String)	Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage.
SqlCommand(String, SqlConnection)	Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage und einer SqlConnection.
SqlCommand(String, SqlConnection, SqlTransaction)	Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage, einer SqlConnection und der SqlTransaction.
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.

SqlCommand()

Initialisiert eine neue Instanz der SqlCommand-Klasse.

public:
 SqlCommand();

public SqlCommand ();

Public Sub New ()

Beispiele

Im folgenden Beispiel wird eine SqlCommand erstellt und die CommandTimeout -Eigenschaft festgelegt.

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

Der Basiskonstruktor initialisiert alle Felder mit ihren Standardwerten. Die folgende Tabelle zeigt die anfänglichen Eigenschaftswerte für eine instance von SqlCommand.

Eigenschaften	Anfangswert
CommandText	leere Zeichenfolge ("")
CommandTimeout	30
CommandType	`CommandType.Text`
Connection	Null

Sie können den Wert für jede dieser Eigenschaften durch einen separaten Aufruf der -Eigenschaft ändern.

Weitere Informationen

Gilt für:

SqlCommand(String)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage.

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

Der Text der Abfrage.

Beispiele

Im folgenden Beispiel wird ein SqlCommanderstellt, das den Verbindungszeichenfolge und den Befehlstext übergibt.

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 ein instance von SqlCommand erstellt wird, werden die folgenden Lese-/Schreibeigenschaften auf Anfangswerte festgelegt.

Eigenschaften	Anfangswert
CommandText	`cmdText`
CommandTimeout	30
CommandType	`CommandType.Text`
Connection	NULL

Sie können den Wert für jede dieser Eigenschaften durch einen separaten Aufruf der -Eigenschaft ändern.

Weitere Informationen

Gilt für:

SqlCommand(String, SqlConnection)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage und einer 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

Der Text der Abfrage.

connection: SqlConnection

Eine SqlConnection, die die Verbindung mit einer Instanz von SQL Server darstellt.

Beispiele

Im folgenden Beispiel wird ein SqlCommand erstellt und einige seiner Eigenschaften festgelegt.

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

Die folgende Tabelle zeigt die anfänglichen Eigenschaftswerte für eine instance von SqlCommand.

Eigenschaften	Anfangswert
CommandText	`cmdText`
CommandTimeout	30
CommandType	`CommandType.Text`
Connection	Ein neues SqlConnection , das der Wert für den `connection` Parameter ist.

Sie können den Wert für jeden dieser Parameter ändern, indem Sie die zugehörige Eigenschaft festlegen.

Weitere Informationen

Gilt für:

SqlCommand(String, SqlConnection, SqlTransaction)

Initialisiert eine neue Instanz der SqlCommand-Klasse mit dem Text der Abfrage, einer SqlConnection und der 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

Der Text der Abfrage.

connection: SqlConnection

Eine SqlConnection, die die Verbindung mit einer Instanz von SQL Server darstellt.

transaction: SqlTransaction

Die SqlTransaction, in der der SqlCommand ausgeführt wird.

Hinweise

Die folgende Tabelle zeigt die anfänglichen Eigenschaftswerte für eine instance von SqlCommand.

Eigenschaften	Anfangswert
CommandText	`cmdText`
CommandTimeout	30
CommandType	`CommandType.Text`
Connection	Ein neues SqlConnection , das der Wert für den `connection` Parameter ist.

Sie können den Wert für jeden dieser Parameter ändern, indem Sie die zugehörige Eigenschaft festlegen.

Weitere Informationen

Gilt für:

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.

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

Der Text der Abfrage.

connection: SqlConnection

Eine SqlConnection, die die Verbindung mit einer Instanz von SQL Server darstellt.

transaction: SqlTransaction

Die SqlTransaction, in der der SqlCommand ausgeführt wird.

columnEncryptionSetting: SqlCommandColumnEncryptionSetting

Die Verschlüsselungseinstellung. Weitere Informationen hierzu finden Sie unter Always Encrypted.

Gilt für:

Freigeben über

SqlCommand Konstruktoren

Definition

Überlädt

SqlCommand()

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlCommand(String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlCommand(String, SqlConnection)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlCommand(String, SqlConnection, SqlTransaction)

Parameter

Hinweise

Weitere Informationen

Gilt für:

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Parameter

Gilt für:

Zusätzliche Ressourcen