SqlCommand Sınıf

Tanım

Bir SQL Server veritabanında yürütülecek bir Transact-SQL ifadesini veya saklı yordamı temsil eder.Represents a Transact-SQL statement or stored procedure to execute against a SQL Server database. Bu sınıf devralınamaz.This class cannot be inherited.

public ref class SqlCommand sealed : System::Data::Common::DbCommand, ICloneable
public ref class SqlCommand sealed : System::Data::Common::DbCommand
public ref class SqlCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class SqlCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public sealed class SqlCommand : System.Data.Common.DbCommand, ICloneable
public sealed class SqlCommand : System.Data.Common.DbCommand
public sealed class SqlCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class SqlCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
type SqlCommand = class
    inherit DbCommand
    interface ICloneable
type SqlCommand = class
    inherit DbCommand
type SqlCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface ICloneable
type SqlCommand = class
    inherit DbCommand
    interface IDbCommand
    interface ICloneable
    interface IDisposable
Public NotInheritable Class SqlCommand
Inherits DbCommand
Implements ICloneable
Public NotInheritable Class SqlCommand
Inherits DbCommand
Public NotInheritable Class SqlCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class SqlCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Devralma
SqlCommand
Devralma
Devralma
Uygulamalar

Örnekler

Aşağıdaki örnek, bir, SqlConnection ve bir oluşturur SqlCommand SqlDataReader .The following example creates a SqlConnection, a SqlCommand, and a SqlDataReader. Örnek, verileri, konsola yazarak okur.The example reads through the data, writing it to the console. Son olarak, örnek öğesini SqlDataReader ve ardından SqlConnection kod bloklarından çıktıktan sonra kapatır Using .Finally, the example closes the SqlDataReader and then the SqlConnection as it exits the Using code blocks.

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

Aşağıdaki örnek, SqlCommand nesnelerinin farklı türlerinin nasıl oluşturulduğunu ve yürütüleceğini gösterir.The following sample shows how to create and execute different types of SqlCommand objects.

İlk olarak, aşağıdaki betiği yürüterek örnek veritabanını oluşturmanız gerekir:First you must create the sample database, by executing the following script:

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  

Sonra, aşağıdakileri derleyin ve yürütün:Next, compile and execute the following:

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

Açıklamalar

Bir örneği SqlCommand oluşturulduğunda, okuma/yazma özellikleri ilk değerlerine ayarlanır.When an instance of SqlCommand is created, the read/write properties are set to their initial values. Bu değerlerin bir listesi için, SqlCommand oluşturucuya bakın.For a list of these values, see the SqlCommand constructor.

SqlCommand SQL Server veritabanında komut yürütmek için aşağıdaki yöntemleri sunar:SqlCommand features the following methods for executing commands at a SQL Server database:

ÖğeItem AçıklamaDescription
BeginExecuteNonQuery Bu SqlCommand , genellıkle INSERT, DELETE, Update ve set deyimleri gibi komutları yürüten Transact-SQL ifadesinin veya saklı yordamın zaman uyumsuz yürütmesini başlatır.Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand, generally executing commands such as INSERT, DELETE, UPDATE, and SET statements. Her bir çağrısının BeginExecuteNonQuery EndExecuteNonQuery , genellikle ayrı bir iş parçacığında işlemi bitirildiği bir çağrı ile eşleştirilmesi gerekir.Each call to BeginExecuteNonQuery must be paired with a call to EndExecuteNonQuery which finishes the operation, typically on a separate thread.
BeginExecuteReader Transact-SQL ifadesinin veya bu tarafından tanımlanan saklı yordamın zaman uyumsuz yürütmesini başlatır SqlCommand ve sunucudan bir veya daha fazla sonuç kümesi alır.Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand and retrieves one or more results sets from the server. Her bir çağrısının BeginExecuteReader EndExecuteReader , genellikle ayrı bir iş parçacığında işlemi bitirildiği bir çağrı ile eşleştirilmesi gerekir.Each call to BeginExecuteReader must be paired with a call to EndExecuteReader which finishes the operation, typically on a separate thread.
BeginExecuteXmlReader Transact-SQL ifadesinin veya bu tarafından tanımlanan saklı yordamın zaman uyumsuz yürütmesini başlatır SqlCommand .Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand. Her bir çağrısının, BeginExecuteXmlReader EndExecuteXmlReader işlemi, genellikle ayrı bir iş parçacığında ve bir nesnesi döndüren öğesine yapılan çağrısıyla eşleştirilmesi gerekir XmlReader .Each call to BeginExecuteXmlReader must be paired with a call to EndExecuteXmlReader, which finishes the operation, typically on a separate thread, and returns an XmlReader object.
ExecuteReader Satırları döndüren komutları yürütür.Executes commands that return rows. Daha yüksek performans için ExecuteReader Transact-SQL sp_executesql sistem saklı yordamını kullanarak komutları çağırır.For increased performance, ExecuteReader invokes commands using the Transact-SQL sp_executesql system stored procedure. Bu nedenle, ExecuteReader Transact-SQL set deyimleri gibi komutları yürütmek için kullanılırsa istediğiniz etkiye sahip olmayabilir.Therefore, ExecuteReader might not have the effect that you want if used to execute commands such as Transact-SQL SET statements.
ExecuteNonQuery Transact-SQL INSERT, DELETE, UPDATE ve SET deyimleri gibi komutları yürütür.Executes commands such as Transact-SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar Bir veritabanından tek bir değer (örneğin, bir toplam değeri) alır.Retrieves a single value (for example, an aggregate value) from a database.
ExecuteXmlReader ' A gönderir CommandText Connection ve bir nesnesi oluşturur XmlReader .Sends the CommandText to the Connection and builds an XmlReader object.

CommandTextÖzelliği sıfırlayabilir ve nesneyi yeniden kullanabilirsiniz SqlCommand .You can reset the CommandText property and reuse the SqlCommand object. Bununla birlikte, SqlDataReader Yeni veya önceki bir komutu yürütebilmeniz için önce ' i kapatmanız gerekir.However, you must close the SqlDataReader before you can execute a new or previous command.

Bir, SqlException çalıştıran yöntemi tarafından oluşturulduysa, SqlCommand SqlConnection önem düzeyi 19 veya daha az olduğunda açık kalır.If a SqlException is generated by the method executing a SqlCommand, the SqlConnection remains open when the severity level is 19 or less. Önem düzeyi 20 veya daha büyükse, sunucu genellikle kapatır SqlConnection .When the severity level is 20 or greater, the server ordinarily closes the SqlConnection. Ancak, Kullanıcı bağlantıyı yeniden açabilir ve devam edebilir.However, the user can reopen the connection and continue.

Not

Ad daha az, sıra olarak da bilinen parametreler, SQL Server için .NET Framework Veri Sağlayıcısı tarafından desteklenmez.Nameless, also called ordinal, parameters are not supported by the .NET Framework Data Provider for SQL Server.

Oluşturucular

SqlCommand()

SqlCommand sınıfının yeni bir örneğini başlatır.Initializes a new instance of the SqlCommand class.

SqlCommand(String)

SqlCommandSorgunun metniyle birlikte sınıfının yeni bir örneğini başlatır.Initializes a new instance of the SqlCommand class with the text of the query.

SqlCommand(String, SqlConnection)

SqlCommandSorgunun metniyle birlikte sınıfının yeni bir örneğini başlatır SqlConnection .Initializes a new instance of the SqlCommand class with the text of the query and a SqlConnection.

SqlCommand(String, SqlConnection, SqlTransaction)

SqlCommandSorgunun metnini, a ve ' i içeren, sınıfının yeni bir örneğini başlatır SqlConnection SqlTransaction .Initializes a new instance of the SqlCommand class with the text of the query, a SqlConnection, and the SqlTransaction.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

SqlCommandBelirtilen komut metni, bağlantı, işlem ve şifreleme ayarı ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the SqlCommand class with specified command text, connection, transaction, and encryption setting.

Özellikler

CanRaiseEvents

Bileşenin bir olay yapıp yapamayacağını gösteren bir değer alır.Gets a value indicating whether the component can raise an event.

(Devralındığı yer: Component)
ColumnEncryptionSetting

Bu komut için sütun şifreleme ayarını alır veya ayarlar.Gets or sets the column encryption setting for this command.

CommandText

Veri kaynağında yürütülecek Transact-SQL ifadesini, tablo adını veya saklı yordamı alır veya ayarlar.Gets or sets the Transact-SQL statement, table name or stored procedure to execute at the data source.

CommandTimeout

Bir komutu yürütme ve hata oluşturma girişimini sonlandırmadan önce bekleme süresini (saniye cinsinden) alır veya ayarlar.Gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

Özelliğin nasıl yorumlanacağını gösteren bir değer alır veya ayarlar CommandText .Gets or sets a value indicating how the CommandText property is to be interpreted.

Connection

SqlConnectionBu örneği tarafından kullanılan öğesini alır veya ayarlar SqlCommand .Gets or sets the SqlConnection used by this instance of the SqlCommand.

Container

Öğesini içeren öğesini alır IContainer Component .Gets the IContainer that contains the Component.

(Devralındığı yer: Component)
DbConnection

Türetilmiş bir sınıfta geçersiz kılındığında, bu tarafından kullanılan ' ı alır veya ayarlar DbConnection DbCommand .When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

(Devralındığı yer: DbCommand)
DbParameterCollection

Türetilmiş bir sınıfta geçersiz kılındığında, nesne koleksiyonunu alır DbParameter .When overridden in a derived class, gets the collection of DbParameter objects.

(Devralındığı yer: DbCommand)
DbTransaction

Türetilmiş bir sınıfta geçersiz kılındığında, bu nesnenin içinde çalıştırıldığı ' ı alır veya ayarlar DbTransaction DbCommand .When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

(Devralındığı yer: DbCommand)
DesignMode

Şu anda Tasarım modunda olup olmadığını gösteren bir değer alır Component .Gets a value that indicates whether the Component is currently in design mode.

(Devralındığı yer: Component)
DesignTimeVisible

Komut nesnesinin bir Windows Form Tasarımcısı denetiminde görünür olup olmayacağını gösteren bir değer alır veya ayarlar.Gets or sets a value indicating whether the command object should be visible in a Windows Form Designer control.

Events

Bu öğesine eklenen olay işleyicilerinin listesini alır Component .Gets the list of event handlers that are attached to this Component.

(Devralındığı yer: Component)
Notification

Bu komuta bağlanan nesneyi belirten bir değer alır veya ayarlar SqlNotificationRequest .Gets or sets a value that specifies the SqlNotificationRequest object bound to this command.

NotificationAutoEnlist

Uygulamanın ortak bir nesneden sorgu bildirimlerini otomatik olarak alıp almamayı gösteren bir değer alır veya ayarlar SqlDependency .Gets or sets a value indicating whether the application should automatically receive query notifications from a common SqlDependency object.

Parameters

SqlParameterCollection öğesini alır.Gets the SqlParameterCollection.

Site

Öğesini alır veya ayarlar ISite Component .Gets or sets the ISite of the Component.

(Devralındığı yer: Component)
Transaction

SqlTransactionİçindeki yürütmelerinin alır veya ayarlar SqlCommand .Gets or sets the SqlTransaction within which the SqlCommand executes.

UpdatedRowSource

DataRowÖğesinin Update yöntemi tarafından kullanıldığında komut sonuçlarının öğesine nasıl uygulanacağını alır veya ayarlar DbDataAdapter .Gets or sets how command results are applied to the DataRow when used by the Update method of the DbDataAdapter.

Yöntemler

BeginExecuteNonQuery()

Transact-SQL ifadesinin veya bu tarafından tanımlanan saklı yordamın zaman uyumsuz yürütmesini başlatır SqlCommand .Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand.

BeginExecuteNonQuery(AsyncCallback, Object)

SqlCommand, Geri çağırma yordamı ve durum bilgileri verildiğinde, Transact-SQL ifadesinin veya bu tarafından tanımlanan saklı yordamın zaman uyumsuz yürütmesini başlatır.Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand, given a callback procedure and state information.

BeginExecuteReader()

Transact-SQL ifadesinin veya bu tarafından tanımlanan saklı yordamın zaman uyumsuz yürütmesini başlatır SqlCommand ve sunucudan bir veya daha fazla sonuç kümesi alır.Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand, and retrieves one or more result sets from the server.

BeginExecuteReader(AsyncCallback, Object)

Bu tarafından tanımlanan Transact-SQL ifadesinin veya saklı yordamın zaman uyumsuz yürütmesini başlatır SqlCommand ve geri çağırma yordamı ve durum bilgileri verildiğinde sunucudan bir veya daha fazla sonuç kümesi alır.Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand and retrieves one or more result sets from the server, given a callback procedure and state information.

BeginExecuteReader(AsyncCallback, Object, CommandBehavior)

Bu tarafından tanımlanan Transact-SQL ifadesinin veya saklı yordamın zaman uyumsuz yürütmesini SqlCommand , değerlerden birini kullanarak CommandBehavior ve bir geri çağırma yordamı ve durum bilgileri verildiğinde sunucudan bir veya daha fazla sonuç kümesi almayı başlatır.Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand, using one of the CommandBehavior values, and retrieving one or more result sets from the server, given a callback procedure and state information.

BeginExecuteReader(CommandBehavior)

Her değerden birini kullanarak bu tarafından açıklanan Transact-SQL ifadesinin veya saklı yordamın zaman uyumsuz yürütmesini başlatır SqlCommand CommandBehavior .Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand using one of the CommandBehavior values.

BeginExecuteXmlReader()

Transact-SQL ifadesinin veya bu tarafından tanımlanan saklı yordamın zaman uyumsuz yürütmesini başlatır SqlCommand ve sonuçları bir nesne olarak döndürür XmlReader .Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand and returns results as an XmlReader object.

BeginExecuteXmlReader(AsyncCallback, Object)

Bu tarafından tanımlanan Transact-SQL ifadesinin veya saklı yordamın zaman uyumsuz yürütmesini başlatır SqlCommand ve XmlReader geri çağırma yordamı kullanılarak sonuçları bir nesne olarak döndürür.Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand and returns results as an XmlReader object, using a callback procedure.

Cancel()

Yürütmesini iptal etmeyi dener SqlCommand .Tries to cancel the execution of a SqlCommand.

Clone()

SqlCommandGeçerli örneğin bir kopyası olan yeni bir nesne oluşturur.Creates a new SqlCommand object that is a copy of the current instance.

CreateDbParameter()

Türetilmiş bir sınıfta geçersiz kılınırsa, bir nesnenin yeni bir örneğini oluşturur DbParameter .When overridden in a derived class, creates a new instance of a DbParameter object.

(Devralındığı yer: DbCommand)
CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm bilgileri içeren bir nesne oluşturur.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Devralındığı yer: MarshalByRefObject)
CreateParameter()

Bir nesnenin yeni bir örneğini oluşturur SqlParameter .Creates a new instance of a SqlParameter object.

Dispose()

Uygulama tarafından tanımlanan, yönetilmeyen kaynakları serbest bırakma, salma veya sıfırlama ile ilişkili görevleri gerçekleştirir.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Devralındığı yer: DbCommand)
Dispose()

Component tarafından kullanılan tüm kaynakları serbest bırakır.Releases all resources used by the Component.

(Devralındığı yer: Component)
Dispose(Boolean)

DbCommand tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.Releases the unmanaged resources used by the DbCommand and optionally releases the managed resources.

(Devralındığı yer: DbCommand)
Dispose(Boolean)

Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Devralındığı yer: Component)
DisposeAsync()

Komut nesnesini zaman uyumsuz olarak atar.Asynchronously diposes the command object.

(Devralındığı yer: DbCommand)
EndExecuteNonQuery(IAsyncResult)

Bir Transact-SQL ifadesinin zaman uyumsuz yürütmesini sonlandırır.Finishes asynchronous execution of a Transact-SQL statement.

EndExecuteReader(IAsyncResult)

Bir Transact-SQL ifadesinin zaman uyumsuz yürütmesini sonlandırır, istenen isteği döndürür SqlDataReader .Finishes asynchronous execution of a Transact-SQL statement, returning the requested SqlDataReader.

EndExecuteXmlReader(IAsyncResult)

Bir Transact-SQL ifadesinin zaman uyumsuz yürütmesini sonlandırır, istenen veriler XML olarak döndürülüyor.Finishes asynchronous execution of a Transact-SQL statement, returning the requested data as XML.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
ExecuteDbDataReader(CommandBehavior)

Türetilmiş bir sınıfta geçersiz kılınırsa, bağlantı için komut metnini yürütür.When overridden in a derived class, executes the command text against the connection.

(Devralındığı yer: DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Sağlayıcılar, aşırı yüklemeler için varsayılan olmayan bir uygulama sağlamak üzere bu yöntemi uygulamalıdır ExecuteReader .Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Varsayılan uygulama, zaman uyumlu ExecuteReader() yöntemi çağırır ve tamamlanan bir görevi döndürür ve çağıran iş parçacığını engeller.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Zaten iptal edilmiş bir iptal belirteci geçirilirse varsayılan uygulama iptal edilen bir görev döndürür.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteReader tarafından oluşturulan özel durumlar, döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Bu yöntem, işlemi erken iptal edilecek şekilde istemek için kullanılabilen bir iptal belirtecini kabul eder.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Uygulamalar bu isteği yok sayabilir.Implementations may ignore this request.

(Devralındığı yer: DbCommand)
ExecuteNonQuery()

Bağlantı için bir Transact-SQL ifadesini yürütür ve etkilenen satır sayısını döndürür.Executes a Transact-SQL statement against the connection and returns the number of rows affected.

ExecuteNonQueryAsync()

Bir ExecuteNonQuery() bağlantı nesnesine yönelik BIR SQL ifadesini yürüten zaman uyumsuz bir sürümü.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

ExecuteNonQueryAsync(CancellationToken)CancellationToken. None ile çağırır.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

(Devralındığı yer: DbCommand)
ExecuteNonQueryAsync(CancellationToken)

ExecuteNonQuery() Transact-SQLTransact-SQL Bağlantı için bir ifade yürüten ve etkilenen satır sayısını döndüren zaman uyumsuz bir sürümü.An asynchronous version of ExecuteNonQuery(), which executes a Transact-SQLTransact-SQL statement against the connection and returns the number of rows affected. İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Özel durumlar döndürülen Görev nesnesi ile bildirilir.Exceptions will be reported via the returned Task object.

ExecuteNonQueryAsync(CancellationToken)

Bu, öğesinin zaman uyumsuz sürümüdür ExecuteNonQuery() .This is the asynchronous version of ExecuteNonQuery(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. İptal belirteci isteğe bağlı olarak yoksayılabilir.The cancellation token may optionally be ignored.

Varsayılan uygulama, zaman uyumlu ExecuteNonQuery() yöntemi çağırır ve tamamlanan bir görevi döndürür ve çağıran iş parçacığını engeller.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. Zaten iptal edilmiş bir iptal belirteci geçirilirse varsayılan uygulama iptal edilen bir görev döndürür.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Tarafından oluşturulan özel durumlar ExecuteNonQuery() , döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Döndürülen görev tamamlanana kadar nesnenin diğer yöntemlerini ve özelliklerini çağırmayın DbCommand .Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Devralındığı yer: DbCommand)
ExecuteReader()

CommandText Connection ' A gönderir ve bir oluşturur SqlDataReader .Sends the CommandText to the Connection and builds a SqlDataReader.

ExecuteReader(CommandBehavior)

CommandText Connection ' A gönderir ve SqlDataReader değerlerinden birini kullanarak bir oluşturur CommandBehavior .Sends the CommandText to the Connection, and builds a SqlDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

ExecuteReader()Öğesini CommandText öğesine Gönderen Connection ve a derlemesi olan zaman uyumsuz bir sürümü SqlDataReader .An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader. Özel durumlar döndürülen Görev nesnesi ile bildirilir.Exceptions will be reported via the returned Task object.

ExecuteReaderAsync()

ExecuteReader' I ' CommandText a karşı yürüten Connection ve döndüren zaman uyumsuz bir sürümü DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)CancellationToken. None ile çağırır.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

(Devralındığı yer: DbCommand)
ExecuteReaderAsync(CancellationToken)

ExecuteReader()Öğesini CommandText öğesine Gönderen Connection ve a derlemesi olan zaman uyumsuz bir sürümü SqlDataReader .An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader.

İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Özel durumlar döndürülen Görev nesnesi ile bildirilir.Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CancellationToken)

ExecuteReader' I ' CommandText a karşı yürüten Connection ve döndüren zaman uyumsuz bir sürümü DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Bu yöntem, işlemlerin iptal edilmesi gerektiğini belirten bir bildirim yayar.This method propagates a notification that operations should be canceled.

Çağırır ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Devralındığı yer: DbCommand)
ExecuteReaderAsync(CommandBehavior)

Öğesini ExecuteReader(CommandBehavior) öğesine gönderen ve ' a veren zaman uyumsuz bir sürümü CommandText Connection SqlDataReader .An asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader. Özel durumlar döndürülen Görev nesnesi ile bildirilir.Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CommandBehavior)

ExecuteReader' I ' CommandText a karşı yürüten Connection ve döndüren zaman uyumsuz bir sürümü DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Çağırır ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Devralındığı yer: DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

' ExecuteReader(CommandBehavior) CommandText A ' öğesine Gönderen Connection ve bir SqlDataReaderAn asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader

İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Özel durumlar döndürülen Görev nesnesi ile bildirilir.Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Çağırır ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Devralındığı yer: DbCommand)
ExecuteScalar()

Sorguyu yürütür ve sorgu tarafından döndürülen sonuç kümesindeki ilk satırın ilk sütununu döndürür.Executes the query, and returns the first column of the first row in the result set returned by the query. Ek sütunlar veya satırlar yok sayılır.Additional columns or rows are ignored.

ExecuteScalarAsync()

ExecuteScalar()Sorgusunu yürüten ve sorgu tarafından döndürülen sonuç kümesindeki ilk satırın ilk sütununu döndüren zaman uyumsuz bir sürümü.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Diğer tüm sütunlar ve satırlar yok sayılır.All other columns and rows are ignored.

ExecuteScalarAsync(CancellationToken)CancellationToken. None ile çağırır.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

(Devralındığı yer: DbCommand)
ExecuteScalarAsync(CancellationToken)

ExecuteScalar()Sorgusunu zaman uyumsuz olarak yürüten ve sorgu tarafından döndürülen sonuç kümesindeki ilk satırın ilk sütununu döndüren zaman uyumsuz bir sürümü.An asynchronous version of ExecuteScalar(), which executes the query asynchronously and returns the first column of the first row in the result set returned by the query. Ek sütunlar veya satırlar yok sayılır.Additional columns or rows are ignored.

İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Özel durumlar döndürülen Görev nesnesi ile bildirilir.Exceptions will be reported via the returned Task object.

ExecuteScalarAsync(CancellationToken)

Bu, öğesinin zaman uyumsuz sürümüdür ExecuteScalar() .This is the asynchronous version of ExecuteScalar(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. İptal belirteci isteğe bağlı olarak yoksayılabilir.The cancellation token may optionally be ignored.

Varsayılan uygulama, zaman uyumlu ExecuteScalar() yöntemi çağırır ve tamamlanan bir görevi döndürür ve çağıran iş parçacığını engeller.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Zaten iptal edilmiş bir iptal belirteci geçirilirse varsayılan uygulama iptal edilen bir görev döndürür.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteReader metodunu tarafından oluşturulan özel durumlar, döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Döndürülen görev tamamlanana kadar nesnenin diğer yöntemlerini ve özelliklerini çağırmayın DbCommand .Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Devralındığı yer: DbCommand)
ExecuteXmlReader()

' A gönderir CommandText Connection ve bir nesnesi oluşturur XmlReader .Sends the CommandText to the Connection and builds an XmlReader object.

ExecuteXmlReaderAsync()

ExecuteXmlReader()' A ' CommandText öğesine Gönderen Connection ve bir nesnesi oluşturan zaman uyumsuz bir sürümü XmlReader .An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

Özel durumlar döndürülen Görev nesnesi ile bildirilir.Exceptions will be reported via the returned Task object.

ExecuteXmlReaderAsync(CancellationToken)

ExecuteXmlReader()' A ' CommandText öğesine Gönderen Connection ve bir nesnesi oluşturan zaman uyumsuz bir sürümü XmlReader .An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Özel durumlar döndürülen Görev nesnesi ile bildirilir.Exceptions will be reported via the returned Task object.

GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetLifetimeService()

Bu örnek için ömür ilkesini denetleyen geçerli ömür hizmeti nesnesini alır.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
GetService(Type)

Veya tarafından belirtilen bir hizmeti temsil eden bir nesne döndürür Component Container .Returns an object that represents a service provided by the Component or by its Container.

(Devralındığı yer: Component)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
InitializeLifetimeService()

Bu örnek için ömür ilkesini denetlemek üzere bir ömür hizmeti nesnesi alır.Obtains a lifetime service object to control the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli nesnenin basit bir kopyasını oluşturur MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

(Devralındığı yer: MarshalByRefObject)
Prepare()

Bir SQL Server örneğinde komutun hazırlanan bir sürümünü oluşturur.Creates a prepared version of the command on an instance of SQL Server.

PrepareAsync(CancellationToken)

Zaman uyumsuz olarak, veri kaynağında komutun hazırlanmış (veya derlenen) bir sürümünü oluşturur.Asynchronously creates a prepared (or compiled) version of the command on the data source.

(Devralındığı yer: DbCommand)
ResetCommandTimeout()

CommandTimeoutÖzelliği varsayılan değerine sıfırlar.Resets the CommandTimeout property to its default value.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)
ToString()

Varsa, String varsa adını içeren bir döndürür Component .Returns a String containing the name of the Component, if any. Bu yöntem geçersiz kılınmamalıdır.This method should not be overridden.

(Devralındığı yer: Component)

Ekinlikler

Disposed

Bileşen yönteme bir çağrı tarafından bırakıldığında gerçekleşir Dispose() .Occurs when the component is disposed by a call to the Dispose() method.

(Devralındığı yer: Component)
StatementCompleted

Bir Transact-SQL ifadesinin yürütülmesi tamamlandığında gerçekleşir.Occurs when the execution of a Transact-SQL statement completes.

Belirtik Arabirim Kullanımları

ICloneable.Clone()

SqlCommandGeçerli örneğin bir kopyası olan yeni bir nesne oluşturur.Creates a new SqlCommand object that is a copy of the current instance.

IDbCommand.Connection

IDbConnectionBu örneği tarafından kullanılan öğesini alır veya ayarlar IDbCommand .Gets or sets the IDbConnection used by this instance of the IDbCommand.

(Devralındığı yer: DbCommand)
IDbCommand.CreateParameter()

Bir nesnenin yeni bir örneğini oluşturur SqlParameter .Creates a new instance of a SqlParameter object.

IDbCommand.CreateParameter()

Bir nesnenin yeni bir örneğini oluşturur IDbDataParameter .Creates a new instance of an IDbDataParameter object.

(Devralındığı yer: DbCommand)
IDbCommand.ExecuteReader()

CommandText Connection ' A gönderir ve bir oluşturur SqlDataReader .Sends the CommandText to the Connection, and builds a SqlDataReader.

IDbCommand.ExecuteReader()

' A CommandText karşı yürütülür Connection ve bir oluşturur IDataReader .Executes the CommandText against the Connection and builds an IDataReader.

(Devralındığı yer: DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

CommandText Connection ' A gönderir ve SqlDataReader değerlerinden birini kullanarak bir oluşturur CommandBehavior .Sends the CommandText to the Connection, and builds a SqlDataReader using one of the CommandBehavior values.

IDbCommand.ExecuteReader(CommandBehavior)

, CommandText ' A karşı yürütülür Connection ve IDataReader değerlerden birini kullanarak bir oluşturur CommandBehavior .Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

(Devralındığı yer: DbCommand)
IDbCommand.Parameters

IDataParameterCollection öğesini alır.Gets the IDataParameterCollection.

(Devralındığı yer: DbCommand)
IDbCommand.Transaction

DbTransactionBu nesnenin içinde çalıştırıldığı içindeki öğesini alır veya ayarlar DbCommand .Gets or sets the DbTransaction within which this DbCommand object executes.

(Devralındığı yer: DbCommand)

Şunlara uygulanır

Ayrıca bkz.