SqlParameterCollection.Item[] Proprietà

Definizione

Spazio dei nomi:
System.Data.SqlClient
Assembly:
System.Data.dll

Ottiene l'oggetto SqlParameter con un attributo specificato.

Overload

Nome Descrizione
Item[String]

Ottiene l'oggetto SqlParameter con il nome specificato.
Item[Int32]

Ottiene l'oggetto SqlParameter in corrispondenza dell'indice specificato.

Item[String]

Ottiene l'oggetto 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); };
[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

Parametri

parameterName
String

Nome del parametro da recuperare.

Valore della proprietà

SqlParameter

Oggetto SqlParameter con il nome specificato.

Attributi
BrowsableAttribute

Eccezioni

IndexOutOfRangeException

L'oggetto specificato parameterName non è valido.

Commenti

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

Vedi anche

Si applica a

Item[Int32]

Ottiene l'oggetto 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); };
[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

Parametri

index
Int32

Indice in base zero del parametro da recuperare.

Valore della proprietà

SqlParameter

Oggetto SqlParameter in corrispondenza dell'indice specificato.

Attributi
BrowsableAttribute

Eccezioni

IndexOutOfRangeException

L'indice specificato non esiste.

Esempio

Nell'esempio seguente viene illustrata la creazione di SqlParameter 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 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

Si applica a