OleDbParameterCollection.Item[] Propriedade

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0-preview.6.24327.7

Obtém ou define o OleDbParameter com um atributo especificado.

Sobrecargas

Item[String]	Obtém ou define o OleDbParameter com o nome especificado.
Item[Int32]	Obtém ou define o OleDbParameter no índice especificado.

Item[String]

Origem:

OleDbParameterCollection.cs

Obtém ou define o OleDbParameter com o nome especificado.

public:
 property System::Data::OleDb::OleDbParameter ^ default[System::String ^] { System::Data::OleDb::OleDbParameter ^ get(System::String ^ parameterName); void set(System::String ^ parameterName, System::Data::OleDb::OleDbParameter ^ value); };

[System.ComponentModel.Browsable(false)]
public System.Data.OleDb.OleDbParameter this[string parameterName] { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Item(string) : System.Data.OleDb.OleDbParameter with get, set

Default Public Property Item(parameterName As String) As OleDbParameter

Parâmetros

parameterName

String

O nome do parâmetro a ser recuperado.

Valor da propriedade

OleDbParameter

O OleDbParameter com o nome especificado.

Atributos

BrowsableAttribute

Exceções

IndexOutOfRangeException

O nome especificado não existe.

Exemplos

O exemplo a seguir pesquisa um OleDbParameter com um determinado ParameterName em um OleDbParameterCollection. Se o parâmetro existir, o exemplo exibirá o nome e o índice do parâmetro. Se o parâmetro não existir, o exemplo exibirá um erro. Este exemplo pressupõe que um OleDbParameterCollection já foi criado.

public void SearchParameters()
{
    // ...
    // create OleDbParameterCollection parameters
    // ...
    if (!parameters.Contains("Description"))
        Console.WriteLine("ERROR: no such parameter in the collection");
    else
        Console.WriteLine("Name: " + parameters["Description"].ToString() +
            "Index: " + parameters.IndexOf("Description").ToString());
}

Public Sub SearchParameters()
    ' ...
    ' create OleDbParameterCollection parameters
    ' ...
    If Not parameters.Contains("Description") Then
        Console.WriteLine("ERROR: no such parameter in the collection")
    Else
        Console.WriteLine("Name: " & parameters("Description").ToString() & _
            "Index: " & parameters.IndexOf("Description").ToString())
    End If
End Sub

Confira também

• Trabalhando com comandos
• Usando parâmetros com um DataAdapter

Item[Int32]

Origem:

OleDbParameterCollection.cs

Obtém ou define o OleDbParameter no índice especificado.

public:
 property System::Data::OleDb::OleDbParameter ^ default[int] { System::Data::OleDb::OleDbParameter ^ get(int index); void set(int index, System::Data::OleDb::OleDbParameter ^ value); };

[System.ComponentModel.Browsable(false)]
public System.Data.OleDb.OleDbParameter this[int index] { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Item(int) : System.Data.OleDb.OleDbParameter with get, set

Default Public Property Item(index As Integer) As OleDbParameter

Parâmetros

index

Int32

O índice baseado em zero do parâmetro a ser recuperado.

Valor da propriedade

OleDbParameter

O OleDbParameter no índice especificado.

Atributos

BrowsableAttribute

Exceções

IndexOutOfRangeException

O índice especificado não existe.

Exemplos

O exemplo a seguir cria um OleDbParameterCollection, adiciona instâncias de OleDbParameter à coleção, exibe os nomes de seus OleDbParameter objetos e limpa a coleção.

public void CreateParamCollection(OleDbCommand command)
{
    OleDbParameterCollection paramCollection = command.Parameters;
    paramCollection.Add("@CategoryName", OleDbType.Char);
    paramCollection.Add("@Description", OleDbType.Char);
    paramCollection.Add("@Picture", OleDbType.Binary);
    string parameterNames = "";
    for (int i=0; i < paramCollection.Count; i++)
        parameterNames += paramCollection[i].ToString() + "\n";
    Console.WriteLine(parameterNames);
    paramCollection.Clear();
}

Public Sub CreateParamCollection(command As OleDbCommand)
    Dim paramCollection As OleDbParameterCollection = _
        command.Parameters
    paramCollection.Add("@CategoryName", OleDbType.Char)
    paramCollection.Add("@Description", OleDbType.Char)
    paramCollection.Add("@Picture", OleDbType.Binary)
    Dim parameterNames As String = ""
    For i As Integer = 0 To paramCollection.Count - 1
        parameterNames += paramCollection(i).ToString() & _
            ControlChars.Cr
    Next
    Console.WriteLine(parameterNames)
    paramCollection.Clear()
End Sub

Confira também

• Trabalhando com comandos
• Usando parâmetros com um DataAdapter