FormParameter Construtores
Definição
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
| FormParameter() |
Inicializa uma nova instância não nomeada da classe FormParameter. |
| FormParameter(FormParameter) |
Inicializa uma nova instância da classe FormParameter com os valores da instância especificada pelo parâmetro |
| FormParameter(String, String) |
Inicializa uma nova instância nomeada da classe FormParameter, usando a cadeia de caracteres especificada para identificar a qual campo de variável de formulário associar. |
| FormParameter(String, DbType, String) |
Inicializa uma nova instância da classe FormParameter, usando a cadeia de caracteres especificada para identificar a qual campo de variável de formulário associar. |
| FormParameter(String, TypeCode, String) |
Inicializa uma nova instância nomeada e fortemente tipada da classe FormParameter usando a cadeia de caracteres especificada para identificar a qual variável de formulário associar. |
FormParameter()
Inicializa uma nova instância não nomeada da classe FormParameter.
public:
FormParameter();public FormParameter ();Public Sub New ()Exemplos
Importante
O FormParameter não valida o valor passado pelo elemento form de forma de forma alguma; ele usa o valor bruto. Na maioria dos casos, você pode validar o valor do antes de FormParameter ser usado por um controle de fonte de dados manipulando um evento, como o Selecting, Updating, Insertingou Deleting 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 é inicializado como String.Empty. Além disso, a Name propriedade é inicializada como String.Empty, a Type propriedade é inicializada como TypeCode.Object, a Direction propriedade é inicializada como Inpute a DefaultValue propriedade é inicializada como nula (Nothing no Visual Basic).
Confira também
Aplica-se a
FormParameter(FormParameter)
Inicializa uma nova instância da classe FormParameter com os valores da instância especificada pelo parâmetro original.
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.FormParameterProtected Sub New (original As FormParameter)Parâmetros
- original
- FormParameter
Uma instância FormParameter 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 de FormParameter, incluindo FormField, Namee Type são todos transferidos para a nova instância.
Confira também
Aplica-se a
FormParameter(String, String)
Inicializa uma nova instância nomeada da classe FormParameter, usando a cadeia de caracteres especificada para identificar a qual campo de variável de formulário associar.
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.FormParameterPublic 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 ao qual o objeto de parâmetro está associado. O padrão é Empty.
Exemplos
Importante
O FormParameter não valida o valor passado pelo elemento form de forma de forma alguma; ele usa o valor bruto. Na maioria dos casos, você pode validar o valor do antes de FormParameter ser usado por um controle de fonte de dados manipulando um evento, como o Selecting, Updating, Insertingou Deleting 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("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 identificam a variável de formulário à qual o parâmetro se associa. As Type propriedades e Direction são inicializadas com valores padrão.
Confira também
Aplica-se a
FormParameter(String, DbType, String)
Inicializa uma nova instância da classe FormParameter, usando a cadeia de caracteres especificada para identificar a qual campo de variável de formulário associar.
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.FormParameterPublic 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 ao 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 FormParameter usando a cadeia de caracteres especificada para identificar a qual variável de formulário 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.FormParameterPublic Sub New (name As String, type As TypeCode, formField As String)Parâmetros
- name
- String
O nome do parâmetro.
- formField
- String
O nome da variável de formulário ao qual o objeto de parâmetro está associado. O padrão é Empty.
Exemplos
Importante
O FormParameter não valida o valor passado pelo elemento form de forma de forma alguma; ele usa o valor bruto. Na maioria dos casos, você pode validar o valor do antes de FormParameter ser usado por um controle de fonte de dados manipulando um evento, como o Selecting, Updating, Insertingou Deleting 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("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 do parâmetro especificado, Typee cadeia de caracteres que identifica a variável de formulário à qual o parâmetro se associa. Somente as Direction propriedades e ConvertEmptyStringToNull são inicializadas com valores padrão.
