SqlParameterCollection.Item[] 속성

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

오버로드

Item[String]	지정된 이름을 가진 SqlParameter를 가져옵니다.
Item[Int32]	지정된 인덱스의 SqlParameter를 가져옵니다.

Item[String]

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

public:
 property Microsoft::Data::SqlClient::SqlParameter ^ default[System::String ^] { Microsoft::Data::SqlClient::SqlParameter ^ get(System::String ^ parameterName); void set(System::String ^ parameterName, Microsoft::Data::SqlClient::SqlParameter ^ value); };

[System.ComponentModel.Browsable(false)]
public Microsoft.Data.SqlClient.SqlParameter this[string parameterName] { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Item(string) : Microsoft.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됩니다.

Item[Int32]

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

public:
 property Microsoft::Data::SqlClient::SqlParameter ^ default[int] { Microsoft::Data::SqlClient::SqlParameter ^ get(int index); void set(int index, Microsoft::Data::SqlClient::SqlParameter ^ value); };

[System.ComponentModel.Browsable(false)]
public Microsoft.Data.SqlClient.SqlParameter this[int index] { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Item(int) : Microsoft.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 샘플 데이터베이스에 대한 유효한 연결 문자열을 가정합니다.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        // Supply any valid Document ID value.
        // The value 7 is supplied for demonstration purposes.
        string summaryString = CreateSqlParameters(7);
        Console.ReadLine();
    }
    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;
            }
        }
    }
    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property
        return "Data Source=(local);Initial Catalog=AdventureWorks;" +
            "Integrated Security=SSPI";
    }
}