SqlCeParameterCollection.Add-Methode (String, Object)
Hinweis: Diese API ist veraltet.
Fügt SqlCeParameterCollection einen SqlCeParameter mit dem angegebenen Parameternamen und -wert hinzu.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Syntax
'Declaration
<ObsoleteAttribute("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value).", _
False)> _
Public Function Add ( _
parameterName As String, _
value As Object _
) As SqlCeParameter
'Usage
Dim instance As SqlCeParameterCollection
Dim parameterName As String
Dim value As Object
Dim returnValue As SqlCeParameter
returnValue = instance.Add(parameterName, _
value)
[ObsoleteAttribute("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value).",
false)]
public SqlCeParameter Add(
string parameterName,
Object value
)
[ObsoleteAttribute(L"Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value).",
false)]
public:
SqlCeParameter^ Add(
String^ parameterName,
Object^ value
)
[<ObsoleteAttribute("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value).",
false)>]
member Add :
parameterName:string *
value:Object -> SqlCeParameter
public function Add(
parameterName : String,
value : Object
) : SqlCeParameter
Parameter
- parameterName
Typ: System.String
Der Name des Parameters.
- value
Typ: System.Object
Der Object-Wert von SqlCeParameter, der der Auflistung hinzugefügt werden soll.
Rückgabewert
Typ: System.Data.SqlServerCe.SqlCeParameter
Ein Verweis auf das neue SqlCeParameter-Objekt.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidCastException | Das als value-Parameter bereitgestellte Objekt kann nicht in eine Zeichenfolge konvertiert werden. Dies kann passieren, wenn das Objekt kein primitiver Typ, SqlDbType oder Bytearray ist. |
Hinweise
Der SqlDbType des neuen SqlCeParameter-Objekts wird nicht vom .NET Compact Framework-Typ des value-Parameters abgeleitet. Die Value-Eigenschaft des neuen SqlCeParameter-Objekts wird auf die Zeichenfolge festgelegt, die aus der Konvertierung des value-Parameters ermittelt wurde. SqlDbType wird auf SqlDbType.NChar festgelegt.
Wenn Sie den SqlDbType des Parameters bei der Erstellung explizit festlegen möchten, müssen Sie eine der anderen überladenen Add-Methoden verwenden.
Beispiele
Im folgenden Beispiel wird einer SqlCeParameterCollection-Klasse ein neues Element hinzugefügt. Dabei wird vorausgesetzt, dass bereits eine SqlCeCommand-Klasse erstellt wurde.
cmd.Parameters.Add("@Description", "Beverages")
cmd.Parameters.Add("@Description", "Beverages");