SqlParameterCollection.Item[] 속성

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.dll

지정된 특성을 가진 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); };

[System.ComponentModel.Browsable(false)]
public System.Data.SqlClient.SqlParameter this[string parameterName] { 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 throw됩니다.

추가 정보

• 명령 및 매개 변수(ADO.NET)
• DataAdapter 매개 변수(ADO.NET)
• .NET Framework Data Provider for SQL Server 사용
• ADO.NET 개요

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

[System.ComponentModel.Browsable(false)]
public System.Data.SqlClient.SqlParameter this[int index] { 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 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;
        }
    }
}

추가 정보

• 명령 및 매개 변수(ADO.NET)
• DataAdapter 매개 변수(ADO.NET)
• .NET Framework Data Provider for SQL Server 사용
• ADO.NET 개요