SqlCommand.Parameters Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v7.0.1

Ruft SqlParameterCollection ab.

public:
 property Microsoft::Data::SqlClient::SqlParameterCollection ^ Parameters { Microsoft::Data::SqlClient::SqlParameterCollection ^ get(); };

public Microsoft.Data.SqlClient.SqlParameterCollection Parameters { get; }

member this.Parameters : Microsoft.Data.SqlClient.SqlParameterCollection

Public ReadOnly Property Parameters As SqlParameterCollection

Eigenschaftswert

SqlParameterCollection

Die Parameter der Transact-SQL-Anweisung oder gespeicherten Prozedur. Der Standardwert ist eine leere Auflistung.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie einen SqlCommand Parameter erstellen und dem SqlParameterCollection.

using System;
using System.Data;
using Microsoft.Data.SqlClient;


class Program
{
    static void Main()
    {
        string connectionString = GetConnectionString();
        string demo = @"<StoreSurvey xmlns=""http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/StoreSurvey""><AnnualSales>1500000</AnnualSales><AnnualRevenue>150000</AnnualRevenue><BankName>Primary International</BankName><BusinessType>OS</BusinessType><YearOpened>1974</YearOpened><Specialty>Road</Specialty><SquareFeet>38000</SquareFeet><Brands>3</Brands><Internet>DSL</Internet><NumberEmployees>40</NumberEmployees></StoreSurvey>";
        Int32 id = 3;
        UpdateDemographics(id, demo, connectionString);
        Console.ReadLine();
    }
    private static void UpdateDemographics(Int32 customerID,
        string demoXml, string connectionString)
    {
        // Update the demographics for a store, which is stored 
        // in an xml column. 
        string commandText = "UPDATE Sales.Store SET Demographics = @demographics "
            + "WHERE CustomerID = @ID;";

        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            SqlCommand command = new SqlCommand(commandText, connection);
            command.Parameters.Add("@ID", SqlDbType.Int);
            command.Parameters["@ID"].Value = customerID;

            // Use AddWithValue to assign Demographics.
            // SQL Server will implicitly convert strings into XML.
            command.Parameters.AddWithValue("@demographics", demoXml);

            try
            {
                connection.Open();
                Int32 rowsAffected = command.ExecuteNonQuery();
                Console.WriteLine("RowsAffected: {0}", rowsAffected);
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
        }
    }
    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file.
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI";
    }
}

Hinweise

Das Microsoft .NET Framework-Datenanbieter für SQL Server unterstützt nicht den Fragezeichenplatzhalter (?), um Parameter an eine SQL-Anweisung oder eine gespeicherte Prozedur zu übergeben, die von einem Befehl von CommandType.Text aufgerufen wird. In diesem Fall müssen benannte Parameter verwendet werden. Beispiel:

SELECT * FROM Customers WHERE CustomerID = @CustomerID

Hinweis

Wenn die Parameter in der Auflistung nicht den Anforderungen der auszuführenden Abfrage entsprechen, kann ein Fehler auftreten.

Weitere Informationen finden Sie unter Konfigurieren von Parametern.