Parameter.Name Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o nome do parâmetro.
public:
property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };public string Name { get; set; }member this.Name : string with get, setPublic Property Name As StringValor de Propriedade
O nome do parâmetro. O valor predefinido é Empty.
Exemplos
O exemplo de código seguinte demonstra como mostrar dados filtrados usando um ObjectDataSource controlo para recuperar dados de um objeto de negócio intermédio e um GridView controlo para mostrar os resultados. O exemplo de código consiste num TextBox controlo, um GridView controlo, o ObjectDataSource controlo e um botão Submeter. Por defeito, o TextBox controlo é preenchido com o nome de um dos Northwind funcionários. O GridView controlo apresenta informações sobre o funcionário identificado pelo nome no TextBox comando. Para recuperar dados de outro colaborador, introduza o nome completo do funcionário no TextBox controlo e clique no botão.
A FilterExpression propriedade especifica uma expressão usada para filtrar os dados recuperados pela SelectMethod propriedade. Utiliza marcadores de parâmetros que são avaliados de acordo com os parâmetros contidos na FilterParameters coleção. Neste exemplo, o marcador do parâmetro é limitado por aspas simples porque o tipo do parâmetro é um tipo de cadeia que pode conter espaços. Se o tipo do parâmetro for um tipo numérico ou de data, não são necessárias aspas delimitadoras.
Este exemplo de código faz parte de um exemplo maior fornecido para a FilterExpression propriedade da ObjectDataSource classe.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ 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">
protected void ObjectDataSource1_Filtering(object sender, ObjectDataSourceFilteringEventArgs e)
{
if (Textbox1.Text == "")
{
e.ParameterValues.Clear();
e.ParameterValues.Add("FullName", "Nancy Davolio");
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<p>Show all users with the following name.</p>
<asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1"
autogeneratecolumns="False">
<columns>
<asp:boundfield headertext="ID" datafield="EmpID" />
<asp:boundfield headertext="Name" datafield="FullName" />
<asp:boundfield headertext="Street Address" datafield="Address" />
</columns>
</asp:gridview>
<!-- Security Note: The ObjectDataSource uses a FormParameter,
Security Note: which does not perform validation of input from the client. -->
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployeesAsDataSet"
typename="Samples.AspNet.CS.EmployeeLogic"
filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
<filterparameters>
<asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
</filterparameters>
</asp:objectdatasource>
<p><asp:button id="Button1" runat="server" text="Search" /></p>
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ 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">
Protected Sub ObjectDataSource1_Filtering(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.ObjectDataSourceFilteringEventArgs)
If Textbox1.Text = "" Then
e.ParameterValues.Clear()
e.ParameterValues.Add("FullName", "Nancy Davolio")
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - VB Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<p>Show all users with the following name.</p>
<asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1"
autogeneratecolumns="False">
<columns>
<asp:boundfield headertext="ID" datafield="EmpID" />
<asp:boundfield headertext="Name" datafield="FullName" />
<asp:boundfield headertext="Street Address" datafield="Address" />
</columns>
</asp:gridview>
<!-- Security Note: The ObjectDataSource uses a FormParameter,
Security Note: which does not perform validation of input from the client. -->
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployeesAsDataSet"
typename="Samples.AspNet.VB.EmployeeLogic"
filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
<filterparameters>
<asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
</filterparameters>
</asp:objectdatasource>
<p><asp:button id="Button1" runat="server" text="Search" /></p>
</form>
</body>
</html>
Observações
Parameter os objetos não são obrigados a ter um nome; no entanto, os controlos de fonte de dados podem usar o nome do parâmetro para corresponder um Parameter objeto numa coleção com um parâmetro numa consulta SQL ou assinatura de método de negócio. Por exemplo, o controlo SqlDataSource pode usar o nome do Parameter objeto para corresponder a um marcador de posição numa consulta SQL parametrizada. De forma semelhante, o controlo SqlDataSource pode usar o nome de um Parameter objeto na FilterParameters coleção para corresponder a um marcador de posição na FilterExpression propriedade. Em alguns casos, o nome não é usado e a ordem em que o Parameter objeto é adicionado a uma ParameterCollection coleção é mais importante. Para mais informações, consulte Utilização de Parâmetros com o Controlo SqlDataSource e Utilização de Parâmetros com o Controlo ObjectDataSource.
Se o nome do parâmetro for alterado, o OnParameterChanged método é chamado.
