SqlParameter Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen Parameter für einen SqlCommand und optional für seine Zuordnung zu DataSet-Spalten dar. 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
public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
public sealed class SqlParameter : System.Data.Common.DbParameter
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
type SqlParameter = class
inherit DbParameter
[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
inherit MarshalByRefObject
interface IDbDataParameter
interface IDataParameter
interface ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
inherit DbParameter
interface IDbDataParameter
interface IDataParameter
interface ICloneable
type SqlParameter = class
inherit DbParameter
interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
- Vererbung
- Vererbung
- Vererbung
- Attribute
- Implementiert
Beispiele
Im folgenden Beispiel werden mehrere Instanzen von SqlParameter über die SqlParameterCollection -Auflistung innerhalb des SqlDataAdaptererstellt. Diese Parameter werden verwendet, um Daten aus der Datenquelle auszuwählen und die Daten in der DataSetzu platzieren. In diesem Beispiel wird davon ausgegangen, dass ein DataSet und ein SqlDataAdapter bereits mit dem entsprechenden Schema, den entsprechenden Befehlen und der entsprechenden Verbindung erstellt wurden. Weitere Informationen und weitere Beispiele zur Verwendung von Parametern finden Sie unter Abrufen und Ändern von Daten in ADO.NET und Konfigurieren von Parametern und Parameterdatentypen.
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ß- und Kleinschreibung nicht berücksichtigt.
Hinweis
Namenlose Parameter, auch ordinal genannt, werden vom .NET Framework-Datenanbieter für SQL Server nicht unterstützt.
Weitere Informationen sowie zusätzlichen Beispielcode zur Verwendung von Parametern finden Sie unter Befehle und Parameter.
Konstruktoren
SqlParameter() |
Initialisiert eine neue Instanz der SqlParameter-Klasse. |
SqlParameter(String, Object) |
Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen und einen Wert des neuen SqlParameter verwendet. |
SqlParameter(String, SqlDbType) |
Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen und den Datentyp verwendet. |
SqlParameter(String, SqlDbType, Int32) |
Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen, den SqlDbType und die Größe verwendet. |
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, ein ParameterDirection, die Genauigkeit des Parameters, die Skalierung des Parameters, die Quellspalte, ein zu verwendendes DataRowVersion 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 Folgendes verwendet: den Parameternamen, den Parametertyp, die Parameterlänge, die Richtung, die Genauigkeit, die Skala, den Namen der Quellspalte, einen der DataRowVersion-Werte, einen booleschen Wert für die Quellspaltenzuordnung, den Wert von |
SqlParameter(String, SqlDbType, Int32, String) |
Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen, den SqlDbType, die Größe und den Quellspaltennamen verwendet. |
Eigenschaften
CompareInfo |
Ruft das CompareInfo-Objekt ab, das definiert, wie für diesen Parameter Zeichenfolgenvergleiche durchgeführt werden sollen, oder legt dieses fest. |
DbType |
Ruft den SqlDbType des Parameters ab oder legt ihn fest. |
Direction |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Parameter nur zur Eingabe, nur zur Ausgabe oder bidirektional verwendet wird oder ob es sich um einen Parameter für den Rückgabewert einer gespeicherten Prozedur handelt. |
ForceColumnEncryption |
Erzwingt die Verschlüsselung eines Parameters bei Verwendung von Always Encrypted. Wenn SQL Server den Treiber informiert, dass der Parameter nicht verschlüsselt werden muss, tritt bei der Abfrage, die diesen Parameter verwendet, ein Fehler auf. Diese Eigenschaft bietet zusätzlichen Schutz vor Angriffen, bei denen ein kompromittierter SQL Server falsche Verschlüsselungsmetadaten für den Client bereitstellt, was zur Offenlegung von Daten führen kann. |
IsNullable |
Ruft einen Wert ab, der angibt, ob der Parameter NULL-Werte akzeptiert, oder legt diesen fest. IsNullable wird nicht verwendet, um den Parameterwert zu überprüfen, und verhindert nicht, dass beim Ausführen eines Befehls ein NULL-Wert gesendet oder empfangen wird. |
LocaleId |
Ruft den Gebietsschemabezeichner ab, der Konventionen und die Sprache für eine bestimmte Region bestimmt, oder legt diesen fest. |
Offset |
Ruft den Offset zur Value-Eigenschaft ab oder legt diesen fest. |
ParameterName |
Ruft den Namen der SqlParameter ab oder legt diesen fest. |
Precision |
Ruft die maximale Anzahl von Stellen ab, die verwendet werden, um die Value-Eigenschaft darzustellen, oder legt diese fest. |
Scale |
Ruft die Anzahl der Dezimalstellen ab, in die Value aufgelöst wird, oder legt diese fest. |
Size |
Ruft die maximale Größe der Daten in der Spalte in Byte ab oder legt diese fest. |
SourceColumn |
Ruft den Namen der Quellspalte ab, die dem DataSet zugeordnet ist und zum Laden oder Zurückgeben des Value verwendet wird, oder legt diesen fest. |
SourceColumnNullMapping |
Ruft einen Wert ab, der angibt, ob die Quellspalte NULL-Werte zulässt, oder legt diesen fest. Dadurch kann SqlCommandBuilder ordnungsgemäß Update-Anweisungen für Spalten generieren, die NULL-Werte zulassen. |
SourceVersion |
Ruft die DataRowVersion ab, die beim Laden von Value verwendet werden soll, oder legt diese fest. |
SourceVersion |
Ruft die DataRowVersion ab, die beim Laden von Value verwendet werden soll, oder legt diese fest. (Geerbt von DbParameter) |
SqlDbType |
Ruft den SqlDbType des Parameters ab oder legt ihn fest. |
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 |
Ruft eine |
Value |
Ruft den Wert des Parameters ab oder legt diesen fest. |
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 besitzende relationale Schema, in dem sich die Schemaauflistung für diese XML-Instanz befindet. |
Methoden
CreateObjRef(Type) |
Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject) |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject) |
ResetDbType() |
Setzt den diesem SqlParameter zugeordneten Typ zurück. |
ResetSqlDbType() |
Setzt den diesem SqlParameter zugeordneten Typ zurück. |
ToString() |
Ruft eine Zeichenfolge ab, die den ParameterName enthält. |
Explizite Schnittstellenimplementierungen
ICloneable.Clone() |
Eine Beschreibung dieses Elements finden Sie unter Clone(). |
IDataParameter.SourceVersion |
Ruft die DataRowVersion ab, die beim Laden von Value verwendet werden soll, oder legt diese fest. (Geerbt von DbParameter) |
IDbDataParameter.Precision |
Gibt die Genauigkeit numerischer Parameter an. (Geerbt von DbParameter) |
IDbDataParameter.Scale |
Eine Beschreibung dieses Elements finden Sie unter Scale. (Geerbt von DbParameter) |