.NET Framework-Klassenbibliothek
SqlParameter-Klasse

Stellt einen Parameter für einen SqlCommand sowie optional dessen Zuordnung zu DataSet-Spalten dar. Diese Klasse kann nicht geerbt werden.

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

Syntax
Visual Basic (Deklaration) 
Public NotInheritable Class SqlParameter
    Inherits DbParameter
    Implements IDbDataParameter, IDataParameter, ICloneable
Visual Basic (Verwendung) 
Dim instance As SqlParameter
C# 
public sealed class SqlParameter : DbParameter, IDbDataParameter, IDataParameter, ICloneable
C++ 
public ref class SqlParameter sealed : public DbParameter, IDbDataParameter, IDataParameter, ICloneable
J# 
public final class SqlParameter extends DbParameter implements IDbDataParameter, IDataParameter, 
    ICloneable
JScript 
public final class SqlParameter extends DbParameter implements IDbDataParameter, IDataParameter, 
    ICloneable
Hinweise

Bei Parameternamen wird die Groß- und Kleinschreibung nicht berücksichtigt.
Beispiel

Im folgenden Beispiel werden über die SqlParameterCollection-Auflistung im SqlDataAdapter mehrere Instanzen von SqlParameter erstellt. Mithilfe dieser Parameter werden Daten aus der Datenquelle ausgewählt und im DataSet platziert. In diesem Beispiel wird davon ausgegangen, dass mithilfe des entsprechenden Schemas, der entsprechenden Befehle sowie der entsprechenden Verbindung bereits ein DataSet und ein SqlDataAdapter erstellt wurden.

Visual Basic 
Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub
C# 
public void AddSqlParameters() 
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);

}
Vererbungshierarchie
System.Object
   System.MarshalByRefObject
     System.Data.Common.DbParameter
      System.Data.SqlClient.SqlParameter
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
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
Page view tracker