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

Отсчитываемый от нуля индекс извлекаемого параметра.

Значение свойства

SqlParameter

По SqlParameter указанному индексу.

Атрибуты
BrowsableAttribute

Исключения

IndexOutOfRangeException

Указанный индекс не существует.

Примеры

В следующем примере показано создание SqlParameter объектов для предоставления входного параметра хранимой процедуре, возвращающей результаты выходного параметра. Код выполняет итерацию элементов в элементе SqlParameterCollection и отображает некоторые свойства параметров в окне консоли. В этом примере предполагается, что допустимая строка подключения в базу данных AdventureWorks в экземпляре SQL Server.

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

См. также раздел

Применяется к