Parameter.Name Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger namnet på parametern.
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 StringEgenskapsvärde
Namnet på parametern. Standardvärdet är Empty.
Exempel
Följande kodexempel visar hur du visar filtrerade data med hjälp av en ObjectDataSource kontroll för att hämta data från ett affärsobjekt på mellannivå och en GridView kontroll för att visa resultatet. Kodexemplet består av en TextBox kontroll, en GridView kontroll, ObjectDataSource kontrollen och en Skicka-knapp. Som standard TextBox fylls kontrollen med namnet på en av de Northwind anställda. Kontrollen GridView visar information om medarbetaren som identifieras med namnet i TextBox kontrollen. Om du vill hämta data om en annan anställd anger du det fullständiga namnet på medarbetaren TextBox i kontrollen och klickar på knappen.
Egenskapen FilterExpression anger ett uttryck som används för att filtrera data som hämtas av SelectMethod egenskapen. Den använder parameterplatshållare som utvärderas till parametrarna i FilterParameters samlingen. I det här exemplet begränsas parameterplatshållaren av enkla citattecken eftersom parametertypen är en strängtyp som kan innehålla blanksteg. Om parametertypen är en numerisk typ eller datumtyp behövs inte avgränsning av citattecken.
Det här kodexemplet är en del av ett större exempel som tillhandahålls för FilterExpression klassens ObjectDataSource egenskap.
<%@ 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>
Kommentarer
Parameter objekt krävs inte för att ha ett namn. Datakällkontroller kan dock använda parameternamnet för att matcha ett Parameter objekt i en samling med en parameter i en SQL-fråga eller en affärsmetodsignatur. Kontrollen kan till exempel SqlDataSource använda namnet på Parameter objektet för att matcha en platshållare i en parameteriserad SQL-fråga. SqlDataSource På samma sätt kan kontrollen använda namnet på ett Parameter objekt i FilterParameters samlingen för att matcha en platshållare i egenskapenFilterExpression. I vissa fall används inte namnet och ordningen i vilken Parameter objektet läggs till i en ParameterCollection samling är viktigare. Mer information finns i Använda parametrar med SqlDataSource-kontrollen och Använda parametrar med ObjectDataSource-kontrollen.
Om namnet på parametern ändras OnParameterChanged anropas metoden.
