SqlParameterCollection.Item[Int32] SqlParameterCollection.Item[Int32] SqlParameterCollection.Item[Int32] SqlParameterCollection.Item[Int32] Property

Definition

Überlädt

Item[String] Item[String] Item[String] Item[String]

Ruft den SqlParameter mit dem angegebenen Namen ab.Gets the SqlParameter with the specified name.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft den SqlParameter am angegebenen Index ab.Gets the SqlParameter at the specified index.

Item[String] Item[String] Item[String] Item[String]

Ruft den SqlParameter mit dem angegebenen Namen ab.Gets the SqlParameter with the specified name.

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; }
member this.Item(string) : System.Data.SqlClient.SqlParameter with get, set
Default Public Property Item(parameterName As String) As SqlParameter

Parameter

parameterName
String String String String

Der Name des abzurufenden Parameters.The name of the parameter to retrieve.

Eigenschaftswert

Der SqlParameter mit dem angegebenen Namen.The SqlParameter with the specified name.

Ausnahmen

Der angegebene parameterName ist ungültig.The specified parameterName is not valid.

Hinweise

Wird verwendet, um den Indexwert in der zugrunde liegenden SqlParameterCollectionzu suchen. parameterNameThe parameterName is used to look up the index value in the underlying SqlParameterCollection. Wenn die parameterName ungültig ist, wird eine IndexOutOfRangeException ausgelöst.If the parameterName is not valid, an IndexOutOfRangeException will be thrown.

Siehe auch

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft den SqlParameter am angegebenen Index ab.Gets the SqlParameter at the specified index.

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; }
member this.Item(int) : System.Data.SqlClient.SqlParameter with get, set
Default Public Property Item(index As Integer) As SqlParameter

Parameter

index
Int32 Int32 Int32 Int32

Der nullbasierte Index des abzurufenden Parameters.The zero-based index of the parameter to retrieve.

Eigenschaftswert

Der SqlParameter am angegebenen Index.The SqlParameter at the specified index.

Ausnahmen

Der angegebene Index ist nicht vorhanden.The specified index does not exist.

Beispiele

Im folgenden Beispiel wird das SqlParameter Erstellen von-Objekten veranschaulicht, um einen Eingabeparameter für eine gespeicherte Prozedur bereitzustellen, die Ergebnisse in einem Output-Parameter zurückgibt.The following example demonstrates creating SqlParameter objects to supply an input parameter to a stored procedure that returns results in an output parameter. Der Code durchläuft die Elemente im SqlParameterCollection und zeigt einige Parameter Eigenschaften im Konsolenfenster an.The code iterates through the items in the SqlParameterCollection and displays some parameter properties in the console window. In diesem Beispiel wird davon ausgegangen, dass eine gültige Verbindungs Zeichenfolge für die AdventureWorks -Beispieldatenbank auf einer Instanz von SQL Server.This example assumes a valid connection string to the AdventureWorks sample database on an instance of 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;
        }
    }
}
Siehe auch

Gilt für: