FormParameter Construtores

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.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 FormParameter.

Sobrecargas

Nome	Description
FormParameter()	Inicializa uma nova instância sem nome da FormParameter classe.
FormParameter(FormParameter)	Inicializa uma nova instância da FormParameter classe com os valores da instância especificados pelo `original` parâmetro.
FormParameter(String, String)	Inicializa uma nova instância nomeada da FormParameter classe, usando a cadeia de caracteres especificada para identificar a qual campo de variável de formulário será associado.
FormParameter(String, DbType, String)	Inicializa uma nova instância da FormParameter classe, usando a cadeia de caracteres especificada para identificar a qual campo de variável de formulário será associado.
FormParameter(String, TypeCode, String)	Inicializa uma nova instância nomeada e fortemente tipada da classe, usando a FormParameter cadeia de caracteres especificada para identificar a qual variável de formulário se associar.

FormParameter()

Inicializa uma nova instância sem nome da FormParameter classe.

public:
 FormParameter();

public FormParameter();

Public Sub New ()

Exemplos

Importante

O FormParameter valor passado pelo elemento de formulário não é validado; ele usa o valor bruto. Na maioria dos casos, você pode validar o valor de antes que FormParameter ele seja usado por um controle de fonte de dados manipulando um evento, como o Selecting, Updatingou InsertingDeleting evento exposto pelo controle da fonte de dados que você está usando. Se o valor do parâmetro não passar nos testes de validação, você poderá cancelar a operação de dados definindo a Cancel propriedade da classe associada CancelEventArgs como true.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter();
  formParam.Name="lastname";
  formParam.Type=TypeCode.String;
  formParam.FormField="LastNameBox";
  AccessDataSource1.SelectParameters.Add(formParam);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1" />

    </form>
  </body>
</html>

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

Private Sub Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.
  Dim formParam As New FormParameter()
  formParam.Name="lastname"
  formParam.Type=TypeCode.String
  formParam.FormField="LastNameBox"
  AccessDataSource1.SelectParameters.Add(formParam)

End Sub ' Page_Load

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1" />

    </form>
  </body>
</html>

Comentários

Um FormParameter objeto criado com o FormParameter construtor é inicializado com valores padrão para todas as suas propriedades. O FormField valor é inicializado para String.Empty. Além disso, a Name propriedade é inicializada para String.Empty, a Type propriedade é inicializada para TypeCode.Object, a Direction propriedade é inicializada Inputpara , e a DefaultValue propriedade é inicializada como nulo (Nothing no Visual Basic).

Confira também

Usando parâmetros com controles de fonte de dados

Aplica-se a

FormParameter(FormParameter)

Inicializa uma nova instância da FormParameter classe com os valores da instância especificados pelo original parâmetro.

protected:
 FormParameter(System::Web::UI::WebControls::FormParameter ^ original);

protected FormParameter(System.Web.UI.WebControls.FormParameter original);

new System.Web.UI.WebControls.FormParameter : System.Web.UI.WebControls.FormParameter -> System.Web.UI.WebControls.FormParameter

Protected Sub New (original As FormParameter)

Parâmetros

original: FormParameter

Uma FormParameter instância da qual a instância atual é inicializada.

Comentários

O FormParameter construtor é um protected construtor de cópia usado para clonar uma FormParameter instância. Os valores do FormParameter, incluindo FormField, Namee Type todos são transferidos para a nova instância.

Confira também

Aplica-se a

FormParameter(String, String)

Inicializa uma nova instância nomeada da FormParameter classe, usando a cadeia de caracteres especificada para identificar a qual campo de variável de formulário será associado.

public:
 FormParameter(System::String ^ name, System::String ^ formField);

public FormParameter(string name, string formField);

new System.Web.UI.WebControls.FormParameter : string * string -> System.Web.UI.WebControls.FormParameter

Public Sub New (name As String, formField As String)

Parâmetros

name: String

O nome do parâmetro.

formField: String

O nome da variável de formulário à qual o objeto de parâmetro está associado. O padrão é Empty.

Exemplos

Importante

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname","LastNameBox");
  formParam.Type=TypeCode.String;
  AccessDataSource1.SelectParameters.Add(formParam);
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </form>
  </body>
</html>

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

Private Sub Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname","LastNameBox")
  formParam.Type=TypeCode.String
  AccessDataSource1.SelectParameters.Add(formParam)
End Sub ' Page_Load

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </form>
  </body>
</html>

Comentários

Um FormParameter objeto criado com o FormParameter construtor é inicializado com o nome do parâmetro e a cadeia de caracteres especificados que identifica a variável de formulário à qual o parâmetro se associa. As Type propriedades e as Direction propriedades são inicializadas com valores padrão.

Confira também

Aplica-se a

FormParameter(String, DbType, String)

Inicializa uma nova instância da FormParameter classe, usando a cadeia de caracteres especificada para identificar a qual campo de variável de formulário será associado.

public:
 FormParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ formField);

public FormParameter(string name, System.Data.DbType dbType, string formField);

new System.Web.UI.WebControls.FormParameter : string * System.Data.DbType * string -> System.Web.UI.WebControls.FormParameter

Public Sub New (name As String, dbType As DbType, formField As String)

Parâmetros

name: String

O nome do parâmetro.

dbType: DbType

O tipo de banco de dados do parâmetro.

formField: String

O nome da variável de formulário à qual o objeto de parâmetro está associado.

Aplica-se a

FormParameter(String, TypeCode, String)

Inicializa uma nova instância nomeada e fortemente tipada da classe, usando a FormParameter cadeia de caracteres especificada para identificar a qual variável de formulário se associar.

public:
 FormParameter(System::String ^ name, TypeCode type, System::String ^ formField);

public FormParameter(string name, TypeCode type, string formField);

new System.Web.UI.WebControls.FormParameter : string * TypeCode * string -> System.Web.UI.WebControls.FormParameter

Public Sub New (name As String, type As TypeCode, formField As String)

Parâmetros

name: String

O nome do parâmetro.

type: TypeCode

O tipo que o parâmetro representa. O padrão é Object.

formField: String

O nome da variável de formulário à qual o objeto de parâmetro está associado. O padrão é Empty.

Exemplos

Importante

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname", TypeCode.String, "LastNameBox");
  AccessDataSource1.SelectParameters.Add(formParam);
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                          (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </form>
  </body>
</html>

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

Private Sub Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname",TypeCode.String,"LastNameBox")
  AccessDataSource1.SelectParameters.Add(formParam)

End Sub ' Page_Load

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                           (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </form>
  </body>
</html>

Comentários

Um FormParameter objeto criado com o FormParameter construtor é inicializado com o nome Typedo parâmetro especificado e uma cadeia de caracteres que identifica a variável de formulário à qual o parâmetro se associa. Somente as propriedades e ConvertEmptyStringToNull as Direction propriedades são inicializadas com valores padrão.

Confira também

Aplica-se a

Comentários

Esta página foi útil?

Compartilhar via

FormParameter Construtores

Definição

Sobrecargas

FormParameter()

Exemplos

Comentários

Confira também

Aplica-se a

FormParameter(FormParameter)

Parâmetros

Comentários

Confira também

Aplica-se a

FormParameter(String, String)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

FormParameter(String, DbType, String)

Parâmetros

Aplica-se a

FormParameter(String, TypeCode, String)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

Comentários