Aracılığıyla paylaş

SqlParameterCollection.Item[] Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.SqlClient.dll
Bütünleştirilmiş Kod:
System.Data.dll
Bütünleştirilmiş Kodlar:
netstandard.dll, System.Data.SqlClient.dll
Paket:
System.Data.SqlClient v4.8.6

SqlParameter belirtilen özniteliğiyle alır.

Aşırı Yüklemeler

Item[String]

SqlParameter belirtilen ada sahip öğesini alır.
Item[Int32]

Belirtilen dizinde değerini SqlParameter alır.

Item[String]

SqlParameter belirtilen ada sahip öğesini alır.

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

Parametreler

parameterName
String

Alınacak parametrenin adı.

Özellik Değeri

SqlParameter

SqlParameter belirtilen ada sahip.

Öznitelikler
BrowsableAttribute

Özel durumlar

IndexOutOfRangeException

Belirtilen parameterName geçerli değil.

Açıklamalar

parameterName, temel alınan SqlParameterCollectioniçindeki dizin değerini aramak için kullanılır. parameterName geçerli değilse, bir IndexOutOfRangeException oluşturulur.

Ayrıca bkz.

Şunlara uygulanır

Item[Int32]

Belirtilen dizinde değerini SqlParameter alır.

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

Parametreler

index
Int32

Alınacak parametrenin sıfır tabanlı dizini.

Özellik Değeri

SqlParameter

SqlParameter Belirtilen dizinde.

Öznitelikler
BrowsableAttribute

Özel durumlar

IndexOutOfRangeException

Belirtilen dizin yok.

Örnekler

Aşağıdaki örnekte, bir çıkış parametresiyle sonuç döndüren saklı yordama giriş parametresi sağlamak için nesne oluşturma SqlParameter işlemi gösterilmektedir. Kod içindeki SqlParameterCollection öğelerde yinelenir ve konsol penceresinde bazı parametre özelliklerini görüntüler. Bu örnekte, bir SQL Server örneğindeki AdventureWorks örnek veritabanında geçerli bir bağlantı dizesi olduğu varsayılır.

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

Ayrıca bkz.

Şunlara uygulanır