SqlParameterCollection.Item[] Vlastnost

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll

Získá s SqlParameter zadaným atributem.

Přetížení

Name Description
Item[String]

Získá se SqlParameter zadaným názvem.
Item[Int32]

Získá na zadaném indexu SqlParameter .

Item[String]

Zdroj:
System.Data.SqlClient.notsupported.cs

Získá se SqlParameter zadaným názvem.

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

Parametry

parameterName
String

Název parametru, který se má načíst.

Hodnota vlastnosti

SqlParameter

Se SqlParameter zadaným názvem.

Atributy
BrowsableAttribute

Výjimky

IndexOutOfRangeException

parameterName Zadaný parametr není platný.

Poznámky

Slouží parameterName k vyhledání hodnoty indexu v podkladovém SqlParameterCollectionobjektu . parameterName Pokud není platný, vyvolá se chybaIndexOutOfRangeException.

Viz také

Platí pro

Item[Int32]

Zdroj:
System.Data.SqlClient.notsupported.cs

Získá na zadaném indexu 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

Parametry

index
Int32

Index parametru založený na nule, který se má načíst.

Hodnota vlastnosti

SqlParameter

V SqlParameter zadaném indexu.

Atributy
BrowsableAttribute

Výjimky

IndexOutOfRangeException

Zadaný index neexistuje.

Příklady

Následující příklad ukazuje vytvoření SqlParameter objektů pro zadání vstupního parametru uložené procedury, která vrací výsledky ve výstupním parametru. Kód prochází položky v okně SqlParameterCollection konzoly a zobrazuje některé vlastnosti parametru. Tento příklad předpokládá platnou připojovací řetězec do ukázkové databáze AdventureWorks v instanci 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;
        }
    }
}

Viz také

Platí pro