Метод SqlCeParameterCollection.Add (String, Object)

Статья
05/27/2011

Примечание. Этот API-интерфейс устарел.

Добавляет SqlCeParameter в коллекцию SqlCeParameterCollection в соответствии с заданными именем и значением параметра.

Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)

Синтаксис

'Декларация
<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
'Применение
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

Параметры

parameterName
Тип: System.String
Имя параметра.

value
Тип: System.Object
Значение Object объекта SqlCeParameter, которое должно быть добавлено к коллекции.

Возвращаемое значение

Тип: System.Data.SqlServerCe.SqlCeParameter
Ссылка на новый объект SqlCeParameter.

Исключения

Исключение	Условие
InvalidCastException	Объект, предоставленный в качестве параметра value, не удалось преобразовать в строку. Это может произойти, если объект не относится к типу-примитиву, не является SqlDbType или массивом байтов.

Замечания

Свойство SqlDbType нового объекта SqlCeParameter не может быть определено исходя из типа .NET Compact Framework параметра value. Свойству Value нового объекта SqlCeParameter присваивается строка, полученная в результате преобразования параметра value, а свойству SqlDbType присваивается значение SqlDbType.NChar.

Если нужно явно задать свойство SqlDbType этого параметра при его создании, то для этого достаточно воспользоваться одним из перегруженных методов Add.

Примеры

Следующий пример демонстрирует добавление нового элемента в SqlCeParameterCollection. При этом подразумевается, что SqlCeCommand уже создан.

cmd.Parameters.Add("@Description", "Beverages")

cmd.Parameters.Add("@Description", "Beverages");

См. также

Справочник

SqlCeParameterCollection Класс

Перегрузка Add

Пространство имен System.Data.SqlServerCe

Share via