SqlCommand Konstruktory

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Přetížení

SqlCommand()	Inicializuje novou instanci SqlCommand třídy .
SqlCommand(String)	Inicializuje novou instanci SqlCommand třídy s textem dotazu.
SqlCommand(String, SqlConnection)	Inicializuje novou instanci SqlCommand třídy s textem dotazu a objektem SqlConnection .
SqlCommand(String, SqlConnection, SqlTransaction)	Inicializuje novou instanci SqlCommand třídy s textem dotazu , SqlConnection a SqlTransaction .
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	Inicializuje novou instanci SqlCommand třídy se zadaným textem příkazu, připojením, transakcí a šifrování nastavení.

SqlCommand()

Inicializuje novou instanci SqlCommand třídy .

public:
 SqlCommand();

public SqlCommand ();

Public Sub New ()

Příklady

Následující příklad vytvoří SqlCommand a nastaví CommandTimeout vlastnost .

// <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>
}

Poznámky

Základní konstruktor inicializuje všechna pole na výchozí hodnoty. Následující tabulka uvádí počáteční hodnoty vlastností pro instanci .SqlCommand

Vlastnosti	Počáteční hodnota
CommandText	prázdný řetězec ("")
CommandTimeout	30
CommandType	CommandType.Text
Connection	Null

Hodnotu kterékoli z těchto vlastností můžete změnit pomocí samostatného volání vlastnosti .

SqlCommand(String)

Inicializuje novou instanci SqlCommand třídy s textem dotazu.

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)

Parametry

cmdText

String

Text dotazu

Příklady

Následující příklad vytvoří a SqlCommandpředá připojovací řetězec a text příkazu.

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

Poznámky

Při vytvoření instance objektu SqlCommand jsou následující vlastnosti pro čtení a zápis nastaveny na počáteční hodnoty.

Vlastnosti	Počáteční hodnota
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	null

Hodnotu kterékoli z těchto vlastností můžete změnit pomocí samostatného volání vlastnosti .

SqlCommand(String, SqlConnection)

Inicializuje novou instanci SqlCommand třídy s textem dotazu a objektem 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)

Parametry

cmdText

String

Text dotazu

connection

SqlConnection

ASqlConnection, který představuje připojení k instanci SQL Server.

Příklady

Následující příklad vytvoří SqlCommand a nastaví některé jeho vlastnosti.

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

Poznámky

Následující tabulka uvádí počáteční hodnoty vlastností pro instanci .SqlCommand

Vlastnosti	Počáteční hodnota
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	Nový SqlConnection , který je hodnotou parametru connection .

Hodnotu kteréhokoli z těchto parametrů můžete změnit nastavením související vlastnosti.

SqlCommand(String, SqlConnection, SqlTransaction)

Inicializuje novou instanci SqlCommand třídy s textem dotazu , SqlConnection a 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)

Parametry

cmdText

String

Text dotazu

connection

SqlConnection

ASqlConnection, který představuje připojení k instanci SQL Server.

transaction

SqlTransaction

Hodnota SqlTransaction , ve které se SqlCommand provede.

Poznámky

Následující tabulka uvádí počáteční hodnoty vlastností pro instanci .SqlCommand

Vlastnosti	Počáteční hodnota
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	Nový SqlConnection , který je hodnotou parametru connection .

Hodnotu kteréhokoli z těchto parametrů můžete změnit nastavením související vlastnosti.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Inicializuje novou instanci SqlCommand třídy se zadaným textem příkazu, připojením, transakcí a šifrování nastavení.

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)

Parametry

cmdText

String

Text dotazu

connection

SqlConnection

ASqlConnection, který představuje připojení k instanci SQL Server.

transaction

SqlTransaction

Hodnota SqlTransaction , ve které se SqlCommand provede.

columnEncryptionSetting

SqlCommandColumnEncryptionSetting

Nastavení šifrování. Další informace najdete v tématu Always Encrypted.