SqlParameterCollection.Item[] 속성

정의

네임스페이스:
System.Data.SqlClient
어셈블리:
System.Data.SqlClient.dll
어셈블리:
System.Data.dll

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

오버로드

Name Description
Item[String]

SqlParameter 지정된 이름을 가진 값을 가져옵니다.
Item[Int32]

지정된 인덱스에서 SqlParameter 가져옵니다.

Item[String]

Source:
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 유효하지 않으면 throw 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

검색할 매개 변수의 인덱스(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;
        }
    }
}

추가 정보

적용 대상