SqlParameterCollection.Item[] Eigenschap

Definitie

Naamruimte:
System.Data.SqlClient
Assembly:
System.Data.dll

Hiermee haalt u het SqlParameter met een opgegeven kenmerk op.

Overloads

Name Description
Item[String]

Hiermee haalt u de SqlParameter met de opgegeven naam op.
Item[Int32]

Haalt de SqlParameter opgegeven index op.

Item[String]

Hiermee haalt u de SqlParameter met de opgegeven naam op.

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

Parameters

parameterName
String

De naam van de parameter die moet worden opgehaald.

Waarde van eigenschap

SqlParameter

De SqlParameter met de opgegeven naam.

Kenmerken
BrowsableAttribute

Uitzonderingen

IndexOutOfRangeException

De opgegeven parameterName waarde is ongeldig.

Opmerkingen

De parameterName waarde wordt gebruikt om de indexwaarde in de onderliggende SqlParameterCollectionwaarde op te zoeken. Als de parameterName waarde niet geldig is, wordt er een IndexOutOfRangeException gegooid.

Zie ook

Van toepassing op

Item[Int32]

Haalt de SqlParameter opgegeven index op.

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

Parameters

index
Int32

De op nul gebaseerde index van de parameter die moet worden opgehaald.

Waarde van eigenschap

SqlParameter

De SqlParameter opgegeven index.

Kenmerken
BrowsableAttribute

Uitzonderingen

IndexOutOfRangeException

De opgegeven index bestaat niet.

Voorbeelden

In het volgende voorbeeld ziet u hoe u objecten maakt SqlParameter om een invoerparameter op te geven aan een opgeslagen procedure die resultaten retourneert in een uitvoerparameter. De code doorloopt de items in de SqlParameterCollection en geeft enkele parametereigenschappen weer in het consolevenster. In dit voorbeeld wordt uitgegaan van een geldige verbindingsreeks naar de Adworks voorbeelddatabase op een exemplaar van 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;
        }
    }
}

Zie ook

Van toepassing op