SqlParameter Klasse

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Stellt einen Parameter zu einem SqlCommand und optional dessen Zuordnung zu Spalten dar DataSet . Diese Klasse kann nicht vererbt werden. Weitere Informationen zu Parametern finden Sie unter Konfigurieren von Parametern und Parameterdatentypen.

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Vererbung

Object

MarshalByRefObject

DbParameter

SqlParameter

Attribute

TypeConverterAttribute

Implementiert

IDataParameter IDbDataParameter ICloneable

Beispiele

Im folgenden Beispiel werden mehrere Instanzen der SqlParameter Auflistung innerhalb der SqlParameterCollectionSqlDataAdapter. Diese Parameter werden verwendet, um Daten aus der Datenquelle auszuwählen und die Daten in die DataSetDatei einzufügen. In diesem Beispiel wird davon ausgegangen, dass eine und eine DataSetSqlDataAdapter bereits mithilfe des entsprechenden Schemas, der entsprechenden Befehle und der Verbindung erstellt wurde. Weitere Informationen und zusätzliche Beispiele zur Verwendung von Parametern finden Sie unter Retrieving and Modifying Data in ADO.NET and Configuring Parameters and Parameter Data Types.

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);
}

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

Hinweise

Bei Parameternamen wird die Groß-/Kleinschreibung nicht beachtet.

Note

Nameless, auch als Ordinal bezeichnet, Parameter werden vom .NET Framework-Datenanbieter für SQL Server nicht unterstützt.

Weitere Informationen finden Sie zusammen mit zusätzlichem Beispielcode, der die Verwendung von Parametern veranschaulicht, unter "Befehle und Parameter".

Konstruktoren

Name	Beschreibung
SqlParameter()	Initialisiert eine neue Instanz der SqlParameter-Klasse.
SqlParameter(String, Object)	Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen und einen Wert des neuen SqlParameterverwendet.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Initialisiert eine neue Instanz der SqlParameter Klasse, die den Parameternamen, den Typ des Parameters, die Größe des Parameters, a ParameterDirection, die Genauigkeit des Parameters, die Skalierung des Parameters, die Quellspalte, die DataRowVersion zu verwendende Spalte und den Wert des Parameters verwendet.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Initialisiert eine neue Instanz der SqlParameter Klasse, die den Parameternamen, den Typ des Parameters, die Länge des Parameters, die Richtung, die Genauigkeit, die Skalierung, den Namen der Quellspalte, einen der Werte, einen booleschen DataRowVersion Wert für die Quellspaltenzuordnung, den Wert des SqlParameterParameters, den Namen der Datenbank, in der sich die Schemaauflistung für diese XML-Instanz befindet, das eigene relationale Schema, in dem sich die Schemaauflistung für diese XML-Instanz befindet, und den Namen der Schemaauflistung für diesen Parameter.
SqlParameter(String, SqlDbType, Int32, String)	Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen, die SqlDbTypeGröße und den Quellspaltennamen verwendet.
SqlParameter(String, SqlDbType, Int32)	Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen, die SqlDbTypeGröße und die Größe verwendet.
SqlParameter(String, SqlDbType)	Initialisiert eine neue Instanz der Klasse, die SqlParameter den Parameternamen und den Datentyp verwendet.

Eigenschaften

Name	Beschreibung
CompareInfo	Dient zum Abrufen oder Festlegen des CompareInfo Objekts, das definiert, wie Zeichenfolgenvergleiche für diesen Parameter ausgeführt werden sollen.
DbType	Dient zum SqlDbType Abrufen oder Festlegen des Parameters.
Direction	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Parameter eingabegeschützt, ausgabegeschützt, bidirektional oder ein gespeicherter Prozedur-Rückgabewertparameter ist.
ForceColumnEncryption	Erzwingt die Verschlüsselung eines Parameters bei Verwendung von Always Encrypted. Wenn SQL Server den Treiber darüber informiert, dass der Parameter nicht verschlüsselt werden muss, schlägt die Abfrage mit dem Parameter fehl. Diese Eigenschaft bietet zusätzlichen Schutz vor Sicherheitsangriffen, die eine kompromittierte SQL Server bereitstellen falsche Verschlüsselungsmetadaten für den Client, was zu einer Offenlegung von Daten führen kann.
IsNullable	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Parameter Nullwerte akzeptiert. IsNullable wird nicht verwendet, um den Wert des Parameters zu überprüfen und verhindert nicht, dass beim Ausführen eines Befehls ein NULL-Wert gesendet oder empfangen wird.
LocaleId	Dient zum Abrufen oder Festlegen des Gebietsschemabezeichners, der Konventionen und Sprache für eine bestimmte Region bestimmt.
Offset	Dient zum Abrufen oder Festlegen des Offsets auf die Value Eigenschaft.
ParameterName	Dient zum Abrufen oder Festlegen des Namens der SqlParameter.
Precision	Ruft die maximale Anzahl von Ziffern ab, die zum Darstellen der Value Eigenschaft verwendet werden, oder legt diese fest.
Scale	Ruft die Anzahl der Dezimalstellen ab, auf die aufgelöst wird, Value oder legt diese fest.
Size	Ruft die maximale Größe der Daten innerhalb der Spalte in Bytes ab oder legt sie fest.
SourceColumn	Dient zum Abrufen oder Festlegen des Namens der Quellspalte, die dem DataSet Laden oder Zurückgeben der ValueQuellspalte zugeordnet und verwendet wird.
SourceColumnNullMapping	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Quellspalte nullwertebar ist. Dadurch können SqlCommandBuilder Aktualisierungsanweisungen für nullwerte Spalten ordnungsgemäß generiert werden.
SourceVersion	Dient zum Abrufen oder Festlegen der DataRowVersion zu verwendenden Eigenschaft, wenn Sie geladen Valuewerden.
SqlDbType	Dient zum SqlDbType Abrufen oder Festlegen des Parameters.
SqlValue	Dient zum Abrufen oder Festlegen des Werts des Parameters als SQL-Typ.
TypeName	Dient zum Abrufen oder Festlegen des Typnamens für einen Tabellenwertparameter.
UdtTypeName	Dient zum Abrufen oder Festlegen eines string Werts, der einen benutzerdefinierten Typ als Parameter darstellt.
Value	Dient zum Abrufen oder Festlegen des Werts des Parameters.
XmlSchemaCollectionDatabase	Ruft den Namen der Datenbank ab, in der sich die Schemaauflistung für diese XML-Instanz befindet.
XmlSchemaCollectionName	Ruft den Namen der Schemaauflistung für diese XML-Instanz ab.
XmlSchemaCollectionOwningSchema	Das eigene relationale Schema, in dem sich die Schemaauflistung für diese XML-Instanz befindet.

Methoden

Name	Beschreibung
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject)
ResetDbType()	Setzt den diesem SqlParameterZugeordneten Typ zurück.
ResetSqlDbType()	Setzt den diesem SqlParameterZugeordneten Typ zurück.
ToString()	Ruft eine Zeichenfolge ab, die die ParameterName.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
ICloneable.Clone()	Eine Beschreibung dieses Mitglieds finden Sie unter Clone().
IDbDataParameter.Precision	Gibt die Genauigkeit numerischer Parameter an. (Geerbt von DbParameter)
IDbDataParameter.Scale	Eine Beschreibung dieses Mitglieds finden Sie unter Scale. (Geerbt von DbParameter)

Weitere Informationen

• SqlParameterCollection
• SqlCommand
• Befehle und Parameter
• DataAdapter-Parameter
• SQL Server und ADO.NET
• Übersicht über ADO.NET