SqlCommand Sınıf

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

SQL Server veritabanında yürütülecek bir Transact-SQL deyimini veya saklı yordamı temsil eder. Bu sınıf devralınamaz.

Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

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

Devralma

Object

MarshalByRefObject

Component

DbCommand

SqlCommand

Uygulamalar

ICloneable

Örnekler

Aşağıdaki örnek, bir SqlConnection, SqlCommandve SqlDataReaderoluşturur. Örnek, verileri okuyup konsola yazar. Son olarak, örnek kod bloklarından SqlDataReader çıktıktan sonra SqlConnection ve öğesini Using kapatır.

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 örnekte farklı sqlcommand nesnelerinin nasıl oluşturulacağı ve yürütülacağı gösterilmektedir.

İlk olarak aşağıdaki betiği yürüterek örnek veritabanını oluşturmanız gerekir:

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

Ardından, aşağıdakileri derleyin ve yürütin:

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

Örneği SqlCommand oluşturulduğunda, okuma/yazma özellikleri ilk değerlerine ayarlanır. Bu değerlerin listesi için oluşturucuya SqlCommand bakın.

SqlCommand SQL Server veritabanında komutları yürütmek için aşağıdaki yöntemleri içerir:

Öğe	Açıklama
BeginExecuteNonQuery	bu tarafından SqlCommandaçıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır; genellikle INSERT, DELETE, UPDATE ve SET deyimleri gibi komutları yürütür. her BeginExecuteNonQuery çağrısı, genellikle ayrı bir iş parçacığında işlemi tamamlayan çağrısıyla EndExecuteNonQueryeşleştirilmelidir.
BeginExecuteReader	Bunun SqlCommand tarafından açıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır ve sunucudan bir veya daha fazla sonuç kümesi alır. her BeginExecuteReader çağrısı, genellikle ayrı bir iş parçacığında işlemi tamamlayan çağrısıyla EndExecuteReadereşleştirilmelidir.
BeginExecuteXmlReader	bu SqlCommandtarafından açıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır. her çağrısı BeginExecuteXmlReader , genellikle ayrı bir EndExecuteXmlReaderiş parçacığında işlemi tamamlayan ve bir XmlReader nesnesi döndüren çağrısıyla eşleştirilmelidir.
ExecuteReader	Satır döndüren komutları yürütür. Daha yüksek performans için, ExecuteReader Transact-SQL sp_executesql sistem saklı yordamını kullanarak komutları çağırır. Bu nedenle, ExecuteReader Transact-SQL SET deyimleri gibi komutları yürütmek için kullanılırsa istediğiniz etkiye sahip olmayabilir.
ExecuteNonQuery	Transact-SQL INSERT, DELETE, UPDATE ve SET deyimleri gibi komutları yürütür.
ExecuteScalar	Veritabanından tek bir değer (örneğin, toplama değeri) alır.
ExecuteXmlReader	CommandText öğesine Connection gönderir ve bir XmlReader nesnesi oluşturur.

Özelliğini sıfırlayabilir CommandText ve nesneyi yeniden kullanabilirsiniz SqlCommand . Ancak, yeni veya önceki bir komutu yürütebilmeniz için önce öğesini kapatmanız SqlDataReader gerekir.

bir SqlException yürüten SqlCommandSqlConnection yöntemi tarafından oluşturulursa, önem düzeyi 19 veya daha az olduğunda açık kalır. Önem düzeyi 20 veya daha yüksek olduğunda, sunucu normalde kapatır SqlConnection. Ancak kullanıcı bağlantıyı yeniden açabilir ve devam edebilir.

Note

Sıralı olarak da adlandırılan adsız parametreler, SQL Server için .NET Framework Veri Sağlayıcısı tarafından desteklenmez.

Oluşturucular

Veri Akışı Adı	Description
SqlCommand()	SqlCommand sınıfının yeni bir örneğini başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	Belirtilen komut metni, bağlantı, işlem ve şifreleme ayarıyla sınıfın SqlCommand yeni bir örneğini başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlCommand(String, SqlConnection, SqlTransaction)	sorgu metni SqlCommand , bir ve ile sınıfının yeni bir SqlConnectionörneğini SqlTransactionbaşlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlCommand(String, SqlConnection)	sorgu metni SqlCommand ve ile sınıfının yeni bir SqlConnectionörneğini başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
SqlCommand(String)	Sorgu metniyle sınıfının yeni bir örneğini SqlCommand başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

Özellikler

Veri Akışı Adı	Description
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
ColumnEncryptionSetting	Bu komut için sütun şifreleme ayarını alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
CommandText	veri kaynağında yürütülecek Transact-SQL deyimini, tablo adını veya saklı yordamı alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
CommandTimeout	Komut yürütme girişimini sonlandırmadan ve hata oluşturmadan önce bekleme süresini (saniye cinsinden) alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
CommandType	Özelliğin CommandText nasıl yorumlandığını belirten bir değer alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Connection	öğesinin SqlConnection bu örneği tarafından kullanılan öğesini SqlCommandalır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
DbConnection	Bu DbConnectiontarafından kullanılan öğesini DbCommand alır veya ayarlar. (Devralındığı yer: DbCommand)
DbParameterCollection	Nesne koleksiyonunu DbParameter alır. (Devralındığı yer: DbCommand)
DbTransaction	Bu DbTransaction nesnenin DbCommand yürütüldiği nesneyi alır veya ayarlar. (Devralındığı yer: DbCommand)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
DesignTimeVisible	Komut nesnesinin bir Windows Form Tasarımcısı denetiminde görünür olup olmayacağını belirten bir değer alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
Notification	Bu komuta bağlı nesneyi belirten SqlNotificationRequest bir değer alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
NotificationAutoEnlist	Uygulamanın ortak SqlDependency bir nesneden otomatik olarak sorgu bildirimleri alıp almayacağını belirten bir değer alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Parameters	SqlParameterCollection öğesini alır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)
Transaction	öğesinin SqlTransaction yürütüldiği öğesini SqlCommand alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
UpdatedRowSource	komutunun DataRow yöntemi tarafından kullanıldığında komut sonuçlarının öğesine nasıl uygulanacağını DbDataAdapter alır veya ayarlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

Yöntemler

Veri Akışı Adı	Description
BeginExecuteNonQuery()	bu SqlCommandtarafından açıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
BeginExecuteNonQuery(AsyncCallback, Object)	Bir geri çağırma yordamı ve durum bilgileri verildiğinde, Transact-SQL deyiminin veya bu SqlCommandtarafından açıklanan saklı yordamın zaman uyumsuz yürütülmesini başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
BeginExecuteReader()	bu SqlCommandtarafından açıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır ve sunucudan bir veya daha fazla sonuç kümesi alır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
BeginExecuteReader(AsyncCallback, Object, CommandBehavior)	Bu tarafından SqlCommandaçıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır. Değerlerden birini CommandBehavior kullanarak ve bir geri çağırma yordamı ve durum bilgileri verildiğinde sunucudan bir veya daha fazla sonuç kümesi alır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
BeginExecuteReader(AsyncCallback, Object)	Bunun SqlCommand tarafından açıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır ve bir geri çağırma yordamı ve durum bilgileri verildiğinde sunucudan bir veya daha fazla sonuç kümesi alır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
BeginExecuteReader(CommandBehavior)	Değerlerden birini kullanarak Transact-SQL deyiminin veya bunun SqlCommand tarafından açıklanan saklı yordamın zaman uyumsuz yürütülmesini CommandBehavior başlatır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
BeginExecuteXmlReader()	Bunun SqlCommand tarafından açıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır ve sonuçları bir XmlReader nesne olarak döndürür. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
BeginExecuteXmlReader(AsyncCallback, Object)	Bu SqlCommand tarafından açıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütmesini başlatır ve geri çağırma yordamı kullanarak sonuçları nesne XmlReader olarak döndürür. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Cancel()	yürütmesini SqlCommandiptal etmeye çalışır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Clone()	Geçerli örneğin kopyası olan yeni SqlCommand bir nesne oluşturur. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
CreateDbParameter()	Nesnenin yeni bir DbParameter örneğini oluşturur. (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 ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
CreateParameter()	Nesnenin yeni bir SqlParameter örneğini oluşturur. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
EndExecuteNonQuery(IAsyncResult)	Transact-SQL deyiminin zaman uyumsuz yürütülmesini tamamlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
EndExecuteReader(IAsyncResult)	bir Transact-SQL deyiminin zaman uyumsuz yürütülmesini tamamlar ve istenen SqlDataReaderdöndürülerek . Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
EndExecuteXmlReader(IAsyncResult)	İstenen verileri XML olarak döndürerek Transact-SQL deyiminin zaman uyumsuz yürütülmesini tamamlar. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
ExecuteDbDataReader(CommandBehavior)	Komutu bağlantısına karşı yürütür ve sonuçlara erişmek için kullanılabilecek bir DbDataReader döndürür. (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 ExecuteReader bu yöntemi uygulamalıdır. Varsayılan uygulama zaman uyumlu ExecuteReader() yöntemini çağırır ve tamamlanan bir görev döndürerek çağıran iş parçacığını engeller. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirteci geçirilirse iptal edilmiş bir görev döndürür. ExecuteReader tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. Bu yöntem, işlemin erken iptalini istemek için kullanılabilecek bir iptal belirteci kabul eder. Uygulamalar bu isteği yoksayabilir. (Devralındığı yer: DbCommand)
ExecuteNonQuery()	Bağlantıda bir Transact-SQL deyimi yürütür ve etkilenen satır sayısını döndürür. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ExecuteNonQueryAsync()	komutunu bağlantı nesnesine karşı yürüten ve etkilenen satır sayısını döndüren zaman uyumsuz sürümü ExecuteNonQuery(). ExecuteNonQueryAsync(CancellationToken) CancellationToken.None ile çağırır. (Devralındığı yer: DbCommand)
ExecuteNonQueryAsync(CancellationToken)	bağlantısında ExecuteNonQuery()bir Transact-SQL deyimi yürüten ve etkilenen satır sayısını döndüren zaman uyumsuz sürümü. İptal belirteci, komut zaman aşımı tamamlanmadan önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
ExecuteReader()	öğesine CommandTextConnection gönderir ve bir SqlDataReaderoluşturur. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ExecuteReader(CommandBehavior)	CommandText öğesine Connectiongönderir ve değerlerden birini SqlDataReader kullanarak bir CommandBehavior oluşturur. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ExecuteReaderAsync()	öğesini adresine gönderen ExecuteReader()CommandText ve bir oluşturan zaman uyumsuz sürümüConnectionSqlDataReader. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ExecuteReaderAsync(CancellationToken)	öğesini adresine gönderen ExecuteReader()CommandText ve bir oluşturan zaman uyumsuz sürümüConnectionSqlDataReader. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
ExecuteReaderAsync(CommandBehavior, CancellationToken)	öğesini öğesine gönderen ExecuteReader(CommandBehavior)CommandTextve bir oluşturan zaman uyumsuz sürümü ConnectionSqlDataReader The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
ExecuteReaderAsync(CommandBehavior)	öğesini öğesine gönderen ExecuteReader(CommandBehavior)CommandTextve bir oluşturan zaman uyumsuz sürümüConnectionSqlDataReader. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
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. Ek sütunlar veya satırlar yoksayılır. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ExecuteScalarAsync()	komutunu yürüten ve döndürülen ilk sonuç kümesindeki ilk satırın ilk sütununu döndüren zaman uyumsuz sürümü ExecuteScalar(). Diğer tüm sütunlar, satırlar ve sonuç kümeleri yoksayılır. ExecuteScalarAsync(CancellationToken) CancellationToken.None ile çağırır. (Devralındığı yer: DbCommand)
ExecuteScalarAsync(CancellationToken)	sorguyu 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 sürümü ExecuteScalar(). Ek sütunlar veya satırlar yoksayılır. İptal belirteci, komut zaman aşımı tamamlanmadan önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ExecuteXmlReader()	CommandText öğesine Connection gönderir ve bir XmlReader nesnesi oluşturur. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ExecuteXmlReaderAsync()	öğesine gönderen ExecuteXmlReader()CommandText ve bir nesnesi oluşturan zaman uyumsuz sürümüConnectionXmlReader. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ExecuteXmlReaderAsync(CancellationToken)	öğesine gönderen ExecuteXmlReader()CommandText ve bir nesnesi oluşturan zaman uyumsuz sürümüConnectionXmlReader. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya Componenttarafından Container sağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
Prepare()	SQL Server örneğinde komutun hazırlanmış bir sürümünü oluşturur. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ResetCommandTimeout()	Özelliği varsayılan değerine sıfırlar CommandTimeout . Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ToString()	Varsa, adını Stringiçeren bir Component döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)

Ekinlikler

Veri Akışı Adı	Description
Disposed	Bileşen yöntemine Dispose() yapılan bir çağrıyla atıldığında gerçekleşir. (Devralındığı yer: Component)
StatementCompleted	bir Transact-SQL deyiminin yürütülmesi tamamlandığında gerçekleşir. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

Belirtik Arabirim Kullanımları

Veri Akışı Adı	Description
ICloneable.Clone()	Geçerli örneğin kopyası olan yeni SqlCommand bir nesne oluşturur. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
IDbCommand.Connection	öğesinin IDbConnection bu örneği tarafından kullanılan öğesini IDbCommandalır veya ayarlar. (Devralındığı yer: DbCommand)
IDbCommand.CreateParameter()	Nesnenin yeni bir IDbDataParameter örneğini oluşturur. (Devralındığı yer: DbCommand)
IDbCommand.ExecuteReader()	üzerinde CommandText komutunu Connection yürütür ve bir IDataReaderoluşturur. (Devralındığı yer: DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	üzerinde komutunu CommandTextConnectionyürütür ve değerlerden birini IDataReader kullanarak bir CommandBehavior oluşturur. (Devralındığı yer: DbCommand)
IDbCommand.Parameters	IDataParameterCollection öğesini alır. (Devralındığı yer: DbCommand)
IDbCommand.Transaction	Bu DbTransaction nesnenin DbCommand yürütüldiği nesneyi alır veya ayarlar. (Devralındığı yer: DbCommand)

Ayrıca bkz.

• ADO.NET’te Veri Alma ve Değiştirme
• SQL Server ve ADO.NET
• ADO.NET’e Genel Bakış