SqlCommand 類別

定義

表示要對 SQL Server 資料庫執行的 Transact-SQL 陳述式或預存程序。Represents a Transact-SQL statement or stored procedure to execute against a SQL Server database. 這個類別無法被繼承。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
繼承
SqlCommand
繼承
繼承
實作

範例

下列範例會建立一個 SqlConnection、一個 SqlCommand和一個 SqlDataReaderThe following example creates a SqlConnection, a SqlCommand, and a SqlDataReader. 此範例會讀取資料,並將其寫入主控台。The example reads through the data, writing it to the console. 最後,此範例會關閉 SqlDataReader,然後 SqlConnection 結束 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

下列範例顯示如何建立和執行不同類型的 SqlCommand 物件。The following sample shows how to create and execute different types of SqlCommand objects.

首先,您必須藉由執行下列腳本來建立範例資料庫: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  

接下來,編譯並執行下列各項: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");  
   }  
}  

備註

建立 SqlCommand 的實例時,讀取/寫入屬性會設定為其初始值。When an instance of SqlCommand is created, the read/write properties are set to their initial values. 如需這些值的清單,請參閱 SqlCommand 的函式。For a list of these values, see the SqlCommand constructor.

SqlCommand 提供下列方法,以在 SQL Server 資料庫中執行命令:SqlCommand features the following methods for executing commands at a SQL Server database:

ItemItem 描述Description
BeginExecuteNonQuery 起始這個 SqlCommand所描述之 Transact-sql 語句或預存程式的非同步執行,通常是執行 INSERT、DELETE、UPDATE 和 SET 語句等命令。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. BeginExecuteNonQuery 的每個呼叫都必須與 EndExecuteNonQuery 的呼叫配對,這會完成作業,通常是在不同的執行緒上。Each call to BeginExecuteNonQuery must be paired with a call to EndExecuteNonQuery which finishes the operation, typically on a separate thread.
BeginExecuteReader 起始這個 SqlCommand 所描述之 Transact-sql 語句或預存程式的非同步執行,並從伺服器抓取一或多個結果集。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. BeginExecuteReader 的每個呼叫都必須與 EndExecuteReader 的呼叫配對,這會完成作業,通常是在不同的執行緒上。Each call to BeginExecuteReader must be paired with a call to EndExecuteReader which finishes the operation, typically on a separate thread.
BeginExecuteXmlReader 起始這個 SqlCommand 所描述之 Transact-SQL 陳述式或預存程序的非同步執行。Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand. BeginExecuteXmlReader 的每個呼叫都必須與 EndExecuteXmlReader的呼叫配對,這會完成作業(通常是在個別的執行緒上),並傳回 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 執行傳回資料列的命令。Executes commands that return rows. 為了提升效能,ExecuteReader 使用 Transact-sql sp_executesql 系統預存程式來叫用命令。For increased performance, ExecuteReader invokes commands using the Transact-SQL sp_executesql system stored procedure. 因此,如果用來執行 Transact-sql SET 語句之類的命令,ExecuteReader 可能不會有您想要的效果。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 和 SET 語句之類的命令。Executes commands such as Transact-SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar 抓取資料庫中的單一值(例如匯總值)。Retrieves a single value (for example, an aggregate value) from a database.
ExecuteXmlReader CommandText 傳送至 Connection 並建置 XmlReader 物件。Sends the CommandText to the Connection and builds an XmlReader object.

您可以重設 CommandText 屬性,並重複使用 SqlCommand 物件。You can reset the CommandText property and reuse the SqlCommand object. 不過,您必須先關閉 SqlDataReader,才能執行新的或先前的命令。However, you must close the SqlDataReader before you can execute a new or previous command.

如果 SqlException 是由執行 SqlCommand的方法所產生,則當嚴重性層級為19或更小時,SqlConnection 會保持開啟。If a SqlException is generated by the method executing a SqlCommand, the SqlConnection remains open when the severity level is 19 or less. 當嚴重性層級為20或更大時,伺服器通常會關閉 SqlConnectionWhen the severity level is 20 or greater, the server ordinarily closes the SqlConnection. 但是,使用者可以再次開啟連線,然後繼續進行。However, the user can reopen the connection and continue.

注意

SQL Server 的 .NET Framework Data Provider 不支援無名稱(也稱為序數)參數。Nameless, also called ordinal, parameters are not supported by the .NET Framework Data Provider for SQL Server.

建構函式

SqlCommand()

SqlCommand 類別的新執行個體初始化。Initializes a new instance of the SqlCommand class.

SqlCommand(String)

使用查詢的文字,初始化 SqlCommand 類別的新執行個體。Initializes a new instance of the SqlCommand class with the text of the query.

SqlCommand(String, SqlConnection)

使用查詢的文字和 SqlConnection 初始化 SqlCommand 類別的新執行個體。Initializes a new instance of the SqlCommand class with the text of the query and a SqlConnection.

SqlCommand(String, SqlConnection, SqlTransaction)

使用查詢的文字、SqlConnectionSqlTransaction,初始化 SqlCommand 類別的新執行個體。Initializes a new instance of the SqlCommand class with the text of the query, a SqlConnection, and the SqlTransaction.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

使用指定的命令文字、連接、交易和加密設定,初始化 SqlCommand 類別的新執行個體。Initializes a new instance of the SqlCommand class with specified command text, connection, transaction, and encryption setting.

屬性

CanRaiseEvents

取得值,指出元件是否能引發事件。Gets a value indicating whether the component can raise an event.

(繼承來源 Component)
ColumnEncryptionSetting

取得或設定這個命令的資料行加密設定。Gets or sets the column encryption setting for this command.

CommandText

取得或設定要在資料來源執行的 Transact-SQL 陳述式、資料表名稱或預存程序。Gets or sets the Transact-SQL statement, table name or stored procedure to execute at the data source.

CommandTimeout

取得或設定結束執行命令的嘗試並產生錯誤之前的等待時間 (以秒為單位)。Gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

取得或設定值,其表示解譯 CommandText 屬性的方式。Gets or sets a value indicating how the CommandText property is to be interpreted.

Connection

取得或設定 SqlCommand 的這個執行個體所使用的 SqlConnectionGets or sets the SqlConnection used by this instance of the SqlCommand.

Container

取得包含 IContainerComponentGets the IContainer that contains the Component.

(繼承來源 Component)
DbConnection

當覆寫衍生類別時,取得或設定此 DbCommand 使用的 DbConnectionWhen overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

(繼承來源 DbCommand)
DbParameterCollection

當覆寫衍生類別時,取得 DbParameter 物件的集合。When overridden in a derived class, gets the collection of DbParameter objects.

(繼承來源 DbCommand)
DbTransaction

當覆寫衍生類別時,取得或設定此 DbCommand 物件執行所在的 DbTransactionWhen overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

(繼承來源 DbCommand)
DesignMode

取得值,指出 Component 目前是否處於設計模式。Gets a value that indicates whether the Component is currently in design mode.

(繼承來源 Component)
DesignTimeVisible

取得或設定值,指出命令物件是否應該在 Windows Form 設計工具控制項中顯示。Gets or sets a value indicating whether the command object should be visible in a Windows Form Designer control.

Events

取得附加在這個 Component 上的事件處理常式清單。Gets the list of event handlers that are attached to this Component.

(繼承來源 Component)
Notification

取得或設定值,其指定繫結至這個命令的 SqlNotificationRequest 物件。Gets or sets a value that specifies the SqlNotificationRequest object bound to this command.

NotificationAutoEnlist

取得或設定值,指出應用程式是否應該從通用 SqlDependency 物件自動接收查詢通知。Gets or sets a value indicating whether the application should automatically receive query notifications from a common SqlDependency object.

Parameters

取得 SqlParameterCollectionGets the SqlParameterCollection.

Site

取得或設定 ComponentISiteGets or sets the ISite of the Component.

(繼承來源 Component)
Transaction

取得或設定在其中執行 SqlTransactionSqlCommandGets or sets the SqlTransaction within which the SqlCommand executes.

UpdatedRowSource

取得或設定當由 DbDataAdapterUpdate 方法使用命令結果時,如何套用至 DataRowGets or sets how command results are applied to the DataRow when used by the Update method of the DbDataAdapter.

方法

BeginExecuteNonQuery()

起始這個 SqlCommand 所描述之 Transact-SQL 陳述式或預存程序的非同步執行。Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand.

BeginExecuteNonQuery(AsyncCallback, Object)

如果已有回呼程序和狀態資訊,會啟始 Transact-SQL 陳述式或此 SqlCommand 所描述預存程序的非同步執行。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()

起始這個 SqlCommand 所描述之 Transact-SQL 陳述式或預存程序的非同步執行,並從伺服器擷取一或多個結果集。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)

指定回呼程序和狀態資訊時,啟始這個 SqlCommand 所描述之 Transact-SQL 陳述式或預存程序的非同步執行,並且從伺服器擷取一或多個結果集。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)

指定回呼程序和狀態資訊時,使用其中一個 CommandBehavior 值,起始這個 SqlCommand 所描述之 Transact-SQL 陳述式或預存程序的非同步執行,並從伺服器擷取一或多個結果集。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)

藉由使用其中一個 CommandBehavior 值,起始這個 SqlCommand 所描述之 Transact-SQL 陳述式或預存程序的非同步執行。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()

啟始這個 SqlCommand 所描述之 Transact-SQL 陳述式或預存程序的非同步執行,並傳回結果做為 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)

使用回呼程序,啟始這個 SqlCommand 所描述之 Transact-SQL 陳述式或預存程序的非同步執行,並傳回結果做為 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, using a callback procedure.

Cancel()

嘗試取消 SqlCommand 的執行。Tries to cancel the execution of a SqlCommand.

Clone()

建立新的 SqlCommand 物件,這個物件是目前執行個體的複本。Creates a new SqlCommand object that is a copy of the current instance.

CreateDbParameter()

當覆寫衍生類別時,建立新的 DbParameter 物件執行個體。When overridden in a derived class, creates a new instance of a DbParameter object.

(繼承來源 DbCommand)
CreateObjRef(Type)

建立包含所有相關資訊的物件,這些資訊是產生用來與遠端物件通訊的所需 Proxy。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(繼承來源 MarshalByRefObject)
CreateParameter()

建立 SqlParameter 物件的新執行個體。Creates a new instance of a SqlParameter object.

Dispose() (繼承來源 DbCommand)
Dispose()

釋出 Component 所使用的全部資源。Releases all resources used by the Component.

(繼承來源 Component)
Dispose(Boolean) (繼承來源 DbCommand)
Dispose(Boolean)

釋放 Component 所使用的 unmanaged 資源並選擇性地釋放 managed 的資源。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(繼承來源 Component)
DisposeAsync()

非同步地處置命令物件。Asynchronously diposes the command object.

(繼承來源 DbCommand)
EndExecuteNonQuery(IAsyncResult)

完成 Transact-SQL 陳述式的非同步執行。Finishes asynchronous execution of a Transact-SQL statement.

EndExecuteReader(IAsyncResult)

完成 Transact-SQL 陳述式的非同步執行,傳回要求的 SqlDataReaderFinishes asynchronous execution of a Transact-SQL statement, returning the requested SqlDataReader.

EndExecuteXmlReader(IAsyncResult)

完成 Transact-SQL 陳述式的非同步執行,以 XML 傳回要求的資料。Finishes asynchronous execution of a Transact-SQL statement, returning the requested data as XML.

Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(繼承來源 Object)
ExecuteDbDataReader(CommandBehavior)

當覆寫衍生類別時,對連線執行命令文字。When overridden in a derived class, executes the command text against the connection.

(繼承來源 DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

提供者應該實作這個方法,以提供 ExecuteReader 多載的非預設實作。Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

預設實作會叫用同步ExecuteReader()方法,並傳回完成的工作,封鎖呼叫的執行緒。The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. 如果傳遞一個已經被取消的取消語彙基元,預設實作會傳回已取消的工作。The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteReader 擲回的例外狀況會透過傳回的 Task Exception 屬性來傳送。Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

這個方法會接受可以用來要求提早取消作業的取消語彙基元。This method accepts a cancellation token that can be used to request the operation to be cancelled early. 實作可以忽略這項要求。Implementations may ignore this request.

(繼承來源 DbCommand)
ExecuteNonQuery()

針對連接執行 Transact-SQL 陳述式,並傳回受影響的資料列數目。Executes a Transact-SQL statement against the connection and returns the number of rows affected.

ExecuteNonQueryAsync()

非同步版本的 ExecuteNonQuery(),這個版本會對連接物件執行 SQL 陳述式。An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

以 CancellationToken.None 叫用 ExecuteNonQueryAsync(CancellationToken)Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

(繼承來源 DbCommand)
ExecuteNonQueryAsync(CancellationToken)

非同步版本的 ExecuteNonQuery(),這個版本會對連接執行 Transact-SQLTransact-SQL 陳述式,並傳回受影響的資料列數目。An asynchronous version of ExecuteNonQuery(), which executes a Transact-SQLTransact-SQL statement against the connection and returns the number of rows affected. 取消語彙基元可用於要求在命令逾時之前捨棄作業。The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 例外狀況將經由傳回的 Task 物件回報。Exceptions will be reported via the returned Task object.

ExecuteNonQueryAsync(CancellationToken)

這是 ExecuteNonQuery() 的非同步版本。This is the asynchronous version of ExecuteNonQuery(). 提供者應該覆寫為適當的實作。Providers should override with an appropriate implementation. 可以選擇性地接受忽略語彙基元。The cancellation token may optionally be ignored.

預設實作會叫用同步ExecuteNonQuery()方法,並傳回完成的工作,封鎖呼叫的執行緒。The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. 如果傳遞一個已經被取消的取消語彙基元,預設實作會傳回已取消的工作。The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteNonQuery() 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

在傳回的工作完成之前,不叫用 DbCommand 物件的其他方法及屬性。Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(繼承來源 DbCommand)
ExecuteReader()

CommandText 傳送至 Connection,並建置 SqlDataReaderSends the CommandText to the Connection and builds a SqlDataReader.

ExecuteReader(CommandBehavior)

CommandText 傳送至 Connection,並使用其中一個 CommandBehavior 值來建置 SqlDataReaderSends the CommandText to the Connection, and builds a SqlDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

非同步版本的 ExecuteReader(),這個版本會將 CommandText 傳送至 Connection,並建置 SqlDataReaderAn asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader. 例外狀況將經由傳回的 Task 物件回報。Exceptions will be reported via the returned Task object.

ExecuteReaderAsync()

非同步版本的 ExecuteReader,該版本會針對 CommandText 執行 Connection,並傳回 DbDataReaderAn asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

以 CancellationToken.None 叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

(繼承來源 DbCommand)
ExecuteReaderAsync(CancellationToken)

非同步版本的 ExecuteReader(),這個版本會將 CommandText 傳送至 Connection,並建置 SqlDataReaderAn asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader.

取消語彙基元可用於要求在命令逾時之前捨棄作業。The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 例外狀況將經由傳回的 Task 物件回報。Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CancellationToken)

非同步版本的 ExecuteReader,該版本會針對 CommandText 執行 Connection,並傳回 DbDataReaderAn asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. 此方法會散佈通知,表示不應取消作業。This method propagates a notification that operations should be canceled.

叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(繼承來源 DbCommand)
ExecuteReaderAsync(CommandBehavior)

非同步版本的 ExecuteReader(CommandBehavior),這個版本會將 CommandText 傳送至 Connection,並建置 SqlDataReaderAn asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader. 例外狀況將經由傳回的 Task 物件回報。Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CommandBehavior)

非同步版本的 ExecuteReader,該版本會針對 CommandText 執行 Connection,並傳回 DbDataReaderAn asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(繼承來源 DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

非同步版本的 ExecuteReader(CommandBehavior),這個版本會將 CommandText 傳送至 Connection,並建置 SqlDataReaderAn asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader

取消語彙基元可用於要求在命令逾時之前捨棄作業。The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 例外狀況將經由傳回的 Task 物件回報。Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(繼承來源 DbCommand)
ExecuteScalar()

執行查詢,並傳回查詢所傳回之結果集中第一個資料列的第一個資料行。Executes the query, and returns the first column of the first row in the result set returned by the query. 忽略其他資料行或資料列。Additional columns or rows are ignored.

ExecuteScalarAsync()

ExecuteScalar() 的非同步版本,該版本會執行查詢並傳回查詢所傳回的結果集中第一個資料列的第一個資料行。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. 會忽略所有其他的資料行和資料列。All other columns and rows are ignored.

以 CancellationToken.None 叫用 ExecuteScalarAsync(CancellationToken)Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

(繼承來源 DbCommand)
ExecuteScalarAsync(CancellationToken)

ExecuteScalar() 的非同步版本,該版本會執行非同步查詢並傳回查詢所傳回的結果集中第一個資料列的第一個資料行。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. 忽略其他資料行或資料列。Additional columns or rows are ignored.

取消語彙基元可用於要求在命令逾時之前捨棄作業。The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 例外狀況將經由傳回的 Task 物件回報。Exceptions will be reported via the returned Task object.

ExecuteScalarAsync(CancellationToken)

這是 ExecuteScalar() 的非同步版本。This is the asynchronous version of ExecuteScalar(). 提供者應該覆寫為適當的實作。Providers should override with an appropriate implementation. 可以選擇性地接受忽略語彙基元。The cancellation token may optionally be ignored.

預設實作會叫用同步ExecuteScalar()方法,並傳回完成的工作,封鎖呼叫的執行緒。The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. 如果傳遞一個已經被取消的取消語彙基元,預設實作會傳回已取消的工作。The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteScalar 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

在傳回的工作完成之前,不叫用 DbCommand 物件的其他方法及屬性。Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(繼承來源 DbCommand)
ExecuteXmlReader()

CommandText 傳送至 Connection 並建置 XmlReader 物件。Sends the CommandText to the Connection and builds an XmlReader object.

ExecuteXmlReaderAsync()

非同步版本的 ExecuteXmlReader(),這個版本會將 CommandText 傳送至 Connection 並建置 XmlReader 物件。An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

例外狀況將經由傳回的 Task 物件回報。Exceptions will be reported via the returned Task object.

ExecuteXmlReaderAsync(CancellationToken)

非同步版本的 ExecuteXmlReader(),這個版本會將 CommandText 傳送至 Connection 並建置 XmlReader 物件。An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

取消語彙基元可用於要求在命令逾時之前捨棄作業。The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 例外狀況將經由傳回的 Task 物件回報。Exceptions will be reported via the returned Task object.

GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(繼承來源 Object)
GetLifetimeService()

擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(繼承來源 MarshalByRefObject)
GetService(Type)

傳回表示 Component 或其 Container 所提供之服務的物件。Returns an object that represents a service provided by the Component or by its Container.

(繼承來源 Component)
GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(繼承來源 Object)
InitializeLifetimeService()

取得存留期服務物件,以控制這個執行個體的存留期原則。Obtains a lifetime service object to control the lifetime policy for this instance.

(繼承來源 MarshalByRefObject)
MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(繼承來源 Object)
MemberwiseClone(Boolean)

建立目前 MarshalByRefObject 物件的淺層複本。Creates a shallow copy of the current MarshalByRefObject object.

(繼承來源 MarshalByRefObject)
Prepare()

在 SQL Server 的執行個體上建立命令的預備版本。Creates a prepared version of the command on an instance of SQL Server.

PrepareAsync(CancellationToken)

在資料來源上非同步地建立預先準備 (或預先編譯) 版本的命令。Asynchronously creates a prepared (or compiled) version of the command on the data source.

(繼承來源 DbCommand)
ResetCommandTimeout()

重設 CommandTimeout 屬性為其預設值。Resets the CommandTimeout property to its default value.

ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(繼承來源 Object)
ToString()

傳回任何包含 Component 名稱的 StringReturns a String containing the name of the Component, if any. 不應覆寫此方法。This method should not be overridden.

(繼承來源 Component)

事件

Disposed

Dispose() 方法的呼叫處置元件時,就會發生。Occurs when the component is disposed by a call to the Dispose() method.

(繼承來源 Component)
StatementCompleted

發生於 Transact-SQL 陳述式執行完畢時。Occurs when the execution of a Transact-SQL statement completes.

明確介面實作

ICloneable.Clone()

建立新的 SqlCommand 物件,這個物件是目前執行個體的複本。Creates a new SqlCommand object that is a copy of the current instance.

IDbCommand.Connection

取得或設定 IDbCommand 的這個執行個體所使用的 IDbConnectionGets or sets the IDbConnection used by this instance of the IDbCommand.

(繼承來源 DbCommand)
IDbCommand.CreateParameter()

建立 SqlParameter 物件的新執行個體。Creates a new instance of a SqlParameter object.

IDbCommand.CreateParameter()

建立 IDbDataParameter 物件的新執行個體。Creates a new instance of an IDbDataParameter object.

(繼承來源 DbCommand)
IDbCommand.ExecuteReader()

CommandText 傳送至 Connection,並建置 SqlDataReaderSends the CommandText to the Connection, and builds a SqlDataReader.

IDbCommand.ExecuteReader()

針對 Connection 執行 CommandText,並建置 IDataReaderExecutes the CommandText against the Connection and builds an IDataReader.

(繼承來源 DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

CommandText 傳送至 Connection,並使用其中一個 CommandBehavior 值來建置 SqlDataReaderSends the CommandText to the Connection, and builds a SqlDataReader using one of the CommandBehavior values.

IDbCommand.ExecuteReader(CommandBehavior)

針對 Connection 執行 CommandText,並使用其中一個 CommandBehavior 值來建置 IDataReaderExecutes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

(繼承來源 DbCommand)
IDbCommand.Parameters

取得 IDataParameterCollectionGets the IDataParameterCollection.

(繼承來源 DbCommand)
IDbCommand.Transaction

取得或設定 DbTransaction,此 DbCommand 物件會在其中執行。Gets or sets the DbTransaction within which this DbCommand object executes.

(繼承來源 DbCommand)

適用於

另請參閱