SqlParameter-Klasse

Artikel
08/20/2007

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

'Declaration
Public NotInheritable Class SqlParameter
    Inherits DbParameter
    Implements IDbDataParameter, IDataParameter, ICloneable
'Usage
Dim instance As SqlParameter

public sealed class SqlParameter : DbParameter, IDbDataParameter, IDataParameter, ICloneable

public ref class SqlParameter sealed : public DbParameter, IDbDataParameter, IDataParameter, ICloneable

public final class SqlParameter extends DbParameter implements IDbDataParameter, IDataParameter, 
    ICloneable

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.

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

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

Referenz

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

Freigeben über