SqlParameterCollection.Item[] Eigenschaft

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll

Ruft das SqlParameter mit einem angegebenen Attribut ab.

Überlädt

Name Beschreibung
Item[String]

Ruft den SqlParameter mit dem angegebenen Namen ab.
Item[Int32]

Ruft den SqlParameter am angegebenen Index ab.

Item[String]

Quelle:
System.Data.SqlClient.notsupported.cs

Ruft den SqlParameter mit dem angegebenen Namen ab.

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

Parameter

parameterName
String

Der Name des abzurufenden Parameters.

Eigenschaftswert

SqlParameter

Der SqlParameter mit dem angegebenen Namen.

Attribute
BrowsableAttribute

Ausnahmen

IndexOutOfRangeException

Der angegebene parameterName Wert ist ungültig.

Hinweise

Der parameterName Indexwert wird zum Nachschlagen des Indexwerts im zugrunde liegenden Verwendet SqlParameterCollection. Wenn dies parameterName ungültig ist, wird ein IndexOutOfRangeException Fehler ausgelöst.

Weitere Informationen

Gilt für:

Item[Int32]

Quelle:
System.Data.SqlClient.notsupported.cs

Ruft den SqlParameter am angegebenen Index ab.

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

Parameter

index
Int32

Der nullbasierte Index des abzurufenden Parameters.

Eigenschaftswert

SqlParameter

Der SqlParameter am angegebenen Index.

Attribute
BrowsableAttribute

Ausnahmen

IndexOutOfRangeException

Der angegebene Index ist nicht vorhanden.

Beispiele

Das folgende Beispiel veranschaulicht das Erstellen von SqlParameter Objekten zum Bereitstellen eines Eingabeparameters für eine gespeicherte Prozedur, die Ergebnisse in einem Ausgabeparameter zurückgibt. Der Code durchläuft die Elemente im SqlParameterCollection Konsolenfenster und zeigt einige Parametereigenschaften an. In diesem Beispiel wird eine gültige Verbindungszeichenfolge für die AdventureWorks Beispieldatenbank für eine Instanz von SQL Server angenommen.

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

Weitere Informationen

Gilt für: