Parameter.Name Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il nome del parametro.
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 StringValore della proprietà
Nome del parametro. Il valore predefinito è Empty.
Esempio
Nell'esempio di codice seguente viene illustrato come visualizzare i dati filtrati usando un ObjectDataSource controllo per recuperare dati da un oggetto business di livello intermedio e un GridView controllo per visualizzare i risultati. L'esempio di codice è costituito da un TextBox controllo, un GridView controllo, il ObjectDataSource controllo e un pulsante Invia. Per impostazione predefinita, il TextBox controllo viene popolato con il nome di uno dei Northwind dipendenti. Il GridView controllo visualizza informazioni sul dipendente identificato dal nome nel TextBox controllo . Per recuperare i dati su un altro dipendente, immettere il nome completo del dipendente nel TextBox controllo e fare clic sul pulsante.
La FilterExpression proprietà specifica un'espressione utilizzata per filtrare i dati recuperati dalla SelectMethod proprietà . Usa i segnaposto dei parametri che vengono valutati ai parametri contenuti nella FilterParameters raccolta. In questo esempio il segnaposto del parametro è delimitato da virgolette singole perché il tipo del parametro è un tipo stringa che potrebbe contenere spazi. Se il tipo del parametro è un tipo numerico o di data, le virgolette di delimitazione non sono necessarie.
Questo esempio di codice fa parte di un esempio più ampio fornito per la FilterExpression proprietà della 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>
Commenti
Parameter gli oggetti non devono avere un nome; Tuttavia, i controlli origine dati possono usare il nome del parametro per trovare una corrispondenza con un Parameter oggetto in una raccolta con un parametro in una query SQL o una firma del metodo business. Ad esempio, il SqlDataSource controllo può usare il nome dell'oggetto Parameter per trovare una corrispondenza con un segnaposto in una query SQL con parametri. Analogamente, il SqlDataSource controllo può utilizzare il nome di un Parameter oggetto nell'insieme FilterParameters per trovare una corrispondenza con un segnaposto nella FilterExpression proprietà . In alcuni casi, il nome non viene utilizzato e l'ordine in cui l'oggetto Parameter viene aggiunto a una ParameterCollection raccolta è più importante. Per altre informazioni, vedere Using Parameters with the SqlDataSource Control and Using Parameters with the ObjectDataSource Control.
Se il nome del parametro viene modificato, viene chiamato il OnParameterChanged metodo .
