(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

SqlParameter-Klasse

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

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

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

Der SqlParameter-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeSqlParameter()Initialisiert eine neue Instanz der SqlParameter-Klasse.
Öffentliche MethodeSqlParameter(String, SqlDbType)Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen und den Datentyp verwendet.
Öffentliche MethodeSqlParameter(String, Object)Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen und den Wert des neuen SqlParameter verwendet.
Öffentliche MethodeSqlParameter(String, SqlDbType, Int32)Initialisiert eine neue Instanz der SqlParameter-Klasse mit dem Parameternamen, dem SqlDbType und der Größe.
Öffentliche MethodeSqlParameter(String, SqlDbType, Int32, String)Initialisiert eine neue Instanz der SqlParameter-Klasse mit dem Parameternamen, dem SqlDbType, der Größe und dem Quellspaltennamen.
Öffentliche MethodeSqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)Initialisiert eine neue Instanz der SqlParameter-Klasse mit dem Parameternamen, dem Typ des Parameters, der Größe des Parameters, einer ParameterDirection, der Genauigkeit des Parameters, der Skalierung des Parameters, der Quellspalte, der zu verwendenden DataRowVersion und dem Wert des Parameters.
Öffentliche MethodeSqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)Initialisiert eine neue Instanz der SqlParameter-Klasse, die den Parameternamen, den Parametertyp, die Länge des Parameters, die Richtung, die Genauigkeit, die Skalierung, den Namen der Quellspalte, einen der DataRowVersion-Werte, einen booleschen Wert für die Quellspaltenzuordnung, den Wert des SqlParameter, den Namen der Datenbank mit der Schemaauflistung für diese XML-Instanz, das besitzende relationale Schema mit der Schemaauflistung dieser XML-Instanz und den Namen der Schemaauflistung für diesen Parameter verwendet.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftCompareInfoRuft das CompareInfo-Objekt ab bzw. legt ein Objekt fest, mit dem definiert wird, wie für diesen Parameter Zeichenfolgenvergleiche durchgeführt werden sollen.
Öffentliche EigenschaftDbTypeRuft den SqlDbType des Parameters ab oder legt diesen fest. (Überschreibt DbParameter.DbType.)
Öffentliche EigenschaftDirectionRuft 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 für gespeicherte Prozeduren handelt. (Überschreibt DbParameter.Direction.)
Öffentliche EigenschaftIsNullableRuft 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 wird nicht das Senden oder Empfangen eines NULL-Werts verhindern, wenn einen Befehl ausführt wird. (Überschreibt DbParameter.IsNullable.)
Öffentliche EigenschaftLocaleIdRuft den Gebietsschemabezeichner fest bzw. legt einen fest, der Konventionen und Sprache für eine bestimmte Region definiert.
Öffentliche EigenschaftOffsetRuft den Offset zur Value-Eigenschaft ab, oder legt einen fest.
Öffentliche EigenschaftParameterNameRuft den Namen des SqlParameter ab oder legt einen fest. (Überschreibt DbParameter.ParameterName.)
Öffentliche EigenschaftPrecisionRuft die maximale Anzahl von Ziffern ab, die zur Darstellung der Value-Eigenschaft verwendet werden kann, oder legt diese fest.
Öffentliche EigenschaftScaleRuft die Anzahl der Dezimalstellen ab, in die der Value aufgelöst wird, oder legt diese fest.
Öffentliche EigenschaftSizeRuft die maximale Größe der Daten innerhalb der Spalte in Bytes ab oder legt diese fest. (Überschreibt DbParameter.Size.)
Öffentliche EigenschaftSourceColumnRuft den Namen der Quellspalte ab, die dem DataSet zugeordnet ist und zum Laden oder Zurückgeben des Value verwendet wird, oder legt einen Namen fest. (Überschreibt DbParameter.SourceColumn.)
Öffentliche EigenschaftSourceColumnNullMappingRuft einen Wert ab oder legt einen Wert fest, der angibt, ob die Quellspalte NULL-Werte zulässt. So kann SqlCommandBuilder ordnungsgemäß Update-Anweisungen für Spalten generieren, die NULL-Werte zulassen. (Überschreibt DbParameter.SourceColumnNullMapping.)
Öffentliche EigenschaftSourceVersionRuft die DataRowVersion ab, die beim Laden von Value verwendet werden soll, oder legt eine Version fest. (Überschreibt DbParameter.SourceVersion.)
Öffentliche EigenschaftSqlDbTypeRuft den SqlDbType des Parameters ab oder legt diesen fest.
Öffentliche EigenschaftSqlValueRuft den Wert des Parameters ab oder legt ihn als SQL-Typ fest.
Öffentliche EigenschaftTypeNameRuft den Typnamen für einen Tabellenwertparameter ab oder legt diesen fest.
Öffentliche EigenschaftUdtTypeNameRuft einen string ab bzw. legt einen fest, der einen benutzerdefinierten Typ als Parameter darstellt.
Öffentliche EigenschaftValueRuft den Wert des Parameters ab oder legt diesen fest. (Überschreibt DbParameter.Value.)
Öffentliche EigenschaftXmlSchemaCollectionDatabaseRuft den Namen der Datenbank ab, in der sich die Schemaauflistung für diese XML-Instanz befindet.
Öffentliche EigenschaftXmlSchemaCollectionNameRuft den Namen der für diese XML-Instanz verwendeten Schemaauflistung ab.
Öffentliche EigenschaftXmlSchemaCollectionOwningSchemaDas besitzende relationale Schema, in dem sich die Schemaauflistung für diese XML-Instanz befindet.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeCreateObjRefErstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Von MarshalByRefObject geerbt.)
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeGetLifetimeServiceRuft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeInitializeLifetimeServiceRuft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.)
Öffentliche MethodeResetDbTypeSetzt den diesem SqlParameter zugeordneten Typ zurück. (Überschreibt DbParameter.ResetDbType().)
Öffentliche MethodeResetSqlDbTypeSetzt den diesem SqlParameter zugeordneten Typ zurück.
Öffentliche MethodeToStringRuft eine Zeichenfolge ab, die den ParameterName enthält. (Überschreibt Object.ToString().)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeICloneable.CloneEine Beschreibung dieses Members finden Sie unter Clone.
Explizite SchnittstellenimplementierungPrivate EigenschaftIDbDataParameter.PrecisionGibt die Genauigkeit numerischer Parameter an. (Von DbParameter geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIDbDataParameter.ScaleEine Beschreibung dieses Members finden Sie unter IDbDataParameter.Scale. (Von DbParameter geerbt.)
Zum Seitenanfang

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

HinweisHinweis

Namenlose, auch ordinal genannte, Parameter werden nicht vom .NET Framework-Datenanbieter für SQL Server unterstützt.

Weitere Informationen mit zusätzlichem Beispielcode, der demonstriert, wie Sie Parameter verwenden können, finden Sie unter Befehle und Parameter.

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. Weitere Informationen sowie 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);

}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

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

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft