Parameter.Name Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia nazwę parametru.
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 StringWartość właściwości
Nazwa parametru. Domyślna wartość to Empty.
Przykłady
W poniższym przykładzie kodu pokazano, jak wyświetlić przefiltrowane dane przy użyciu ObjectDataSource kontrolki w celu pobrania danych z obiektu biznesowego warstwy środkowej i GridView kontrolki w celu wyświetlenia wyników. Przykładowy kod składa się z TextBox kontrolki, GridView kontrolki, kontrolki ObjectDataSource i przycisku Prześlij. Domyślnie kontrolka TextBox jest wypełniana nazwą jednego z Northwind pracowników. Kontrolka GridView wyświetla informacje o pracowniku zidentyfikowanym przez nazwę w kontrolce TextBox . Aby pobrać dane z innego pracownika, wprowadź pełną nazwę pracownika w kontrolce TextBox i kliknij przycisk.
Właściwość FilterExpression określa wyrażenie używane do filtrowania SelectMethod danych pobranych przez właściwość. Używa symboli zastępczych parametrów, które są oceniane dla parametrów zawartych w FilterParameters kolekcji. W tym przykładzie symbol zastępczy parametru jest powiązany za pomocą pojedynczych cudzysłowów, ponieważ typ parametru jest typem ciągu, który może zawierać spacje. Jeśli typ parametru jest typem liczbowym lub typem daty, znaki cudzysłowu ograniczenia nie są potrzebne.
Ten przykład kodu jest częścią większego przykładu FilterExpression udostępnionego dla właściwości ObjectDataSource klasy.
<%@ 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>
Uwagi
Parameter obiekty nie są wymagane do posiadania nazwy; Jednak kontrolki źródła danych mogą używać nazwy parametru do dopasowania Parameter obiektu w kolekcji z parametrem w zapytaniu SQL lub sygnaturze metody biznesowej. Na przykład kontrolka SqlDataSource może użyć nazwy Parameter obiektu, aby dopasować symbol zastępczy w sparametryzowanym zapytaniu SQL. Podobnie kontrolka SqlDataSource może użyć nazwy Parameter obiektu w FilterParameters kolekcji, aby dopasować symbol zastępczy we FilterExpression właściwości . W niektórych przypadkach nazwa nie jest używana, a kolejność dodawania Parameter obiektu do ParameterCollection kolekcji jest ważniejsza. Aby uzyskać więcej informacji, zobacz Using Parameters with the SqlDataSource Control and Using Parameters with the ObjectDataSource Control (Używanie parametrów za pomocą kontrolki ObjectDataSource).
Jeśli nazwa parametru zostanie zmieniona, wywoływana OnParameterChanged jest metoda .
