Home Biblioteca Aprender Galeria Downloads Suporte Comunidade Fóruns
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Classe FormParameter

.NET Framework 4.5

Vincula o valor de uma solicitação HTTP Form campo a um objeto de parâmetro.

System.Object
  System.Web.UI.WebControls.Parameter
    System.Web.UI.WebControls.FormParameter

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)
C#
C++
F#
VB
Copiar 
public class FormParameter : Parameter

O tipo FormParameter expõe os membros a seguir.

  NomeDescrição
Método públicoFormParameter()Inicializa uma nova instância sem nome da FormParameter classe.
Método protegidoFormParameter(FormParameter)Inicializa uma nova instância da FormParameter a classe com os valores da instância especificada pelo original parâmetro.
Método públicoFormParameter(String, String)Inicializa uma nova instância de nomeada a FormParameter de classe, usando a seqüência especificada para identificar qual campo de variável de formulário para vincular a.
Método públicoFormParameter(String, DbType, String)Inicializa uma nova instância da FormParameter de classe, usando a seqüência especificada para identificar qual campo de variável de formulário para vincular a.
Método públicoFormParameter(String, TypeCode, String)Inicializa uma nova instância nomeada e com rigidez de tipos da FormParameter de classe, usando a seqüência especificada para identificar qual variável de formulário para vincular a.
Superior
  NomeDescrição
Propriedade públicaConvertEmptyStringToNullObtém ou define um valor indicando se o valor que o Parameter objeto está vinculado ao deve ser convertido em null se for String.Empty. (Herdado de Parameter.)
Propriedade públicaDbTypeObtém ou define o tipo de banco de dados do parâmetro. (Herdado de Parameter.)
Propriedade públicaDefaultValueEspecifica um valor padrão para o parâmetro, deve o valor que o parâmetro é acoplado ao ser inicializado quando o Evaluate método é chamado. (Herdado de Parameter.)
Propriedade públicaDirectionIndica se a Parameter objeto é usado para associar um valor a um controle ou o controle pode ser usado para alterar o valor. (Herdado de Parameter.)
Propriedade públicaFormFieldObtém ou define o nome da variável de formulário que vincula o parâmetro.
Propriedade protegidaIsTrackingViewStateObtém um valor indicando se a Parameter objeto está salvando as alterações ao seu estado de exibição. (Herdado de Parameter.)
Propriedade públicaNameObtém ou define o nome do parâmetro. (Herdado de Parameter.)
Propriedade públicaSizeObtém ou define o tamanho do parâmetro. (Herdado de Parameter.)
Propriedade públicaTypeObtém ou define o tipo do parâmetro. (Herdado de Parameter.)
Propriedade públicaValidateInputObtém ou define um valor que indica se o cliente no parâmetro de entrada é validado.
Propriedade protegidaViewStateObtém um dicionário de informações de estado que permite que você salvar e restaurar o estado de exibição de um Parameter objeto nas várias solicitações para a mesma página. (Herdado de Parameter.)
Superior
  NomeDescrição
Método protegidoCloneRetorna uma duplicata do atual FormParameter instância. (Substitui Parameter.Clone().)
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoEvaluateAtualiza e retorna o valor da FormParameter objeto. (Substitui Parameter.Evaluate(HttpContext, Control).)
Método protegidoFinalize Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGetDatabaseTypeObtém o DbType valor que é equivalente ao tipo CLR do atual Parameter instância. (Herdado de Parameter.)
Método públicoGetHashCodeServe como uma função hash para um tipo específico. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoLoadViewStateRestaura a exibição de fonte de dados salvo anteriormente estado de exibição. (Herdado de Parameter.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método protegidoOnParameterChangedChamadas de OnParametersChanged método da ParameterCollection coleção que contém o Parameter objeto. (Herdado de Parameter.)
Método protegidoSaveViewStateSalva as alterações para o Parameter estado de exibição do objeto desde o momento em que a página foi postada de volta para o servidor. (Herdado de Parameter.)
Método protegidoSetDirtyMarcas do Parameter de objeto para que o seu estado será registrado no estado de exibição. (Herdado de Parameter.)
Método públicoToStringConverte o valor desta instância em sua representação de seqüência equivalente. (Herdado de Parameter.)
Método protegidoTrackViewStateFaz com que o Parameter o objeto para controlar alterações ao seu estado de exibição para que eles podem ser armazenados no controle de ViewState objeto e persistentes entre as solicitações para a mesma página. (Herdado de Parameter.)
Superior
  NomeDescrição
Implementação explícita da interfaceMétodo particularICloneable.CloneRetorna uma duplicata do atual Parameter instância. (Herdado de Parameter.)
Implementação explícita da interfacePropriedade particularIStateManager.IsTrackingViewStateInfraestrutura. Obtém um valor indicando se a Parameter objeto está salvando as alterações ao seu estado de exibição. (Herdado de Parameter.)
Implementação explícita da interfaceMétodo particularIStateManager.LoadViewStateInfraestrutura. Restaura a exibição de fonte de dados salvo anteriormente estado de exibição. (Herdado de Parameter.)
Implementação explícita da interfaceMétodo particularIStateManager.SaveViewStateInfraestrutura. Salva as alterações para o Parameter estado de exibição do objeto desde o momento em que a página foi postada de volta para o servidor. (Herdado de Parameter.)
Implementação explícita da interfaceMétodo particularIStateManager.TrackViewStateInfraestrutura. Faz com que o Parameter o objeto para controlar alterações ao seu estado de exibição para que eles podem ser armazenados no controle de ViewState objeto e persistentes entre as solicitações para a mesma página. (Herdado de Parameter.)
Superior

Você pode usar o FormParameter classe para vincular o valor de uma variável de formulário na Form coleção para um parâmetro usado em uma consulta parametrizada ou comando. Controles que ligar dados para o parâmetro podem lançar uma exceção se um FormParameter for especificado, mas nenhuma variável de formulário correspondente é passado. Eles também podem exibir sem dados se a variável de formulário é passada com nenhum valor correspondente. Definir o DefaultValue para evitar essas situações onde for apropriado.

O FormParameter classe fornece o FormField propriedade, que identifica o nome da variável de formulário para vincular a, com aqueles herdados da Parameter classe.

Observação importanteImportante

O FormParameter não valida o valor passado pelo elemento de formulário de forma alguma; Ele usa o valor não processado. Na maioria dos casos, você pode validar o valor da FormParameter antes que ele é usado por um controle de fonte de dados ao manipular um evento, como o Selecting, Updating, Inserting, ou Deleting eventos expostos pelo controle de fonte de dados você está usando. Se o valor do parâmetro não passar os testes de validação, você pode cancelar a operação de dados, definindo a Cancel propriedade do associado CancelEventArgs de classe para true.

O exemplo de código a seguir demonstra como inserir dados em um banco de dados usando o SqlDataSource controle e uma página ASP.Página da Web do NET. Os dados atuais na tabela de dados são exibidos na DropDownList controle. Você pode adicionar novos registros inserindo valores a TextBox controles e clicando no botão. Quando o botão é clicado, os valores especificados são inseridos no banco de dados e o DropDownList é atualizado.

Observação de segurançaObservação de segurança

Este exemplo tem uma caixa de texto que aceita entrada do usuário, que é uma ameaça potencial de segurança. Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML. Para mais informações, acesse Visão Geral de Scripts Maliciosos.

C#
VB
Copiar 

<%@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>

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.
Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
© 2013 Microsoft. Todos os direitos reservados.
|
Comentários sobre o site
© 2013 Microsoft. Todos os direitos reservados.