Parameter.Name Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de naam van de parameter op of stelt u deze in.
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 StringWaarde van eigenschap
De naam van de parameter. De standaardwaarde is Empty.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u gefilterde gegevens weergeeft met behulp van een ObjectDataSource besturingselement om gegevens op te halen uit een bedrijfsobject in de middelste laag en een GridView besturingselement om de resultaten weer te geven. Het codevoorbeeld bestaat uit een TextBox besturingselement, een GridView besturingselement, het ObjectDataSource besturingselement en een knop Verzenden. Standaard wordt het TextBox besturingselement gevuld met de naam van een van de Northwind werknemers. Het GridView besturingselement geeft informatie weer over de werknemer die is geïdentificeerd door de naam in het TextBox besturingselement. Als u gegevens van een andere werknemer wilt ophalen, voert u de volledige naam van de werknemer in het TextBox besturingselement in en klikt u op de knop.
De FilterExpression eigenschap geeft een expressie op die wordt gebruikt om de gegevens te filteren die door de SelectMethod eigenschap zijn opgehaald. Er worden tijdelijke aanduidingen voor parameters gebruikt die worden geëvalueerd op de parameters in de FilterParameters verzameling. In dit voorbeeld wordt de tijdelijke aanduiding voor de parameter gebonden door enkele aanhalingstekens, omdat het type van de parameter een tekenreekstype is dat spaties kan bevatten. Als het type van de parameter een numeriek of datumtype is, zijn aanhalingstekens niet nodig.
Dit codevoorbeeld maakt deel uit van een groter voorbeeld dat is opgegeven voor de FilterExpression eigenschap van de ObjectDataSource klasse.
<%@ 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>
Opmerkingen
Parameter objecten zijn niet vereist om een naam te hebben; Besturingselementen voor gegevensbronnen kunnen echter de parameternaam gebruiken om een Parameter object in een verzameling te vinden met een parameter in een SQL-query of handtekening voor bedrijfsmethoden. Het besturingselement kan bijvoorbeeld SqlDataSource de naam van het Parameter object gebruiken om een tijdelijke aanduiding in een geparameteriseerde SQL-query te vinden. Op dezelfde manier kan het SqlDataSource besturingselement de naam van een Parameter object in de FilterParameters verzameling gebruiken om een tijdelijke aanduiding in de FilterExpression eigenschap te vinden. In sommige gevallen wordt de naam niet gebruikt en is de volgorde waarin het Parameter object wordt toegevoegd aan een ParameterCollection verzameling belangrijker. Zie Parameters gebruiken met het besturingselement SqlDataSource en Parameters gebruiken met het besturingselement ObjectDataSource voor meer informatie.
Als de naam van de parameter wordt gewijzigd, wordt de OnParameterChanged methode aangeroepen.
