SqlParameterCollection.Item[] Proprietà

Definizione

Spazio dei nomi:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacchetto:

System.Data.SqlClient v4.8.6

Ottiene SqlParameter con un attributo specificato.

Overload

Item[String]	Ottiene SqlParameter con il nome specificato.
Item[Int32]	Ottiene SqlParameter in corrispondenza dell'indice specificato.

Item[String]

Ottiene SqlParameter con il nome specificato.

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

member this.Item(string) : System.Data.SqlClient.SqlParameter with get, set

Default Public Property Item(parameterName As String) As SqlParameter

Parametri

parameterName

String

Nome del parametro da recuperare.

Valore della proprietà

SqlParameter

SqlParameter con il nome specificato.

Eccezioni

IndexOutOfRangeException

Il parametro parameterName specificato non è valido.

Commenti

Viene parameterName utilizzato per cercare il valore di indice nell'oggetto sottostante SqlParameterCollection. Se non parameterName è valido, verrà generata un'eccezione IndexOutOfRangeException .

Vedi anche

• Comandi e parametri (ADO.NET)
• Parametri DataAdapter (ADO.NET)
• Uso del provider di dati .NET Framework per SQL Server
• Panoramica di ADO.NET

Item[Int32]

Ottiene SqlParameter in corrispondenza dell'indice specificato.

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

member this.Item(int) : System.Data.SqlClient.SqlParameter with get, set

Default Public Property Item(index As Integer) As SqlParameter

Parametri

index

Int32

Indice in base zero del parametro da recuperare.

Valore della proprietà

SqlParameter

Oggetto SqlParameter in corrispondenza dell'indice specificato.

Eccezioni

IndexOutOfRangeException

L'indice specificato non esiste.

Esempio

Nell'esempio seguente viene illustrata la creazione SqlParameter di oggetti per fornire un parametro di input a una stored procedure che restituisce i risultati in un parametro di output. Il codice scorre gli elementi in SqlParameterCollection e visualizza alcune proprietà dei parametri nella finestra della console. In questo esempio si presuppone un stringa di connessione valido per il database di esempio AdventureWorks in un'istanza di 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;
        }
    }
}

Vedi anche

• Comandi e parametri (ADO.NET)
• Parametri DataAdapter (ADO.NET)
• Uso del provider di dati .NET Framework per SQL Server
• Panoramica di ADO.NET