OleDbParameter Construtores

Definição

Namespace:: System.Data.OleDb

Assembly:: System.Data.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da classe OleDbParameter.

Sobrecargas

Nome	Description
OleDbParameter()	Inicializa uma nova instância da classe OleDbParameter.
OleDbParameter(String, OleDbType)	Inicializa uma nova instância da OleDbParameter classe que usa o nome do parâmetro e o tipo de dados.
OleDbParameter(String, Object)	Inicializa uma nova instância da OleDbParameter classe que usa o nome do parâmetro e o valor do novo OleDbParameter.
OleDbParameter(String, OleDbType, Int32)	Inicializa uma nova instância da OleDbParameter classe que usa o nome do parâmetro, o tipo de dados e o comprimento.
OleDbParameter(String, OleDbType, Int32, String)	Inicializa uma nova instância da classe que usa o nome do parâmetro, o tipo de dados, o comprimento e o nome da OleDbParameter coluna de origem.
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inicializa uma nova instância da classe que usa o nome do parâmetro, o tipo de dados, o comprimento, o nome da coluna de origem, a direção do parâmetro, a OleDbParameter precisão numérica e outras propriedades.
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)	Inicializa uma nova instância da classe que usa o nome do parâmetro, o tipo de dados, o comprimento, o nome da coluna de origem, a direção do parâmetro, a OleDbParameter precisão numérica e outras propriedades.

OleDbParameter()

Inicializa uma nova instância da classe OleDbParameter.

public:
 OleDbParameter();

public OleDbParameter();

Public Sub New ()

Exemplos

O exemplo a seguir cria um OleDbParameter e define algumas de suas propriedades.

public void CreateOleDbParameter()
{
   OleDbParameter parameter = new OleDbParameter();
   parameter.ParameterName = "Description";
   parameter.OleDbType = OleDbType.VarChar;
   parameter.Direction = ParameterDirection.Output;
   parameter.Size = 88;
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter()
    parameter.ParameterName = "Description"
    parameter.OleDbType = OleDbType.VarChar
    parameter.Direction = ParameterDirection.Output
    parameter.Size = 88
End Sub

Confira também

Trabalhando com comandos

Aplica-se a

OleDbParameter(String, OleDbType)

Inicializa uma nova instância da OleDbParameter classe que usa o nome do parâmetro e o tipo de dados.

public:
 OleDbParameter(System::String ^ name, System::Data::OleDb::OleDbType dataType);

public OleDbParameter(string name, System.Data.OleDb.OleDbType dataType);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType -> System.Data.OleDb.OleDbParameter

Public Sub New (name As String, dataType As OleDbType)

Parâmetros

name: String

O nome do parâmetro a ser mapeado.

dataType: OleDbType

Um dos OleDbType valores.

Exceções

ArgumentException

O valor fornecido no dataType parâmetro é um tipo de dados de back-end inválido.

Exemplos

O exemplo a seguir cria um OleDbParameter e define algumas de suas propriedades.


public void CreateOleDbParameter()
{
   OleDbParameter parameter = new OleDbParameter("Description",OleDbType.VarChar);
   parameter.Direction = ParameterDirection.Output;
   parameter.Size = 88;
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)
    parameter.Direction = ParameterDirection.Output
    parameter.Size = 88
End Sub

Comentários

O tipo de dados e, se apropriado, Size e Precision são inferidos do valor do dataType parâmetro.

Confira também

Trabalhando com comandos

Aplica-se a

OleDbParameter(String, Object)

Inicializa uma nova instância da OleDbParameter classe que usa o nome do parâmetro e o valor do novo OleDbParameter.

public:
 OleDbParameter(System::String ^ name, System::Object ^ value);

public OleDbParameter(string name, object value);

new System.Data.OleDb.OleDbParameter : string * obj -> System.Data.OleDb.OleDbParameter

Public Sub New (name As String, value As Object)

Parâmetros

name: String

O nome do parâmetro a ser mapeado.

value: Object

O valor do novo OleDbParameter objeto.

Exemplos

O exemplo a seguir cria um OleDbParameter.


public static void CreateOleDbParameter()
{
   OleDbParameter myParameter = new OleDbParameter("Description", "Beverages");
}


Public Shared Sub CreateOleDbParameter() 
   Dim myParameter As New OleDbParameter("Description", "Beverages")
End Sub

Comentários

Tenha cuidado ao usar essa sobrecarga do OleDbParameter construtor para especificar valores de parâmetro inteiros. Como essa sobrecarga usa um value tipo Object, você deve converter o valor integral em um Object tipo quando o valor for zero, como demonstra o exemplo de C# a seguir.

Parameter = new OleDbParameter("@pname", Convert.ToInt32(0));

Se você não executar essa conversão, o compilador assumirá que você está tentando chamar a sobrecarga do OleDbParameter construtor.

Confira também

Trabalhando com comandos

Aplica-se a

OleDbParameter(String, OleDbType, Int32)

Inicializa uma nova instância da OleDbParameter classe que usa o nome do parâmetro, o tipo de dados e o comprimento.

public:
 OleDbParameter(System::String ^ name, System::Data::OleDb::OleDbType dataType, int size);

public OleDbParameter(string name, System.Data.OleDb.OleDbType dataType, int size);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType * int -> System.Data.OleDb.OleDbParameter

Public Sub New (name As String, dataType As OleDbType, size As Integer)

Parâmetros

name: String

O nome do parâmetro a ser mapeado.

dataType: OleDbType

Um dos OleDbType valores.

size: Int32

O comprimento do parâmetro.

Exceções

ArgumentException

O valor fornecido no dataType parâmetro é um tipo de dados de back-end inválido.

Exemplos

O exemplo a seguir cria um OleDbParameter e define algumas de suas propriedades.


public void CreateOleDbParameter()
{
   OleDbParameter parameter = new OleDbParameter("Description",OleDbType.VarChar,88);
   parameter.Direction = ParameterDirection.Output;
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar, 88)
    parameter.Direction = ParameterDirection.Output
End Sub

Comentários

O Size valor do dataType parâmetro será inferido se ele não estiver explicitamente definido no size parâmetro.

Confira também

Trabalhando com comandos

Aplica-se a

OleDbParameter(String, OleDbType, Int32, String)

Inicializa uma nova instância da classe que usa o nome do parâmetro, o tipo de dados, o comprimento e o nome da OleDbParameter coluna de origem.

public:
 OleDbParameter(System::String ^ name, System::Data::OleDb::OleDbType dataType, int size, System::String ^ srcColumn);

public OleDbParameter(string name, System.Data.OleDb.OleDbType dataType, int size, string srcColumn);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType * int * string -> System.Data.OleDb.OleDbParameter

Public Sub New (name As String, dataType As OleDbType, size As Integer, srcColumn As String)

Parâmetros

name: String

O nome do parâmetro a ser mapeado.

dataType: OleDbType

Um dos OleDbType valores.

size: Int32

O comprimento do parâmetro.

srcColumn: String

O nome da coluna de origem.

Exceções

ArgumentException

O valor fornecido no dataType parâmetro é um tipo de dados de back-end inválido.

Exemplos

O exemplo a seguir cria um OleDbParameter e define algumas de suas propriedades.


public void CreateOleDbParameter()
{
   OleDbParameter parameter = new OleDbParameter(
       "Description",OleDbType.VarChar,
       88,"Description");
   parameter.Direction = ParameterDirection.Output;
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter( _
        "Description", OleDbType.VarChar, 88, "Description")
    parameter.Direction = ParameterDirection.Output
End Sub

Comentários

O Size valor do dataType parâmetro será inferido se ele não estiver explicitamente definido no size parâmetro.

Confira também

Trabalhando com comandos

Aplica-se a

OleDbParameter(String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Inicializa uma nova instância da classe que usa o nome do parâmetro, o tipo de dados, o comprimento, o nome da coluna de origem, a direção do parâmetro, a OleDbParameter precisão numérica e outras propriedades.

public:
 OleDbParameter(System::String ^ parameterName, System::Data::OleDb::OleDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ srcColumn, System::Data::DataRowVersion srcVersion, System::Object ^ value);

public OleDbParameter(string parameterName, System.Data.OleDb.OleDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string srcColumn, System.Data.DataRowVersion srcVersion, object value);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.Data.OleDb.OleDbParameter

Public Sub New (parameterName As String, dbType As OleDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, srcColumn As String, srcVersion As DataRowVersion, value As Object)

Parâmetros

parameterName: String

O nome do parâmetro.

dbType: OleDbType

Um dos OleDbType valores.

size: Int32

O comprimento do parâmetro.

direction: ParameterDirection

Um dos ParameterDirection valores.

isNullable: Boolean

true se o valor do campo puder ser nulo; caso contrário false.

precision: Byte

O número total de dígitos à esquerda e à direita do ponto decimal ao qual Value é resolvido.

scale: Byte

O número total de casas decimais para as quais Value é resolvido.

srcColumn: String

O nome da coluna de origem.

srcVersion: DataRowVersion

Um dos DataRowVersion valores.

value: Object

Um Object valor que é o valor do OleDbParameter.

Exceções

ArgumentException

O valor fornecido no dbType parâmetro é um tipo de dados de back-end inválido.

Exemplos

O exemplo a seguir cria um OleDbParameter e exibe o ParameterName.

public void CreateOleDbParameter()
{
    OleDbParameter parameter = new OleDbParameter(
        "Description", OleDbType.VarChar, 11,
        ParameterDirection.Output, true, 0, 0, "Description",
        DataRowVersion.Current, "garden hose");
    Console.WriteLine(parameter.ToString());
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter( _
        "Description", OleDbType.VarChar, 11, _
        ParameterDirection.Output, True, 0, 0, _
        "Description", DataRowVersion.Current, "garden hose")
    Console.WriteLine(parameter.ToString())
End Sub

Comentários

E Size serão inferidos do valor do dataType parâmetro se eles não estiverem explicitamente definidos nos size parâmetros eprecision.Precision

Confira também

Trabalhando com comandos

Aplica-se a

OleDbParameter(String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)

public:
 OleDbParameter(System::String ^ parameterName, System::Data::OleDb::OleDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value);

public OleDbParameter(string parameterName, System.Data.OleDb.OleDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj -> System.Data.OleDb.OleDbParameter

Public Sub New (parameterName As String, dbType As OleDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object)

Parâmetros

parameterName: String

O nome do parâmetro.

dbType: OleDbType

Um dos OleDbType valores.

size: Int32

O comprimento do parâmetro.

direction: ParameterDirection

Um dos ParameterDirection valores.

precision: Byte

O número total de dígitos à esquerda e à direita do ponto decimal ao qual Value é resolvido.

scale: Byte

O número total de casas decimais para as quais Value é resolvido.

sourceColumn: String

O nome da coluna de origem.

sourceVersion: DataRowVersion

Um dos DataRowVersion valores.

sourceColumnNullMapping: Boolean

true se a coluna de origem for anulável; false se não for.

value: Object

Um Object valor que é o valor do OleDbParameter.

Exceções

ArgumentException

O valor fornecido no dbType parâmetro é um tipo de dados de back-end inválido.

Exemplos

O exemplo a seguir cria um OleDbParameter e exibe o ParameterName.

public void CreateOleDbParameter()
{
    OleDbParameter parameter = new OleDbParameter(
        "Description", OleDbType.VarChar, 11,
        ParameterDirection.Output, true, 0, 0, "Description",
        DataRowVersion.Current, "garden hose");
    Console.WriteLine(parameter.ToString());
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter( _
        "Description", OleDbType.VarChar, 11, _
        ParameterDirection.Output, True, 0, 0, _
        "Description", DataRowVersion.Current, "garden hose")
    Console.WriteLine(parameter.ToString())
End Sub

Comentários

E Size serão inferidos do valor do dataType parâmetro se eles não estiverem explicitamente definidos nos size parâmetros eprecision.Precision

Confira também

Trabalhando com comandos

Aplica-se a

Comentários

Esta página foi útil?