FormParameter Clase

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Enlaza el valor de un campo de solicitud Form HTTP a un objeto de parámetro.

public ref class FormParameter : System::Web::UI::WebControls::Parameter

public class FormParameter : System.Web.UI.WebControls.Parameter

type FormParameter = class
    inherit Parameter

Public Class FormParameter
Inherits Parameter

Herencia: Object

Parameter
FormParameter

Ejemplos

En el ejemplo de código siguiente se muestra cómo insertar datos en una base de datos mediante el SqlDataSource control y una página web de ASP.NET simple. Los datos actuales de la tabla de datos se muestran en el DropDownList control . Puede agregar nuevos registros escribiendo valores en los TextBox controles y haciendo clic en el botón . Cuando se hace clic en el botón, los valores especificados se insertan en la base de datos y DropDownList se actualiza.

Importante

Este ejemplo tiene un cuadro de texto que acepta la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET páginas web validan que la entrada del usuario no incluye elementos HTML ni de script. Para obtener más información, consulte Información general sobre vulnerabilidades de seguridad de script.

<%@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">
private void InsertShipper (object source, EventArgs e) {
  SqlDataSource1.Insert();
}
</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:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

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

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

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

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

    </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 InsertShipper (ByVal Source As Object, ByVal e As EventArgs)
  SqlDataSource1.Insert()
End Sub ' InsertShipper
</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:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

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

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

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

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

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

Comentarios

Puede usar la FormParameter clase para enlazar el valor de una variable de formulario de la Form colección a un parámetro usado en una consulta o comando con parámetros. Los controles que enlazan datos al parámetro pueden producir una excepción si se especifica , FormParameter pero no se pasa ninguna variable de formulario correspondiente. También pueden mostrar ningún dato si la variable de formulario se pasa sin ningún valor correspondiente. Establezca para DefaultValue evitar estas situaciones cuando proceda.

La FormParameter clase proporciona la FormField propiedad , que identifica el nombre de la variable de formulario a la que se va a enlazar, además de los heredados de la Parameter clase .

Importante

no FormParameter valida el valor pasado por el elemento de formulario de ninguna manera; usa el valor sin procesar. En la mayoría de los casos, puede validar el valor de antes de FormParameter que lo use un control de origen de datos controlando un evento, como el Selectingevento , Updating, Insertingo Deleting expuesto por el control de origen de datos que está usando. Si el valor del parámetro no supera las pruebas de validación, puede cancelar la operación de datos estableciendo la Cancel propiedad de la clase asociada CancelEventArgs en true.

Constructores

Nombre	Description
FormParameter()	Inicializa una nueva instancia sin nombre de la FormParameter clase .
FormParameter(FormParameter)	Inicializa una nueva instancia de la FormParameter clase con los valores de la instancia especificada por el `original` parámetro .
FormParameter(String, DbType, String)	Inicializa una nueva instancia de la FormParameter clase utilizando la cadena especificada para identificar a qué campo de variable de formulario se va a enlazar.
FormParameter(String, String)	Inicializa una nueva instancia con nombre de la FormParameter clase utilizando la cadena especificada para identificar a qué campo de variable de formulario se va a enlazar.
FormParameter(String, TypeCode, String)	Inicializa una nueva instancia con nombre y fuertemente tipada de la FormParameter clase utilizando la cadena especificada para identificar a qué variable de formulario se va a enlazar.

Propiedades

Nombre	Description
ConvertEmptyStringToNull	Obtiene o establece un valor que indica si el valor al que está enlazado el Parameter objeto se debe convertir `null` en si es Empty. (Heredado de Parameter)
DbType	Obtiene o establece el tipo de base de datos del parámetro . (Heredado de Parameter)
DefaultValue	Especifica un valor predeterminado para el parámetro , si el valor del parámetro está enlazado a no inicializarse cuando se llama al Evaluate(HttpContext, Control) método . (Heredado de Parameter)
Direction	Indica si el Parameter objeto se usa para enlazar un valor a un control o el control se puede usar para cambiar el valor. (Heredado de Parameter)
FormField	Obtiene o establece el nombre de la variable de formulario a la que se enlaza el parámetro.
IsTrackingViewState	Obtiene un valor que indica si el Parameter objeto guarda los cambios en su estado de vista. (Heredado de Parameter)
Name	Obtiene o establece el nombre del parámetro . (Heredado de Parameter)
Size	Obtiene o establece el tamaño del parámetro . (Heredado de Parameter)
Type	Obtiene o establece el tipo del parámetro . (Heredado de Parameter)
ValidateInput	Obtiene o establece un valor que indica si se valida la entrada del cliente en el parámetro .
ViewState	Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un Parameter objeto en varias solicitudes para la misma página. (Heredado de Parameter)

Métodos

Nombre	Description
Clone()	Devuelve un duplicado de la instancia actual FormParameter .
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Evaluate(HttpContext, Control)	Actualiza y devuelve el valor del FormParameter objeto .
GetDatabaseType()	Obtiene el DbType valor equivalente al tipo CLR de la instancia actual Parameter . (Heredado de Parameter)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
LoadViewState(Object)	Restaura el estado de vista guardado previamente de la vista del origen de datos. (Heredado de Parameter)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnParameterChanged()	Llama al OnParametersChanged(EventArgs) método de la ParameterCollection colección que contiene el Parameter objeto . (Heredado de Parameter)
SaveViewState()	Guarda los cambios en el Parameter estado de vista del objeto desde el momento en que se devolvió la página al servidor. (Heredado de Parameter)
SetDirty()	Marca el Parameter objeto para que su estado se registre en estado de vista. (Heredado de Parameter)
ToString()	Convierte el valor de esta instancia en su representación de cadena equivalente. (Heredado de Parameter)
TrackViewState()	Hace que el Parameter objeto realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en el objeto del ViewState control y conservarse en las solicitudes de la misma página. (Heredado de Parameter)

Implementaciones de interfaz explícitas

Nombre	Description
ICloneable.Clone()	Devuelve un duplicado de la instancia actual Parameter . (Heredado de Parameter)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el Parameter objeto guarda los cambios en su estado de vista. (Heredado de Parameter)
IStateManager.LoadViewState(Object)	Restaura el estado de vista guardado previamente de la vista del origen de datos. (Heredado de Parameter)
IStateManager.SaveViewState()	Guarda los cambios en el Parameter estado de vista del objeto desde el momento en que se devolvió la página al servidor. (Heredado de Parameter)
IStateManager.TrackViewState()	Hace que el Parameter objeto realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en el objeto del ViewState control y conservarse en las solicitudes de la misma página. (Heredado de Parameter)

Se aplica a

Consulte también

Comentarios

Resultoulle útil esta páxina?

Compartir por

FormParameter Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios