SqlCommand Osztály

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Egy SQL Server adatbázison végrehajtandó Transact-SQL utasítást vagy tárolt eljárást jelöl. Ez az osztály nem örökölhető.

public ref class SqlCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class SqlCommand : System.Data.Common.DbCommand, ICloneable

type SqlCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class SqlCommand
Inherits DbCommand
Implements ICloneable

Öröklődés

Object

MarshalByRefObject

Component

DbCommand

SqlCommand

Megvalósítás

ICloneable

Példák

Az alábbi példa létrehoz egy SqlConnection, egy SqlCommandés egy SqlDataReader. A példa végigolvassa az adatokat, és beírja a konzolra. Végül a példa bezárja a SqlDataReader kódblokkokat, majd SqlConnection kilép a Using kódblokkokból.

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
    }
}

Public Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0}, {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Az alábbi minta bemutatja, hogyan hozhat létre és hajthat végre különböző típusú SqlCommand objektumokat.

Először létre kell hoznia a mintaadatbázist a következő szkript végrehajtásával:

USE [master]
GO

CREATE DATABASE [MySchool]
GO

USE [MySchool]
GO

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
CREATE procedure [dbo].[CourseExtInfo] @CourseId int
as
select c.CourseID,c.Title,c.Credits,d.Name as DepartmentName
from Course as c left outer join Department as d on c.DepartmentID=d.DepartmentID
where c.CourseID=@CourseId

GO

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
create procedure [dbo].[DepartmentInfo] @DepartmentId int,@CourseCount int output
as
select @CourseCount=Count(c.CourseID)
from course as c
where c.DepartmentID=@DepartmentId

select d.DepartmentID,d.Name,d.Budget,d.StartDate,d.Administrator
from Department as d
where d.DepartmentID=@DepartmentId

GO

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
Create PROCEDURE [dbo].[GetDepartmentsOfSpecifiedYear]
@Year int,@BudgetSum money output
AS
BEGIN
        SELECT @BudgetSum=SUM([Budget])
  FROM [MySchool].[dbo].[Department]
  Where YEAR([StartDate])=@Year

SELECT [DepartmentID]
      ,[Name]
      ,[Budget]
      ,[StartDate]
      ,[Administrator]
  FROM [MySchool].[dbo].[Department]
  Where YEAR([StartDate])=@Year

END
GO

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
CREATE TABLE [dbo].[Course]([CourseID] [nvarchar](10) NOT NULL,
[Year] [smallint] NOT NULL,
[Title] [nvarchar](100) NOT NULL,
[Credits] [int] NOT NULL,
[DepartmentID] [int] NOT NULL,
 CONSTRAINT [PK_Course] PRIMARY KEY CLUSTERED
(
[CourseID] ASC,
[Year] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY]

GO

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
CREATE TABLE [dbo].[Department]([DepartmentID] [int] IDENTITY(1,1) NOT NULL,
[Name] [nvarchar](50) NOT NULL,
[Budget] [money] NOT NULL,
[StartDate] [datetime] NOT NULL,
[Administrator] [int] NULL,
 CONSTRAINT [PK_Department] PRIMARY KEY CLUSTERED
(
[DepartmentID] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY]

GO

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
CREATE TABLE [dbo].[Person]([PersonID] [int] IDENTITY(1,1) NOT NULL,
[LastName] [nvarchar](50) NOT NULL,
[FirstName] [nvarchar](50) NOT NULL,
[HireDate] [datetime] NULL,
[EnrollmentDate] [datetime] NULL,
 CONSTRAINT [PK_School.Student] PRIMARY KEY CLUSTERED
(
[PersonID] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY]

GO

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
CREATE TABLE [dbo].[StudentGrade]([EnrollmentID] [int] IDENTITY(1,1) NOT NULL,
[CourseID] [nvarchar](10) NOT NULL,
[StudentID] [int] NOT NULL,
[Grade] [decimal](3, 2) NOT NULL,
 CONSTRAINT [PK_StudentGrade] PRIMARY KEY CLUSTERED
(
[EnrollmentID] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY]

GO

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
create view [dbo].[EnglishCourse]
as
select c.CourseID,c.Title,c.Credits,c.DepartmentID
from Course as c join Department as d on c.DepartmentID=d.DepartmentID
where d.Name=N'English'

GO
INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C1045', 2012, N'Calculus', 4, 7)
INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C1061', 2012, N'Physics', 4, 1)
INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C2021', 2012, N'Composition', 3, 2)
INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C2042', 2012, N'Literature', 4, 2)
SET IDENTITY_INSERT [dbo].[Department] ON

INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (1, N'Engineering', 350000.0000, CAST(0x0000999C00000000 AS DateTime), 2)
INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (2, N'English', 120000.0000, CAST(0x0000999C00000000 AS DateTime), 6)
INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (4, N'Economics', 200000.0000, CAST(0x0000999C00000000 AS DateTime), 4)
INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (7, N'Mathematics', 250024.0000, CAST(0x0000999C00000000 AS DateTime), 3)
SET IDENTITY_INSERT [dbo].[Department] OFF
SET IDENTITY_INSERT [dbo].[Person] ON

INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (1, N'Hu', N'Nan', NULL, CAST(0x0000A0BF00000000 AS DateTime))
INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (2, N'Norman', N'Laura', NULL, CAST(0x0000A0BF00000000 AS DateTime))
INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (3, N'Olivotto', N'Nino', NULL, CAST(0x0000A0BF00000000 AS DateTime))
INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (4, N'Anand', N'Arturo', NULL, CAST(0x0000A0BF00000000 AS DateTime))
INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (5, N'Jai', N'Damien', NULL, CAST(0x0000A0BF00000000 AS DateTime))
INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (6, N'Holt', N'Roger', CAST(0x000097F100000000 AS DateTime), NULL)
INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (7, N'Martin', N'Randall', CAST(0x00008B1A00000000 AS DateTime), NULL)
SET IDENTITY_INSERT [dbo].[Person] OFF
SET IDENTITY_INSERT [dbo].[StudentGrade] ON

INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (1, N'C1045', 1, CAST(3.50 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (2, N'C1045', 2, CAST(3.00 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (3, N'C1045', 3, CAST(2.50 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (4, N'C1045', 4, CAST(4.00 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (5, N'C1045', 5, CAST(3.50 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (6, N'C1061', 1, CAST(4.00 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (7, N'C1061', 3, CAST(3.50 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (8, N'C1061', 4, CAST(2.50 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (9, N'C1061', 5, CAST(1.50 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (10, N'C2021', 1, CAST(2.50 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (11, N'C2021', 2, CAST(3.50 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (12, N'C2021', 4, CAST(3.00 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (13, N'C2021', 5, CAST(3.00 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (14, N'C2042', 1, CAST(2.00 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (15, N'C2042', 2, CAST(3.50 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (16, N'C2042', 3, CAST(4.00 AS Decimal(3, 2)))
INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (17, N'C2042', 5, CAST(3.00 AS Decimal(3, 2)))
SET IDENTITY_INSERT [dbo].[StudentGrade] OFF
ALTER TABLE [dbo].[Course]  WITH CHECK ADD  CONSTRAINT [FK_Course_Department] FOREIGN KEY([DepartmentID])
REFERENCES [dbo].[Department] ([DepartmentID])
GO
ALTER TABLE [dbo].[Course] CHECK CONSTRAINT [FK_Course_Department]
GO
ALTER TABLE [dbo].[StudentGrade]  WITH CHECK ADD  CONSTRAINT [FK_StudentGrade_Student] FOREIGN KEY([StudentID])
REFERENCES [dbo].[Person] ([PersonID])
GO
ALTER TABLE [dbo].[StudentGrade] CHECK CONSTRAINT [FK_StudentGrade_Student]
GO

Ezután fordítsa le és hajtsa végre a következőt:

using System;
using System.Data;
using System.Data.SqlClient;
using System.Threading.Tasks;

class Program {

   static class SqlHelper {
      // Set the connection, command, and then execute the command with non query.
      public static Int32 ExecuteNonQuery(String connectionString, String commandText,
          CommandType commandType, params SqlParameter[] parameters) {
         using (SqlConnection conn = new SqlConnection(connectionString)) {
            using (SqlCommand cmd = new SqlCommand(commandText, conn)) {
               // There're three command types: StoredProcedure, Text, TableDirect. The TableDirect
               // type is only for OLE DB.
               cmd.CommandType = commandType;
               cmd.Parameters.AddRange(parameters);

               conn.Open();
               return cmd.ExecuteNonQuery();
            }
         }
      }

      // Set the connection, command, and then execute the command and only return one value.
      public static Object ExecuteScalar(String connectionString, String commandText,
          CommandType commandType, params SqlParameter[] parameters) {
         using (SqlConnection conn = new SqlConnection(connectionString)) {
            using (SqlCommand cmd = new SqlCommand(commandText, conn)) {
               cmd.CommandType = commandType;
               cmd.Parameters.AddRange(parameters);

               conn.Open();
               return cmd.ExecuteScalar();
            }
         }
      }

      // Set the connection, command, and then execute the command with query and return the reader.
      public static SqlDataReader ExecuteReader(String connectionString, String commandText,
          CommandType commandType, params SqlParameter[] parameters) {
         SqlConnection conn = new SqlConnection(connectionString);

         using (SqlCommand cmd = new SqlCommand(commandText, conn)) {
            cmd.CommandType = commandType;
            cmd.Parameters.AddRange(parameters);

            conn.Open();
            // When using CommandBehavior.CloseConnection, the connection will be closed when the
            // IDataReader is closed.
            SqlDataReader reader = cmd.ExecuteReader(CommandBehavior.CloseConnection);

            return reader;
         }
      }
   }

   static void Main(string[] args) {
      String connectionString = "Data Source=(local);Initial Catalog=MySchool;Integrated Security=True;Asynchronous Processing=true;";

      CountCourses(connectionString, 2012);
      Console.WriteLine();

      Console.WriteLine("Following result is the departments that started from 2007:");
      GetDepartments(connectionString, 2007);
      Console.WriteLine();

      Console.WriteLine("Add the credits when the credits of course is lower than 4.");
      AddCredits(connectionString, 4);
      Console.WriteLine();

      Console.WriteLine("Please press any key to exit...");
      Console.ReadKey();
   }

   static void CountCourses(String connectionString, Int32 year) {
      String commandText = "Select Count([CourseID]) FROM [MySchool].[dbo].[Course] Where Year=@Year";
      SqlParameter parameterYear = new SqlParameter("@Year", SqlDbType.Int);
      parameterYear.Value = year;

      Object oValue = SqlHelper.ExecuteScalar(connectionString, commandText, CommandType.Text, parameterYear);
      Int32 count;
      if (Int32.TryParse(oValue.ToString(), out count))
         Console.WriteLine("There {0} {1} course{2} in {3}.", count > 1 ? "are" : "is", count, count > 1 ? "s" : null, year);
   }

   // Display the Departments that start from the specified year.
   static void GetDepartments(String connectionString, Int32 year) {
      String commandText = "dbo.GetDepartmentsOfSpecifiedYear";

      // Specify the year of StartDate
      SqlParameter parameterYear = new SqlParameter("@Year", SqlDbType.Int);
      parameterYear.Value = year;

      // When the direction of parameter is set as Output, you can get the value after
      // executing the command.
      SqlParameter parameterBudget = new SqlParameter("@BudgetSum", SqlDbType.Money);
      parameterBudget.Direction = ParameterDirection.Output;

      using (SqlDataReader reader = SqlHelper.ExecuteReader(connectionString, commandText,
          CommandType.StoredProcedure, parameterYear, parameterBudget)) {
         Console.WriteLine("{0,-20}{1,-20}{2,-20}{3,-20}", "Name", "Budget", "StartDate",
             "Administrator");
         while (reader.Read()) {
            Console.WriteLine("{0,-20}{1,-20:C}{2,-20:d}{3,-20}", reader["Name"],
                reader["Budget"], reader["StartDate"], reader["Administrator"]);
         }
      }
      Console.WriteLine("{0,-20}{1,-20:C}", "Sum:", parameterBudget.Value);
   }

   // If credits of course is lower than the certain value, the method will add the credits.
   static void AddCredits(String connectionString, Int32 creditsLow) {
      String commandText = "Update [MySchool].[dbo].[Course] Set Credits=Credits+1 Where Credits<@Credits";

      SqlParameter parameterCredits = new SqlParameter("@Credits", creditsLow);

      Int32 rows = SqlHelper.ExecuteNonQuery(connectionString, commandText, CommandType.Text, parameterCredits);

      Console.WriteLine("{0} row{1} {2} updated.", rows, rows > 1 ? "s" : null, rows > 1 ? "are" : "is");
   }
}

Megjegyzések

Amikor létrejön egy példány SqlCommand , az olvasási/írási tulajdonságok a kezdeti értékükre lesznek állítva. Ezeknek az értékeknek a listáját a konstruktorban SqlCommand találja.

SqlCommand a parancsok SQL Server adatbázisban való végrehajtásának alábbi módszereit tartalmazza:

Termék	Leírás
BeginExecuteNonQuery	Elindítja a Transact-SQL utasítás vagy a SqlCommand által leírt tárolt eljárás aszinkron végrehajtását, általában olyan parancsokat hajt végre, mint az INSERT, a DELETE, az UPDATE és a SET utasítás. Minden egyes hívást BeginExecuteNonQuery párosítani kell egy hívással EndExecuteNonQuery, amely befejezi a műveletet, általában egy külön szálon.
BeginExecuteReader	Elindítja a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet ez a SqlCommand ír le, és lekéri egy vagy több eredményhalmazt a kiszolgálóról. Minden egyes hívást BeginExecuteReader párosítani kell egy hívással EndExecuteReader, amely befejezi a műveletet, általában egy külön szálon.
BeginExecuteXmlReader	Elindítja a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet az SqlCommand ír le. Minden egyes hívást BeginExecuteXmlReader párosítani kell egy hívással EndExecuteXmlReader, amely befejezi a műveletet, általában egy külön szálon, és egy XmlReader objektumot ad vissza.
ExecuteReader	Sorokat visszaadó parancsokat hajt végre. A nagyobb teljesítmény érdekében ExecuteReader parancsokat hív meg a Transact-SQL sp_executesql rendszer által tárolt eljárással. Ezért előfordulhat, hogy a ExecuteReader nem lesz olyan hatással, amelyet parancsok, például Transact-SQL SET utasítások végrehajtására használna.
ExecuteNonQuery	Olyan parancsokat hajt végre, mint az Transact-SQL INSERT, DELETE, UPDATE és SET utasítás.
ExecuteScalar	Egyetlen értéket (például összesített értéket) kér le egy adatbázisból.
ExecuteXmlReader	Elküldi az CommandText objektumot, Connection és létrehoz egy objektumot XmlReader .

Alaphelyzetbe állíthatja a CommandText tulajdonságot, és újra felhasználhatja az SqlCommand objektumot. Azonban be kell zárnia a SqlDataReader parancsot, mielőtt végrehajthat egy új vagy egy korábbi parancsot.

Ha a metódus végrehajtó SqlExceptionmetódusa hoz létre egy SqlCommand értéket, a SqlConnection rendszer akkor is nyitva marad, ha a súlyossági szint 19 vagy annál kisebb. Ha a súlyossági szint 20 vagy nagyobb, a kiszolgáló általában bezárja a SqlConnection. A felhasználó azonban újra megnyithatja a kapcsolatot, és folytathatja azt.

Note

A névtelen, más néven sorszámú paramétereket a .NET-keretrendszer Data Provider nem támogatja SQL Server.

Konstruktorok

Name	Description
SqlCommand()	Inicializálja a SqlCommand osztály új példányát.
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	Inicializálja az osztály új példányát a SqlCommand megadott parancsszöveggel, kapcsolattal, tranzakcióval és titkosítási beállítással.
SqlCommand(String, SqlConnection, SqlTransaction)	Inicializálja az SqlCommand osztály új példányát a lekérdezés szövegével, az a SqlConnectionés a SqlTransaction.
SqlCommand(String, SqlConnection)	Inicializálja az SqlCommand osztály új példányát a lekérdezés szövegével és egy SqlConnection.
SqlCommand(String)	Inicializálja az SqlCommand osztály új példányát a lekérdezés szövegével.

Tulajdonságok

Name	Description
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
ColumnEncryptionSetting	Lekéri vagy beállítja a parancs oszloptitkosítási beállítását.
CommandText	Lekéri vagy beállítja az adatforrásban végrehajtandó Transact-SQL utasítást, táblanevet vagy tárolt eljárást.
CommandTimeout	Lekéri vagy beállítja a várakozási időt (másodpercben), mielőtt befejezi a parancs végrehajtására tett kísérletet, és hibát okozna.
CommandType	Lekéri vagy beállítja a CommandText tulajdonság értelmezésének módját jelző értéket.
Connection	Lekéri vagy beállítja a SqlConnection példány által SqlCommandhasznált .
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
DbConnection	Lekéri vagy beállítja a DbConnection használt elemet.DbCommand (Öröklődés forrása DbCommand)
DbParameterCollection	Lekéri az objektumok gyűjteményét DbParameter . (Öröklődés forrása DbCommand)
DbTransaction	Lekéri vagy beállítja az DbTransaction objektum végrehajtásának DbCommand alapjául szolgáló objektumot. (Öröklődés forrása DbCommand)
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
DesignTimeVisible	Lekéri vagy beállít egy értéket, amely jelzi, hogy a parancsobjektum látható legyen-e egy Windows Űrlaptervező vezérlőelemben.
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
Notification	Lekéri vagy beállítja a SqlNotificationRequest parancshoz kötött objektumot meghatározó értéket.
NotificationAutoEnlist	Lekéri vagy beállít egy értéket, amely jelzi, hogy az alkalmazásnak automatikusan le kell-e kapnia a lekérdezési értesítéseket egy közös SqlDependency objektumból.
Parameters	Lekéri a SqlParameterCollection.
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)
Transaction	Lekéri vagy beállítja a SqlTransaction végrehajtást SqlCommand .
UpdatedRowSource	Lekérdezi vagy beállítja, hogy a parancseredmények hogyan legyenek alkalmazva a DataRow parancs frissítési metódusa DbDataAdapteráltal használt parancsokra.

Metódusok

Name	Description
BeginExecuteNonQuery()	Elindítja a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet az SqlCommand ír le.
BeginExecuteNonQuery(AsyncCallback, Object)	Kezdeményezi a Transact-SQL utasítás vagy a SqlCommand által leírt tárolt eljárás aszinkron végrehajtását visszahívási eljárás és állapotinformációk alapján.
BeginExecuteReader()	Elindítja a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet ez a SqlCommand ír le, és lekéri egy vagy több eredményhalmazt a kiszolgálóról.
BeginExecuteReader(AsyncCallback, Object, CommandBehavior)	Elindítja a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet ez a SqlCommand ír le, az egyik CommandBehavior érték használatával, és lekér egy vagy több eredményhalmazt a kiszolgálóról visszahívási eljárás és állapotadatok alapján.
BeginExecuteReader(AsyncCallback, Object)	Elindítja a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet ez a SqlCommand ír le, és egy vagy több eredményhalmazt kér le a kiszolgálóról visszahívási eljárás és állapotinformációk alapján.
BeginExecuteReader(CommandBehavior)	A Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását kezdeményezi, amelyet az SqlCommand a CommandBehavior értékek egyikével ír le.
BeginExecuteXmlReader()	Elindítja a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet ez a SqlCommand ír le, és az eredményeket XmlReader objektumként adja vissza.
BeginExecuteXmlReader(AsyncCallback, Object)	Kezdeményezi a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet ez a SqlCommand ír le, és visszahívási eljárással XmlReader objektumként adja vissza az eredményeket.
Cancel()	Megpróbálja megszakítani a végrehajtást egy SqlCommand.
Clone()	Létrehoz egy új SqlCommand objektumot, amely az aktuális példány másolata.
CreateDbParameter()	Új objektumpéldányt DbParameter hoz létre. (Öröklődés forrása DbCommand)
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
CreateParameter()	Új objektumpéldányt SqlParameter hoz létre.
EndExecuteNonQuery(IAsyncResult)	Befejezi egy Transact-SQL utasítás aszinkron végrehajtását.
EndExecuteReader(IAsyncResult)	Befejezi egy Transact-SQL utasítás aszinkron végrehajtását, és visszaadja a kért SqlDataReader.
EndExecuteXmlReader(IAsyncResult)	Befejezi egy Transact-SQL utasítás aszinkron végrehajtását, és a kért adatokat XML-ként adja vissza.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
ExecuteDbDataReader(CommandBehavior)	Végrehajtja a parancsot a kapcsolaton, és visszaad egy DbDataReader olyan parancsot, amely az eredmények eléréséhez használható. (Öröklődés forrása DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	A szolgáltatóknak ezt a módszert úgy kell implementálniuk, hogy a túlterhelések nem alapértelmezett implementációt biztosítsanak ExecuteReader . Az alapértelmezett implementáció meghívja a szinkron ExecuteReader() metódust, és egy befejezett feladatot ad vissza, blokkolva a hívó szálat. Az alapértelmezett implementáció visszavont feladatot ad vissza, ha már lemondott lemondási jogkivonatot adott át. Az ExecuteReader által kiadott kivételek a visszaadott Tevékenységkivétel tulajdonságon keresztül lesznek közölve. Ez a metódus elfogad egy lemondási jogkivonatot, amely a művelet korai törlésének igénylésére használható. A megvalósítások figyelmen kívül hagyhatják ezt a kérést. (Öröklődés forrása DbCommand)
ExecuteNonQuery()	Végrehajt egy Transact-SQL utasítást a kapcsolaton, és visszaadja az érintett sorok számát.
ExecuteNonQueryAsync()	A parancsot a kapcsolati objektumon futtató aszinkron verziója ExecuteNonQuery(), amely az érintett sorok számát adja vissza. Meghívja ExecuteNonQueryAsync(CancellationToken) a CancellationToken.None parancsot. (Öröklődés forrása DbCommand)
ExecuteNonQueryAsync(CancellationToken)	A ExecuteNonQuery() aszinkron verziója, amely egy Transact-SQL utasítást hajt végre a kapcsolaton, és visszaadja az érintett sorok számát. A lemondási jogkivonat használatával kérheti a művelet megszakítását a parancs időtúllépése előtt. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
ExecuteReader()	Elküldi a CommandText elemet a Connection következőnek, és létrehoz egy SqlDataReader.
ExecuteReader(CommandBehavior)	Elküldi a CommandText elemet a Connection, és létrehoz egy SqlDataReader értéket az CommandBehavior egyik érték használatával.
ExecuteReaderAsync()	Aszinkron verziója ExecuteReader(), amely elküldi a rendszernek, CommandTextConnection és létrehoz egy SqlDataReader. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
ExecuteReaderAsync(CancellationToken)	Aszinkron verziója ExecuteReader(), amely elküldi a rendszernek, CommandTextConnection és létrehoz egy SqlDataReader. A lemondási jogkivonat használatával kérheti a művelet megszakítását a parancs időtúllépése előtt. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Aszinkron verziója ExecuteReader(CommandBehavior), amely elküldi a CommandText következőt a Connectionrendszernek, és létrehoz egy SqlDataReader A lemondási jogkivonat használatával kérheti a művelet megszakítását a parancs időtúllépése előtt. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
ExecuteReaderAsync(CommandBehavior)	A rendszer aszinkron verziója ExecuteReader(CommandBehavior), amely elküldi a CommandTextConnectionrendszernek, és létrehoz egy SqlDataReader. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
ExecuteScalar()	Végrehajtja a lekérdezést, és visszaadja a lekérdezés által visszaadott eredményhalmaz első sorának első oszlopát. A rendszer figyelmen kívül hagyja a további oszlopokat vagy sorokat.
ExecuteScalarAsync()	A parancsot végrehajtó aszinkron verzió ExecuteScalar(), amely az első visszaadott eredményhalmaz első sorának első oszlopát adja vissza. A rendszer figyelmen kívül hagyja az összes többi oszlopot, sort és eredményhalmazt. Meghívja ExecuteScalarAsync(CancellationToken) a CancellationToken.None parancsot. (Öröklődés forrása DbCommand)
ExecuteScalarAsync(CancellationToken)	A lekérdezés aszinkron verziója ExecuteScalar(), amely aszinkron módon hajtja végre a lekérdezést, és a lekérdezés által visszaadott eredményhalmaz első sorának első oszlopát adja vissza. A rendszer figyelmen kívül hagyja a további oszlopokat vagy sorokat. A lemondási jogkivonat használatával kérheti a művelet megszakítását a parancs időtúllépése előtt. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
ExecuteXmlReader()	Elküldi az CommandText objektumot, Connection és létrehoz egy objektumot XmlReader .
ExecuteXmlReaderAsync()	Aszinkron verziója ExecuteXmlReader(), amely elküldi az CommandText objektumot, Connection és létrehoz egy objektumot XmlReader . A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
ExecuteXmlReaderAsync(CancellationToken)	Aszinkron verziója ExecuteXmlReader(), amely elküldi az CommandText objektumot, Connection és létrehoz egy objektumot XmlReader . A lemondási jogkivonat használatával kérheti a művelet megszakítását a parancs időtúllépése előtt. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által ComponentContainernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
Prepare()	Létrehozza a parancs előkészített verzióját a SQL Server egy példányán.
ResetCommandTimeout()	Alaphelyzetbe állítja a CommandTimeout tulajdonságot az alapértelmezett értékre.
ToString()	String A ( ha van) nevet tartalmazó értéket Componentad vissza. Ezt a módszert nem szabad felülírni. (Öröklődés forrása Component)

esemény

Name	Description
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)
StatementCompleted	Egy Transact-SQL utasítás végrehajtása után következik be.

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Létrehoz egy új SqlCommand objektumot, amely az aktuális példány másolata.
IDbCommand.Connection	Lekéri vagy beállítja a IDbConnection példány által IDbCommandhasznált . (Öröklődés forrása DbCommand)
IDbCommand.CreateParameter()	Új objektumpéldányt IDbDataParameter hoz létre. (Öröklődés forrása DbCommand)
IDbCommand.ExecuteReader()	Végrehajtja az ellen, CommandTextConnection és létrehoz egy IDataReader. (Öröklődés forrása DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Végrehajtja az CommandText ellent Connection, és létrehoz egy IDataReader értéket az CommandBehavior egyik érték használatával. (Öröklődés forrása DbCommand)
IDbCommand.Parameters	Lekéri a IDataParameterCollection. (Öröklődés forrása DbCommand)
IDbCommand.Transaction	Lekéri vagy beállítja az DbTransaction objektum végrehajtásának DbCommand alapjául szolgáló objektumot. (Öröklődés forrása DbCommand)

Lásd még

• Adatok beolvasása és módosítása a ADO.NET
• SQL Server és ADO.NET
• ADO.NET áttekintése