OleDbParameterCollection.Add OleDbParameterCollection.Add OleDbParameterCollection.Add OleDbParameterCollection.Add Method

Определение

Перегрузки

Add(OleDbParameter) Add(OleDbParameter) Add(OleDbParameter) Add(OleDbParameter)

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

Add(Object) Add(Object) Add(Object) Add(Object)

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

Add(String, OleDbType) Add(String, OleDbType) Add(String, OleDbType)

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

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

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

Add(String, OleDbType, Int32) Add(String, OleDbType, Int32) 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) Add(String, OleDbType, Int32, String) 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) Add(OleDbParameter) Add(OleDbParameter) 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 OleDbParameter 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 OleDbCommand = 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) Add(Object) Add(Object) Add(Object)

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

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

Параметры

value
Object Object Object Object

Объект Object.A Object.

Возвраты

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

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

Add(String, OleDbType) Add(String, OleDbType) 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 String String String

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

oleDbType
OleDbType OleDbType 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 OleDbCommand = 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) Add(String, Object) Add(String, Object) 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 String String String

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

value
Object Object Object 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) Add(String, OleDbType, Int32) 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 String String String

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

oleDbType
OleDbType OleDbType OleDbType OleDbType

Одно из значений OleDbType.One of the OleDbType values.

size
Int32 Int32 Int32 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 OleDbCommand = 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) Add(String, OleDbType, Int32, String) 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 String String String

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

oleDbType
OleDbType OleDbType OleDbType OleDbType

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

size
Int32 Int32 Int32 Int32

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

sourceColumn
String String String 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 OleDbCommand = 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 
Дополнительно

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