SqlCommand.Parameters-Eigenschaft

Ruft die SqlParameterCollection ab.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public ReadOnly Property Parameters As SqlParameterCollection
'Usage
Dim instance As SqlCommand
Dim value As SqlParameterCollection

value = instance.Parameters

public SqlParameterCollection Parameters { get; }

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

/** @property */
public SqlParameterCollection get_Parameters ()

public function get Parameters () : SqlParameterCollection

Eigenschaftenwert

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

Hinweise

Beim Übergeben von Parametern an eine SQL-Anweisung oder eine gespeicherte Prozedur, die durch einen CommandType.Text-Befehl aufgerufen wird, bietet der .NET Framework-Datenanbieter für SQL Server keine Unterstützung für Fragezeichenplatzhalter (?). In diesem Fall müssen benannte Parameter verwendet werden. Beispiel:

SELECT * FROM Customers WHERE CustomerID = @CustomerID

Weitere Informationen finden Sie unter Verwenden von gespeicherten Prozeduren mit einem Befehl.

Beispiel

Im folgenden Beispiel wird ein SqlCommand erstellt, und dessen Parameter werden angezeigt. Dafür wird der Methode eine SqlConnection, eine Abfragezeichenfolge, die eine Transact-SQL-SELECT-Anweisung ist, und ein Array von SqlParameter-Objekten übergeben.

Public Sub CreateSqlCommand(ByVal connection As SqlConnection, _
ByVal queryString As String, ByVal params() As SqlParameter)

    Dim command As New SqlCommand(queryString, connection)
    command.CommandText = _
       "SELECT CustomerID, CompanyName FROM Customers " _
       & "WHERE Country = @Country AND City = @City"
    command.UpdatedRowSource = UpdateRowSource.Both
    command.Parameters.Add(params)

    Dim j As Integer
    For j = 0 To command.Parameters.Count - 1
        command.Parameters.Add(params(j))
    Next j

    Dim message As String = ""
    Dim i As Integer
    For i = 0 To command.Parameters.Count - 1
        message += command.Parameters(i).ToString() & ControlChars.Cr
    Next i

    Console.WriteLine(message)
End Sub

public void CreateSqlCommand(SqlConnection myConnection,
    string queryString, SqlParameter[] paramArray) 
{
    SqlCommand command = new SqlCommand(queryString, myConnection);
    command.CommandText = 
        "SELECT CustomerID, CompanyName FROM Customers " 
        + "WHERE Country = @Country AND City = @City";    
    command.Parameters.Add(paramArray);

    for (int j=0; j<paramArray.Length; j++)
    {
        command.Parameters.Add(paramArray[j]) ;
    }

    string message = "";
    for (int i = 0; i < command.Parameters.Count; i++) 
    {
        message += command.Parameters[i].ToString() + "\n";
    }
    Console.WriteLine(message);
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlCommand-Klasse
SqlCommand-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server