SqlParameterCollection.Item[] Egenskap

Definition

Namnområde:
System.Data.SqlClient
Sammansättning:
System.Data.SqlClient.dll
Sammansättning:
System.Data.dll

SqlParameter Hämtar med ett angivet attribut.

Överlagringar

Name Description
Item[String]

SqlParameter Hämtar med det angivna namnet.
Item[Int32]

SqlParameter Hämtar vid det angivna indexet.

Item[String]

Källa:
System.Data.SqlClient.notsupported.cs

SqlParameter Hämtar med det angivna namnet.

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

Parametrar

parameterName
String

Namnet på parametern som ska hämtas.

Egenskapsvärde

SqlParameter

Med SqlParameter det angivna namnet.

Attribut
BrowsableAttribute

Undantag

IndexOutOfRangeException

Angivet parameterName är inte giltigt.

Kommentarer

parameterName Används för att slå upp indexvärdet i den underliggande SqlParameterCollection. Om är parameterName ogiltigt utlöses ett IndexOutOfRangeException .

Se även

Gäller för

Item[Int32]

Källa:
System.Data.SqlClient.notsupported.cs

SqlParameter Hämtar vid det angivna indexet.

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

Parametrar

index
Int32

Det nollbaserade indexet för parametern som ska hämtas.

Egenskapsvärde

SqlParameter

Vid SqlParameter det angivna indexet.

Attribut
BrowsableAttribute

Undantag

IndexOutOfRangeException

Det angivna indexet finns inte.

Exempel

I följande exempel visas hur du skapar SqlParameter objekt för att ange en indataparameter till en lagrad procedur som returnerar resultat i en utdataparameter. Koden itererar genom objekten SqlParameterCollection i och visar vissa parameteregenskaper i konsolfönstret. Det här exemplet förutsätter en giltig reťazec pripojenia till AdventureWorks exempeldatabas på en instans av 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;
        }
    }
}

Se även

Gäller för