SqlCommand Konstruktory

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v7.0.1

Přetížení

Name	Description
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 .SqlConnection
SqlCommand(String, SqlConnection, SqlTransaction)	Inicializuje novou instanci SqlCommand třídy s textem dotazu, a SqlConnectionSqlTransaction.
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	Inicializuje novou instanci SqlCommand třídy se zadaným textem příkazu, připojením, transakcí a nastavením šifrování.

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.

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

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

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

Poznámky

Základní konstruktor inicializuje všechna pole na výchozí hodnoty. V následující tabulce jsou uvedeny počáteční hodnoty vlastností pro instanci SqlCommand.

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

Hodnotu kterékoli z těchto vlastností můžete změnit prostřednictvím 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ří příkaz , SqlCommandpředávání textu příkazu.

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

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 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	Text
Connection	null

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

SqlCommand(String, SqlConnection)

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

SqlConnection představující 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

V následující tabulce jsou uvedeny počáteční hodnoty vlastností pro instanci SqlCommand.

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

Hodnotu některého 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, a SqlConnectionSqlTransaction.

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

SqlConnection představující připojení k instanci SQL Server.

transaction

SqlTransaction

To SqlTransaction , ve kterém se SqlCommand spouští.

Poznámky

V následující tabulce jsou uvedeny počáteční hodnoty vlastností pro instanci SqlCommand.

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

Hodnotu některého 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 nastavením šifrování.

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

SqlConnection představující připojení k instanci SQL Server.

transaction

SqlTransaction

To SqlTransaction , ve kterém se SqlCommand spouští.

columnEncryptionSetting

SqlCommandColumnEncryptionSetting

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