다음을 통해 공유


SqlParameterCollection.Item[] 속성

정의

지정된 특성을 가진 SqlParameter를 가져옵니다.

오버로드

Item[String]

지정된 이름을 가진 SqlParameter를 가져옵니다.

Item[Int32]

지정된 인덱스의 SqlParameter를 가져옵니다.

Item[String]

지정된 이름을 가진 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입니다.

특성

예외

지정된 parameterName가 잘못된 경우

설명

parameterName 기본 에서 인덱스 값을 조회하는 SqlParameterCollection데 사용됩니다. 가 parameterName 유효하지 않으면 이 IndexOutOfRangeException throw됩니다.

추가 정보

적용 대상

Item[Int32]

지정된 인덱스의 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 방법을 보여 줍니다. 코드는 의 항목을 SqlParameterCollection 반복하고 콘솔 창에 일부 매개 변수 속성을 표시합니다. 이 예제에서는 SQL Server instance 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;
        }
    }
}

추가 정보

적용 대상