ObjectDataSourceView.FilterExpression Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
özelliği tarafından SelectMethod tanımlanan iş nesnesi yöntemi çağrıldığında uygulanan bir filtreleme ifadesi alır veya ayarlar.
public:
property System::String ^ FilterExpression { System::String ^ get(); void set(System::String ^ value); };public string FilterExpression { get; set; }member this.FilterExpression : string with get, setPublic Property FilterExpression As StringÖzellik Değeri
özelliği tarafından SelectMethod tanımlanan iş nesnesi yöntemi kullanılarak veriler alındığında uygulanan bir filtreleme ifadesini temsil eden dize.
Özel durumlar
FilterExpression özelliği ayarlandı ve Select(DataSourceSelectArguments) yöntemi bir DataSetdöndürmez.
Örnekler
Bu bölüm iki kod örneği içerir. İlk kod örneği, bir orta katman iş nesnesinden veri almak için bir ObjectDataSource denetim ve sonuçları görüntülemek için bir GridView denetim kullanarak filtrelenmiş verilerin nasıl görüntüleneceğini gösterir. İkinci kod örneği, ilk kod örneğinde kullanılan orta katman iş nesnesine bir örnek sağlar.
Aşağıdaki kod örneği, bir orta katman iş nesnesinden veri almak için bir ObjectDataSource denetim ve sonuçları görüntülemek için bir GridView denetim kullanarak filtrelenmiş verilerin nasıl görüntüleneceğini gösterir. Denetim ObjectDataSource yalnızca verileri alan yöntem bunu bir DataSet nesne olarak aldığında verileri filtreleyebilir. Bu nedenle özelliği, SelectMethod verileri olarak DataSetalan bir iş nesnesi yöntemini tanımlar.
Kod örneği bir , denetimiTextBoxGridView, ObjectDataSource denetim ve Gönder düğmesinden oluşur. varsayılan olarak , TextBox Northwind Traders çalışanlarından birinin adıyla doldurulur. , GridView içindeki adıyla TextBoxtanımlanan çalışan hakkındaki bilgileri görüntüler. Başka bir çalışanın TextBoxverilerini almak için, içinde çalışanın tam adını girin ve gönder düğmesine tıklayın.
özelliği, FilterExpression özelliği tarafından alınan verileri filtrelemek için kullanılan bir ifade belirtir SelectMethod . Koleksiyonda FilterParameters bulunan parametrelere göre değerlendirilen parametre yer tutucularını kullanır. Bu örnekte parametrenin türü boşluk içerebilen bir dize türü olduğundan parametre yer tutucusu tek tırnak işaretleri ile sınırlanır. Parametrenin türü sayısal veya tarih türündeyse, sınırlayıcı tırnak işaretleri gerekli değildir.
<%@ 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>
Aşağıdaki kod örneği, önceki kod örneğinin kullandığı bir orta katman iş nesnesi örneği sağlar. Kod örneği iki temel sınıftan oluşur:
EmployeeLogicİş mantığını kapsülleyen bir sınıf olan sınıfı.NorthwindEmployeesınıfı, yalnızca veri katmanından verileri yüklemek ve kalıcı hale getirmek için gereken temel işlevleri içeren bir model sınıfıdır.
Kolaylık olması için sınıfı, EmployeeLogic verileri bir veri katmanından almak yerine statik bir veri kümesi oluşturur. Bu örnekte de yararlıdır çünkü örnek, filtrelemeyi göstermek için bir Northwind Traders çalışanının tam adını sağlamanıza dayanır.
Tam bir çalışma örneği için, sağlanan Web Forms sayfa kodu örnekleriyle bu sınıfları derlemeniz ve kullanmanız gerekir.
namespace Samples.AspNet.CS {
using System;
using System.Collections;
using System.Data;
using System.Web.UI.WebControls;
//
// EmployeeLogic is a stateless business object that encapsulates
// the operations you can perform on a NorthwindEmployee object.
//
public class EmployeeLogic {
// Returns a collection of NorthwindEmployee objects.
public static ICollection GetAllEmployees () {
ArrayList data = new ArrayList();
data.Add(new NorthwindEmployee(1,"Nancy","Davolio","507 - 20th Ave. E. Apt. 2A"));
data.Add(new NorthwindEmployee(2,"Andrew","Fuller","908 W. Capital Way"));
data.Add(new NorthwindEmployee(3,"Janet","Leverling","722 Moss Bay Blvd."));
data.Add(new NorthwindEmployee(4,"Margaret","Peacock","4110 Old Redmond Rd."));
data.Add(new NorthwindEmployee(5,"Steven","Buchanan","14 Garrett Hill"));
data.Add(new NorthwindEmployee(6,"Michael","Suyama","Coventry House Miner Rd."));
data.Add(new NorthwindEmployee(7,"Robert","King","Edgeham Hollow Winchester Way"));
return data;
}
public static NorthwindEmployee GetEmployee(object anID) {
ArrayList data = GetAllEmployees() as ArrayList;
int empID = Int32.Parse(anID.ToString());
return data[empID] as NorthwindEmployee;
}
//
// To support basic filtering, the employees cannot
// be returned as an array of objects, rather as a
// DataSet of the raw data values.
public static DataSet GetAllEmployeesAsDataSet () {
ICollection employees = GetAllEmployees();
DataSet ds = new DataSet("Table");
// Create the schema of the DataTable.
DataTable dt = new DataTable();
DataColumn dc;
dc = new DataColumn("EmpID", typeof(int)); dt.Columns.Add(dc);
dc = new DataColumn("FullName",typeof(string)); dt.Columns.Add(dc);
dc = new DataColumn("Address", typeof(string)); dt.Columns.Add(dc);
// Add rows to the DataTable.
DataRow row;
foreach (NorthwindEmployee ne in employees) {
row = dt.NewRow();
row["EmpID"] = ne.EmpID;
row["FullName"] = ne.FullName;
row["Address"] = ne.Address;
dt.Rows.Add(row);
}
// Add the complete DataTable to the DataSet.
ds.Tables.Add(dt);
return ds;
}
}
public class NorthwindEmployee {
public NorthwindEmployee (int anID,
string aFirstName,
string aLastName,
string anAddress) {
ID = anID;
firstName = aFirstName;
lastName = aLastName;
address = anAddress;
}
private object ID;
public string EmpID {
get { return ID.ToString(); }
}
private string lastName;
public string LastName {
get { return lastName; }
set { lastName = value; }
}
private string firstName;
public string FirstName {
get { return firstName; }
set { firstName = value; }
}
public string FullName {
get { return FirstName + " " + LastName; }
}
private string address;
public string Address {
get { return address; }
set { address = value; }
}
}
}
Imports System.Collections
Imports System.Data
Imports System.Web.UI.WebControls
Namespace Samples.AspNet.VB
'
' EmployeeLogic is a stateless business object that encapsulates
' the operations you can perform on a NorthwindEmployee object.
'
Public Class EmployeeLogic
' Returns a collection of NorthwindEmployee objects.
Public Shared Function GetAllEmployees() As ICollection
Dim data As New ArrayList()
data.Add(New NorthwindEmployee(1, "Nancy", "Davolio", "507 - 20th Ave. E. Apt. 2A"))
data.Add(New NorthwindEmployee(2, "Andrew", "Fuller", "908 W. Capital Way"))
data.Add(New NorthwindEmployee(3, "Janet", "Leverling", "722 Moss Bay Blvd."))
data.Add(New NorthwindEmployee(4, "Margaret", "Peacock", "4110 Old Redmond Rd."))
data.Add(New NorthwindEmployee(5, "Steven", "Buchanan", "14 Garrett Hill"))
data.Add(New NorthwindEmployee(6, "Michael", "Suyama", "Coventry House Miner Rd."))
data.Add(New NorthwindEmployee(7, "Robert", "King", "Edgeham Hollow Winchester Way"))
Return data
End Function 'GetAllEmployees
Public Shared Function GetEmployee(anID As Object) As NorthwindEmployee
Dim data As ArrayList = CType(GetAllEmployees(), ArrayList)
Dim empID As Integer = Int32.Parse(anID.ToString())
Return CType(data(empID),NorthwindEmployee)
End Function 'GetEmployee
' To support basic filtering, the employees cannot
' be returned as an array of objects, rather as a
' DataSet of the raw data values.
Public Shared Function GetAllEmployeesAsDataSet() As DataSet
Dim employees As ICollection = GetAllEmployees()
Dim ds As New DataSet("Table")
' Create the schema of the DataTable.
Dim dt As New DataTable()
Dim dc As DataColumn
dc = New DataColumn("EmpID", GetType(Integer))
dt.Columns.Add(dc)
dc = New DataColumn("FullName", GetType(String))
dt.Columns.Add(dc)
dc = New DataColumn("Address", GetType(String))
dt.Columns.Add(dc)
' Add rows to the DataTable.
Dim row As DataRow
Dim ne As NorthwindEmployee
For Each ne In employees
row = dt.NewRow()
row("EmpID") = ne.EmpID
row("FullName") = ne.FullName
row("Address") = ne.Address
dt.Rows.Add(row)
Next
' Add the complete DataTable to the DataSet.
ds.Tables.Add(dt)
Return ds
End Function 'GetAllEmployeesAsDataSet
End Class
Public Class NorthwindEmployee
Public Sub New(anID As Integer, aFirstName As String, aLastName As String, anAddress As String)
ID = anID
Me.aFirstName = aFirstName
Me.aLastName = aLastName
Me.aAddress = anAddress
End Sub
Private ID As Object
Public ReadOnly Property EmpID() As String
Get
Return ID.ToString()
End Get
End Property
Private aLastName As String
Public Property LastName() As String
Get
Return aLastName
End Get
Set
aLastName = value
End Set
End Property
Private aFirstName As String
Public Property FirstName() As String
Get
Return aFirstName
End Get
Set
aFirstName = value
End Set
End Property
Public ReadOnly Property FullName() As String
Get
Return FirstName & " " & LastName
End Get
End Property
Private aAddress As String
Public Property Address() As String
Get
Return aAddress
End Get
Set
aAddress = value
End Set
End Property
End Class
End Namespace
Açıklamalar
DenetimObjectDataSource, yalnızca yöntem bir DataSet, DataViewveya DataTable nesnesi döndürdüğünde verileri filtrelemeyi Select destekler.
özelliği için FilterExpression kullanılan söz dizimi, biçim dizesi stili bir ifadedir. Filtre ifadesi söz dizimi, yöntemin yürütülmesinden döndürülen nesnenin özelliğine DataView RowFilter filtre ifadesi uygulandığından özelliği tarafından RowFilter kabul edilen söz dizimi ile Select aynıdır. (Daha fazla bilgi için bkz. Expression.) Koleksiyona FilterParameters parametre eklerseniz, parametre değerlerinin yerini alacak şekilde ifadeye biçim dizesi yer tutucuları "{0}"da ekleyebilirsiniz. Yer tutucular, koleksiyondaki parametrenin FilterParameters dizinine göre değiştirilir.
parametrelerine FilterExpressionekleyebilirsiniz. Parametrenin türü bir dize veya karakter türüyse, parametreyi tek tırnak içine alın. Parametre sayısal bir türse tırnak işareti gerekmez. FilterParameters Koleksiyonu, içinde FilterExpressionbulunan yer tutucular için değerlendirilen parametreleri içerir.
özelliğinin FilterExpression değeri görünüm durumunda depolanır.
Önemli
İstemciden aldığınız filtre parametresi değerlerini doğrulamanız önerilir. Çalışma zamanı, parametre değerini filtre ifadesiyle değiştirerek yöntemi tarafından Select döndürülen nesneye DataView uygular. Döndürülen öğe sayısını sınırlamak için özelliğini güvenlik önlemi olarak kullanıyorsanız FilterExpression , filtreleme gerçekleşmeden önce parametre değerlerini doğrulamanız gerekir.