OleDbParameterCollection.Add Methode

Definition

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v8.0.0

Fügt dem OleDbParameter eine OleDbParameterCollection hinzu.

Überlädt

Add(OleDbParameter)	Fügt dem OleDbParameter die angegebene OleDbParameterCollection hinzu.
Add(Object)	Fügt dem OleDbParameter-Objekt das angegebene OleDbParameterCollection-Objekt hinzu.
Add(String, OleDbType)	Fügt der OleDbParameter einen OleDbParameterCollection mit dem angegebenen Parameternamen und Datentyp hinzu.
Add(String, Object)	Veraltet. Fügt der OleDbParameter einen OleDbParameterCollection mit dem angegebenen Parameternamen und -wert hinzu.
Add(String, OleDbType, Int32)	Fügt der OleDbParameter einen OleDbParameterCollection mit dem Parameternamen, dem Datentyp und der Spaltenlänge hinzu.
Add(String, OleDbType, Int32, String)	Fügt der OleDbParameter einen OleDbParameterCollection mit dem Parameternamen, dem Datentyp, der Spaltenlänge und dem Namen der Quellspalte hinzu.

Add(OleDbParameter)

Quelle:

OleDbParameterCollection.cs

Fügt dem OleDbParameter die angegebene OleDbParameterCollection hinzu.

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

Parameter

value

OleDbParameter

Der der Auflistung hinzuzufügende OleDbParameter.

Gibt zurück

OleDbParameter

Der Index des neuen OleDbParameter-Objekts.

Ausnahmen

ArgumentException

Der im value-Parameter angegebene OleDbParameter wurde bereits dieser oder einer anderen OleDbParameterCollection hinzugefügt.

ArgumentNullException

Der value-Parameter ist null.

Beispiele

Im folgenden Beispiel wird ein OleDbParameterCollection erstellt und hinzugefügt 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

Weitere Informationen

• Arbeiten mit Befehlen
• Verwenden von Parametern mit einem DataAdapter

Add(Object)

Quelle:

OleDbParameterCollectionHelper.cs

Fügt dem OleDbParameter-Objekt das angegebene OleDbParameterCollection-Objekt hinzu.

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

Parameter

value

Object

einen Object

Gibt zurück

Int32

Der Index des neuen OleDbParameter-Objekts in der Auflistung.

Weitere Informationen

• Arbeiten mit Befehlen
• Verwenden von Parametern mit einem DataAdapter

Add(String, OleDbType)

Quelle:

OleDbParameterCollection.cs

Fügt der OleDbParameter einen OleDbParameterCollection mit dem angegebenen Parameternamen und Datentyp hinzu.

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

Public Function Add (parameterName As String, oleDbType As OleDbType) As OleDbParameter

Parameter

parameterName

String

Der Name des Parameters.

oleDbType

OleDbType

Einer der OleDbType-Werte.

Gibt zurück

OleDbParameter

Der Index des neuen OleDbParameter-Objekts.

Beispiele

Im folgenden Beispiel wird ein OleDbParameterCollection erstellt und hinzugefügt 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

Weitere Informationen

• Arbeiten mit Befehlen
• Verwenden von Parametern mit einem DataAdapter

Add(String, Object)

Quelle:

OleDbParameterCollection.cs

Achtung

Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value) instead.

Fügt der OleDbParameter einen OleDbParameterCollection mit dem angegebenen Parameternamen und -wert hinzu.

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) instead.")]
public System.Data.OleDb.OleDbParameter Add (string? parameterName, object? value);

[<System.Obsolete("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value) instead.")>]
override this.Add : string * obj -> System.Data.OleDb.OleDbParameter

Public Function Add (parameterName As String, value As Object) As OleDbParameter

Parameter

parameterName

String

Der Name des Parameters.

value

Object

Der Value von OleDbParameter, der der Auflistung hinzugefügt werden soll.

Gibt zurück

OleDbParameter

Der Index des neuen OleDbParameter-Objekts.

Attribute

ObsoleteAttribute

Ausnahmen

InvalidCastException

Der value-Parameter ist kein OleDbParameter.

Hinweise

Gehen Sie vorsichtig vor, wenn Sie diese Überladung der Add Methode verwenden, um ganzzahlige Parameterwerte anzugeben. Da diese Überladung einen value vom Typ Objectbenötigt, müssen Sie den Wert in einen Object Typ konvertieren, wenn der Wert 0 ist, wie im folgenden C#-Beispiel veranschaulicht.

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

Wenn Sie diese Konvertierung nicht durchführen, geht der Compiler davon aus, dass Sie versuchen, die Add Überladung aufzurufen.

Weitere Informationen

• Arbeiten mit Befehlen
• Verwenden von Parametern mit einem DataAdapter

Add(String, OleDbType, Int32)

Quelle:

OleDbParameterCollection.cs

Fügt der OleDbParameter einen OleDbParameterCollection mit dem Parameternamen, dem Datentyp und der Spaltenlänge hinzu.

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

Public Function Add (parameterName As String, oleDbType As OleDbType, size As Integer) As OleDbParameter

Parameter

parameterName

String

Der Name des Parameters.

oleDbType

OleDbType

Einer der OleDbType-Werte.

size

Int32

Die Länge der Spalte.

Gibt zurück

OleDbParameter

Der Index des neuen OleDbParameter-Objekts.

Beispiele

Im folgenden Beispiel wird ein OleDbParameterCollectionerstellt, fügt der Auflistung eine instance von OleDbParameter hinzu und gibt einen Verweis auf die neue OleDbParameterzurück.

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

Weitere Informationen

• Arbeiten mit Befehlen
• Verwenden von Parametern mit einem DataAdapter

Add(String, OleDbType, Int32, String)

Quelle:

OleDbParameterCollection.cs

Fügt der OleDbParameter einen OleDbParameterCollection mit dem Parameternamen, dem Datentyp, der Spaltenlänge und dem Namen der Quellspalte hinzu.

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

Public Function Add (parameterName As String, oleDbType As OleDbType, size As Integer, sourceColumn As String) As OleDbParameter

Parameter

parameterName

String

Der Name des Parameters.

oleDbType

OleDbType

Einer der OleDbType-Werte.

size

Int32

Die Länge der Spalte.

sourceColumn

String

Der Name der Quellspalte

Gibt zurück

OleDbParameter

Der Index des neuen OleDbParameter-Objekts.

Beispiele

Im folgenden Beispiel wird ein OleDbParameterCollectionerstellt, fügt der Auflistung eine instance von OleDbParameter hinzu und gibt einen Verweis auf die neue OleDbParameterzurück.

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

Weitere Informationen

• Arbeiten mit Befehlen
• Verwenden von Parametern mit einem DataAdapter