SqlParameterCollection.Item[] プロパティ

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.SqlClient.dll
アセンブリ:
System.Data.dll

指定した属性を持つ SqlParameter を取得します。

オーバーロード

名前 説明
Item[String]

指定した名前の SqlParameter を取得します。
Item[Int32]

指定したインデックス位置にある SqlParameter を取得します。

Item[String]

ソース:
System.Data.SqlClient.notsupported.cs

指定した名前の SqlParameter を取得します。

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

指定した名前の SqlParameter 。

属性
BrowsableAttribute

例外

IndexOutOfRangeException

指定した parameterName が無効です。

注釈

parameterNameは、基になるSqlParameterCollection内のインデックス値を検索するために使用されます。 parameterNameが無効な場合は、IndexOutOfRangeExceptionがスローされます。

こちらもご覧ください

適用対象

Item[Int32]

ソース:
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

取得するパラメーターの 0 から始まるインデックス。

プロパティ値

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

こちらもご覧ください

適用対象