SqlCeParameterCollection.Add Method (String, Object)

  • Статья

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

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

Синтаксис

'Декларация
Public Function Add ( _
    parameterName As String, _
    value As Object _
) As SqlCeParameter

public SqlCeParameter Add (
    string parameterName,
    Object value
)

public:
SqlCeParameter^ Add (
    String^ parameterName, 
    Object^ value
)

public SqlCeParameter Add (
    String parameterName, 
    Object value
)

public function Add (
    parameterName : String, 
    value : Object
) : SqlCeParameter

Параметры

  • parameterName
    Имя параметра.
  • value
    Значение Object объекта 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");

Многопоточное использование

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

SqlCeParameterCollection Class
SqlCeParameterCollection Members
System.Data.SqlServerCe Namespace