SqlCommand.CommandType Propriedade

  • Referência

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacote:
System.Data.SqlClient v4.8.6

Obtém ou define um valor que indica como a propriedade CommandText deve ser interpretada.

public:
 virtual property System::Data::CommandType CommandType { System::Data::CommandType get(); void set(System::Data::CommandType value); };
public:
 property System::Data::CommandType CommandType { System::Data::CommandType get(); void set(System::Data::CommandType value); };
public override System.Data.CommandType CommandType { get; set; }
[System.Data.DataSysDescription("DbCommand_CommandType")]
public System.Data.CommandType CommandType { get; set; }
member this.CommandType : System.Data.CommandType with get, set
[<System.Data.DataSysDescription("DbCommand_CommandType")>]
member this.CommandType : System.Data.CommandType with get, set
Public Overrides Property CommandType As CommandType
Public Property CommandType As CommandType

Valor da propriedade

CommandType

Um dos valores de CommandType. O padrão é Text.

Implementações

CommandType
Atributos
DataSysDescriptionAttribute

Exceções

ArgumentException

O valor não era um CommandType válido.

Exemplos

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

public void CreateSqlCommand()
{
   SqlCommand command = new SqlCommand();
   command.CommandTimeout = 15;
   command.CommandType = CommandType.Text;
}

Public Sub CreateSqlCommand()
    Dim command As New SqlCommand()
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

Comentários

Ao definir a CommandType propriedade como StoredProcedure, você deve definir a CommandText propriedade como o nome do procedimento armazenado. O comando executa esse procedimento armazenado quando você chama um dos métodos Execute.

O Provedor de Dados do Microsoft .NET Framework para SQL Server não dá suporte ao espaço reservado de ponto de interrogação (?) para passar parâmetros para uma Instrução SQL ou um procedimento armazenado chamado com um CommandType de Text. Nesse caso, os parâmetros nomeados devem ser usados. Por exemplo:

SELECT * FROM Customers WHERE CustomerID = @CustomerID

Para obter mais informações, consulte Configurando parâmetros e tipos de dados de parâmetro.

Aplica-se a

Confira também