OleDbParameterCollection.Add Метод

Определение

Перегрузки

Add(OleDbParameter)

Добавляет заданный объект OleDbParameter в OleDbParameterCollection.Adds the specified OleDbParameter to the OleDbParameterCollection.

Add(Object)

Добавляет указанный объект OleDbParameter в коллекцию OleDbParameterCollection.Adds the specified OleDbParameter object to the OleDbParameterCollection.

Add(String, OleDbType)

Добавляет OleDbParameter с заданным именем параметра и типом данных в коллекцию OleDbParameterCollection.Adds an OleDbParameter to the OleDbParameterCollection, given the parameter name and data type.

Add(String, Object)

Добавляет объект OleDbParameter с заданным именем параметра и значением в OleDbParameterCollection.Adds an OleDbParameter to the OleDbParameterCollection given the parameter name and value.

Add(String, OleDbType, Int32)

Добавляет OleDbParameter с заданным именем, типом данных и длиной столбца в OleDbParameterCollection.Adds an OleDbParameter to the OleDbParameterCollection given the parameter name, data type, and column length.

Add(String, OleDbType, Int32, String)

Добавляет объект OleDbParameter с заданным именем параметра, типом данных, длиной столбца и именем столбца источника в OleDbParameterCollection.Adds an OleDbParameter to the OleDbParameterCollection given the parameter name, data type, column length, and source column name.

Add(OleDbParameter)

Добавляет заданный объект OleDbParameter в OleDbParameterCollection.Adds the specified OleDbParameter to the OleDbParameterCollection.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::Data::OleDb::OleDbParameter ^ value);
public System.Data.OleDb.OleDbParameter Add (System.Data.OleDb.OleDbParameter value);
override this.Add : System.Data.OleDb.OleDbParameter -> System.Data.OleDb.OleDbParameter
Public Function Add (value As OleDbParameter) As OleDbParameter

Параметры

value
OleDbParameter

Параметр OleDbParameter для добавления в коллекцию.The OleDbParameter to add to the collection.

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

Индекс нового объекта OleDbParameter.The index of the new OleDbParameter object.

Исключения

OleDbParameter, заданный в параметре value, уже добавлен в эту или другую коллекцию OleDbParameterCollection.The OleDbParameter specified in the value parameter is already added to this or another OleDbParameterCollection.

Параметр value имеет значение null.The value parameter is null.

Примеры

В следующем примере создается OleDbParameterCollection и добавляется OleDbParameter.The following example creates an OleDbParameterCollection and adds an OleDbParameter.

public void CreateParameters() 
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter myParm = paramCollection.Add(
        new OleDbParameter("CustomerID", OleDbType.VarChar));
}
Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim myParm As OleDbParameter = paramCollection.Add( _
    New OleDbParameter("CustomerID", OleDbType.VarChar))
End Sub 

Дополнительно

Add(Object)

Добавляет указанный объект OleDbParameter в коллекцию OleDbParameterCollection.Adds the specified OleDbParameter object to the OleDbParameterCollection.

public:
 virtual int Add(System::Object ^ value);
public int Add (object value);
override this.Add : obj -> int
Public Function Add (value As Object) As Integer

Параметры

value
Object

Объект Object.A Object.

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

Индекс нового объекта OleDbParameter в коллекции.The index of the new OleDbParameter object in the collection.

Дополнительно

Add(String, OleDbType)

Добавляет OleDbParameter с заданным именем параметра и типом данных в коллекцию OleDbParameterCollection.Adds an OleDbParameter to the OleDbParameterCollection, given the parameter name and data type.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Data::OleDb::OleDbType oleDbType);
public System.Data.OleDb.OleDbParameter Add (string parameterName, System.Data.OleDb.OleDbType oleDbType);
override this.Add : string * System.Data.OleDb.OleDbType -> System.Data.OleDb.OleDbParameter

Параметры

parameterName
String

Имя параметра.The name of the parameter.

oleDbType
OleDbType

Одно из значений перечисления OleDbType.One of the OleDbType values.

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

Индекс нового объекта OleDbParameter.The index of the new OleDbParameter object.

Примеры

В следующем примере создается OleDbParameterCollection и добавляется OleDbParameter.The following example creates an OleDbParameterCollection and adds an OleDbParameter.

public void CreateParameters() 
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter myParm = paramCollection.Add(
        "CustomerID", OleDbType.VarChar);
}
Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim myParm As OleDbParameter = paramCollection.Add( _
    "CustomerID", OleDbType.VarChar)
End Sub 

Дополнительно

Add(String, Object)

Предупреждение

Этот API устарел.

Добавляет объект OleDbParameter с заданным именем параметра и значением в OleDbParameterCollection.Adds an OleDbParameter to the OleDbParameterCollection given the parameter name and value.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Object ^ value);
[System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)]
public System.Data.OleDb.OleDbParameter Add (string parameterName, object value);
override this.Add : string * obj -> System.Data.OleDb.OleDbParameter
Public Function Add (parameterName As String, value As Object) As OleDbParameter

Параметры

parameterName
String

Имя параметра.The name of the parameter.

value
Object

Value из OleDbParameter для добавления в коллекцию.The Value of the OleDbParameter to add to the collection.

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

Индекс нового объекта OleDbParameter.The index of the new OleDbParameter object.

Атрибуты

Исключения

Параметр value не является OleDbParameter.The value parameter is not an OleDbParameter.

Комментарии

Будьте внимательны при использовании этой перегрузки метода Add для указания целочисленных значений параметров.Use caution when using this overload of the Add method to specify integer parameter values. Поскольку эта перегрузка принимает value типа Object, необходимо преобразовать значение в тип Object, если значение равно нулю, как показано в следующем C# примере.Because this overload takes a value of type Object, you must convert the value to an Object type when the value is zero, as the following C# example demonstrates.

parameters.Add("@pname", Convert.ToInt32(0));  

Если это преобразование не выполнено, компилятор предполагает, что вы пытаетесь вызвать перегрузку Add.If you do not perform this conversion, the compiler will assume you are attempting to call the Add overload.

Дополнительно

Add(String, OleDbType, Int32)

Добавляет OleDbParameter с заданным именем, типом данных и длиной столбца в OleDbParameterCollection.Adds an OleDbParameter to the OleDbParameterCollection given the parameter name, data type, and column length.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Data::OleDb::OleDbType oleDbType, int size);
public System.Data.OleDb.OleDbParameter Add (string parameterName, System.Data.OleDb.OleDbType oleDbType, int size);
override this.Add : string * System.Data.OleDb.OleDbType * int -> System.Data.OleDb.OleDbParameter

Параметры

parameterName
String

Имя параметра.The name of the parameter.

oleDbType
OleDbType

Одно из значений перечисления OleDbType.One of the OleDbType values.

size
Int32

Длина столбца.The length of the column.

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

Индекс нового объекта OleDbParameter.The index of the new OleDbParameter object.

Примеры

В следующем примере создается OleDbParameterCollection, добавляется экземпляр OleDbParameter в коллекцию и возвращается ссылка на новый OleDbParameter.The following example creates an OleDbParameterCollection, adds an instance of OleDbParameter to the collection, and returns a reference to the new OleDbParameter.

public void CreateParameters(OleDbConnection connection) 
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter parameter = paramCollection.Add(
        "CustomerID", OleDbType.VarChar, 5);
}
Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim parameter As OleDbParameter = paramCollection.Add( _
    "CustomerID", OleDbType.VarChar, 5)
End Sub

Дополнительно

Add(String, OleDbType, Int32, String)

Добавляет объект OleDbParameter с заданным именем параметра, типом данных, длиной столбца и именем столбца источника в OleDbParameterCollection.Adds an OleDbParameter to the OleDbParameterCollection given the parameter name, data type, column length, and source column name.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Data::OleDb::OleDbType oleDbType, int size, System::String ^ sourceColumn);
public System.Data.OleDb.OleDbParameter Add (string parameterName, System.Data.OleDb.OleDbType oleDbType, int size, string sourceColumn);
override this.Add : string * System.Data.OleDb.OleDbType * int * string -> System.Data.OleDb.OleDbParameter

Параметры

parameterName
String

Имя параметра.The name of the parameter.

oleDbType
OleDbType

Одно из значений перечисления OleDbType.One of the OleDbType values.

size
Int32

Длина столбца.The length of the column.

sourceColumn
String

Имя исходного столбца.The name of the source column.

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

Индекс нового объекта OleDbParameter.The index of the new OleDbParameter object.

Примеры

В следующем примере создается OleDbParameterCollection, добавляется экземпляр OleDbParameter в коллекцию и возвращается ссылка на новый OleDbParameter.The following example creates an OleDbParameterCollection, adds an instance of OleDbParameter to the collection, and returns a reference to the new OleDbParameter.

public void CreateParameters(OleDbConnection connection) 
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter parameter = paramCollection.Add(
        "CustomerID", OleDbType.VarChar, 5, "CustomerID");
}
Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim parameter As OleDbParameter = paramCollection.Add( _
    "CustomerID", OleDbType.VarChar, 5, "CustomerID")
End Sub 

Дополнительно

Применяется к