SqlCommand Konstruktoren

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;


    public void CreateSqlCommand()
    {
        SqlCommand command = new SqlCommand();
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }
    // </Snippet1>
}

Hinweise

Der Basiskonstruktor initialisiert alle Felder mit ihren Standardwerten. Die folgende Tabelle zeigt die anfänglichen Eigenschaftswerte für eine Instanz 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.

SqlCommand(String)

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

public:
 SqlCommand(System::String ^ cmdText);

public SqlCommand (string cmdText);

new Microsoft.Data.SqlClient.SqlCommand : string -> Microsoft.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String)

Parameter

cmdText

String

Der Text der Abfrage.

Beispiele

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

using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;


    public void CreateCommand()
    {
        string queryString = "SELECT * FROM Categories ORDER BY CategoryID";
        SqlCommand command = new SqlCommand(queryString);
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }

Hinweise

Wenn eine Instanz 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.

SqlCommand(String, SqlConnection)

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

public:
 SqlCommand(System::String ^ cmdText, Microsoft::Data::SqlClient::SqlConnection ^ connection);

public SqlCommand (string cmdText, Microsoft.Data.SqlClient.SqlConnection connection);

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection -> Microsoft.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.

using System;
using System.Data;
using Microsoft.Data.SqlClient;


namespace SqlCommandCS
{
    class Program
    {
        static void Main()
        {
            string str = "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
            string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
            CreateCommand(qs, str);

        }

        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]));
                }
            }
        }

Hinweise

Die folgende Tabelle zeigt die anfänglichen Eigenschaftswerte für eine Instanz 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.

SqlCommand(String, SqlConnection, SqlTransaction)

Initialisiert eine neue Instanz der SqlCommand -Klasse mit dem Text der Abfrage, einem SqlConnection und dem SqlTransaction .

public:
 SqlCommand(System::String ^ cmdText, Microsoft::Data::SqlClient::SqlConnection ^ connection, Microsoft::Data::SqlClient::SqlTransaction ^ transaction);

public SqlCommand (string cmdText, Microsoft.Data.SqlClient.SqlConnection connection, Microsoft.Data.SqlClient.SqlTransaction transaction);

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction -> Microsoft.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 Instanz 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.

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, Microsoft::Data::SqlClient::SqlConnection ^ connection, Microsoft::Data::SqlClient::SqlTransaction ^ transaction, Microsoft::Data::SqlClient::SqlCommandColumnEncryptionSetting columnEncryptionSetting);

public SqlCommand (string cmdText, Microsoft.Data.SqlClient.SqlConnection connection, Microsoft.Data.SqlClient.SqlTransaction transaction, Microsoft.Data.SqlClient.SqlCommandColumnEncryptionSetting columnEncryptionSetting);

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction * Microsoft.Data.SqlClient.SqlCommandColumnEncryptionSetting -> Microsoft.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.