SqlParameterCollection.Item[] 属性

定义

命名空间:
System.Data.SqlClient
程序集:
System.Data.SqlClient.dll
程序集:
System.Data.dll

获取 SqlParameter 具有指定属性的函数。

重载

名称 说明
Item[String]

获取 具有指定名称的 < a0/>。
Item[Int32]

获取 SqlParameter 指定索引处。

Item[String]

Source:
System.Data.SqlClient.notsupported.cs

获取 具有指定名称的 < a0/>。

public:
 property System::Data::SqlClient::SqlParameter ^ default[System::String ^] { System::Data::SqlClient::SqlParameter ^ get(System::String ^ parameterName); void set(System::String ^ parameterName, System::Data::SqlClient::SqlParameter ^ value); };
public System.Data.SqlClient.SqlParameter this[string parameterName] { get; set; }
[System.ComponentModel.Browsable(false)]
public System.Data.SqlClient.SqlParameter this[string parameterName] { get; set; }
member this.Item(string) : System.Data.SqlClient.SqlParameter with get, set
[<System.ComponentModel.Browsable(false)>]
member this.Item(string) : System.Data.SqlClient.SqlParameter with get, set
Default Public Property Item(parameterName As String) As SqlParameter

参数

parameterName
String

要检索的参数的名称。

属性值

SqlParameter

具有指定名称的 < a0/> 。

属性
BrowsableAttribute

例外

IndexOutOfRangeException

指定的 parameterName 值无效。

注解

用于 parameterName 查找基础 SqlParameterCollection中的索引值。 如果无效 parameterName ，将引发一个 IndexOutOfRangeException 。

另请参阅

适用于

Item[Int32]

Source:
System.Data.SqlClient.notsupported.cs

获取 SqlParameter 指定索引处。

public:
 property System::Data::SqlClient::SqlParameter ^ default[int] { System::Data::SqlClient::SqlParameter ^ get(int index); void set(int index, System::Data::SqlClient::SqlParameter ^ value); };
public System.Data.SqlClient.SqlParameter this[int index] { get; set; }
[System.ComponentModel.Browsable(false)]
public System.Data.SqlClient.SqlParameter this[int index] { get; set; }
member this.Item(int) : System.Data.SqlClient.SqlParameter with get, set
[<System.ComponentModel.Browsable(false)>]
member this.Item(int) : System.Data.SqlClient.SqlParameter with get, set
Default Public Property Item(index As Integer) As SqlParameter

参数

index
Int32

要检索的参数的从零开始的索引。

属性值

SqlParameter

位于 SqlParameter 指定索引处。

属性
BrowsableAttribute

例外

IndexOutOfRangeException

指定的索引不存在。

示例

以下示例演示如何创建 SqlParameter 对象以向存储过程提供输入参数，该存储过程返回输出参数的结果。 代码循环访问控制台窗口中的项 SqlParameterCollection ，并在控制台窗口中显示一些参数属性。 此示例假定对 SQL Server 实例上的 AdventureWorks 示例数据库的有效连接字符串。

static private string CreateSqlParameters(int documentID)
{
    // Assumes GetConnectionString returns a valid connection string to the
    // AdventureWorks sample database on an instance of SQL Server 2005.
    using (SqlConnection connection =
               new SqlConnection(GetConnectionString()))
    {
        connection.Open();
        SqlCommand command = connection.CreateCommand();
        try
        {
            // Setup the command to execute the stored procedure.
            command.CommandText = "GetDocumentSummary";
            command.CommandType = CommandType.StoredProcedure;

            // Create the input parameter for the DocumentID.
            SqlParameter paramID =
                new SqlParameter("@DocumentID", SqlDbType.Int);
            paramID.Value = documentID;
            command.Parameters.Add(paramID);

            // Create the output parameter to retrieve the summary.
            SqlParameter paramSummary =
                new SqlParameter("@DocumentSummary", SqlDbType.NVarChar, -1);
            paramSummary.Direction = ParameterDirection.Output;
            command.Parameters.Add(paramSummary);

            // List the parameters and some of properties.
            SqlParameterCollection paramCollection = command.Parameters;
            string parameterList = "";
            for (int i = 0; i < paramCollection.Count; i++)
            {
                parameterList += String.Format("  {0}, {1}, {2}\n",
                    paramCollection[i], paramCollection[i].DbType,
                    paramCollection[i].Direction);
            }
            Console.WriteLine("Parameter Collection:\n" + parameterList);

            // Execute the stored procedure; retrieve
            // and display the output parameter value.
            command.ExecuteNonQuery();
            Console.WriteLine((String)(paramSummary.Value));
            return (String)(paramSummary.Value);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
            return null;
        }
    }
}

另请参阅

适用于