SqlParameterCollection.Item[] Properti

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Paket:

System.Data.SqlClient v4.8.6

SqlParameter Mendapatkan dengan atribut tertentu.

Overload

Item[String]	SqlParameter Mendapatkan dengan nama yang ditentukan.
Item[Int32]	Mendapatkan pada SqlParameter indeks yang ditentukan.

Item[String]

SqlParameter Mendapatkan dengan nama yang ditentukan.

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

Parameter

parameterName

String

Nama parameter yang akan diambil.

Nilai Properti

SqlParameter

SqlParameter dengan nama yang ditentukan.

Atribut

BrowsableAttribute

Pengecualian

IndexOutOfRangeException

Yang ditentukan parameterName tidak valid.

Keterangan

parameterName digunakan untuk mencari nilai indeks di yang mendasar SqlParameterCollection. parameterName Jika tidak valid, akan IndexOutOfRangeException dilemparkan.

Lihat juga

• Perintah dan Parameter (ADO.NET)
• Parameter DataAdapter (ADO.NET)
• Menggunakan Penyedia Data .NET Framework untuk SQL Server
• Ringkasan ADO.NET

Item[Int32]

Mendapatkan pada SqlParameter indeks yang ditentukan.

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

Parameter

index

Int32

Indeks berbasis nol dari parameter yang akan diambil.

Nilai Properti

SqlParameter

pada SqlParameter indeks yang ditentukan.

Atribut

BrowsableAttribute

Pengecualian

IndexOutOfRangeException

Indeks yang ditentukan tidak ada.

Contoh

Contoh berikut menunjukkan pembuatan SqlParameter objek untuk menyediakan parameter input ke prosedur tersimpan yang mengembalikan hasil dalam parameter output. Kode melakukan iterasi melalui item di SqlParameterCollection dan menampilkan beberapa properti parameter di jendela konsol. Contoh ini mengasumsikan string koneksi yang valid ke database sampel AdventureWorks pada instans 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;
        }
    }
}

Lihat juga

• Perintah dan Parameter (ADO.NET)
• Parameter DataAdapter (ADO.NET)
• Menggunakan Penyedia Data .NET Framework untuk SQL Server
• Ringkasan ADO.NET