ParameterCollection Sınıf
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.
public ref class ParameterCollection : System::Web::UI::StateManagedCollectionpublic class ParameterCollection : System.Web.UI.StateManagedCollectiontype ParameterCollection = class
inherit StateManagedCollectionPublic Class ParameterCollection
Inherits StateManagedCollection- Devralma
Örnekler
Aşağıdaki kod örneği, bir AccessDataSource denetimin nasıl kullanılacağını ve FormParameter bir denetimdeki Microsoft Access veritabanındaki bilgileri görüntülemek için öğesinin GridView nasıl kullanılacağını gösterir. FormParameter nesnesi yöntemi kullanılarak koleksiyona Add eklenirSelectParameters.
Önemli
Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.
<%@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">
void Page_Load(Object sender, EventArgs e){
// You can add a FormParameter to the AccessDataSource control's
// SelectParameters collection programmatically.
AccessDataSource1.SelectParameters.Clear();
// Security Note: The AccessDataSource uses a FormParameter,
// Security Note: which does not perform validation of input from the client.
// Security Note: To validate the value of the FormParameter,
// Security Note: handle the Selecting event.
FormParameter formParam = new FormParameter("lastname","LastNameBox");
formParam.Type=TypeCode.String;
AccessDataSource1.SelectParameters.Add(formParam);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:accessdatasource
id="AccessDataSource1"
runat="server"
datasourcemode="DataSet"
datafile="Northwind.mdb"
selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
FROM Orders WHERE EmployeeID =
(SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
</asp:accessdatasource>
<br />Enter the name "Davolio" or "King" in the text box and click the button.
<br />
<asp:textbox
id="LastNameBox"
runat="server" />
<br />
<asp:button
id="Button1"
runat="server"
text="Get Records" />
<br />
<asp:gridview
id="GridView1"
runat="server"
allowsorting="True"
datasourceid="AccessDataSource1">
</asp:gridview>
</form>
</body>
</html>
<%@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">
Private Sub Page_Load(sender As Object, e As EventArgs)
' You can add a FormParameter to the AccessDataSource control's
' SelectParameters collection programmatically.
AccessDataSource1.SelectParameters.Clear()
' Security Note: The AccessDataSource uses a FormParameter,
' Security Note: which does not perform validation of input from the client.
' Security Note: To validate the value of the FormParameter,
' Security Note: handle the Selecting event.
Dim formParam As New FormParameter("lastname","LastNameBox")
formParam.Type=TypeCode.String
AccessDataSource1.SelectParameters.Add(formParam)
End Sub ' Page_Load
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:accessdatasource
id="AccessDataSource1"
runat="server"
datasourcemode="DataSet"
datafile="Northwind.mdb"
selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
FROM Orders WHERE EmployeeID =
(SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
</asp:accessdatasource>
<br />Enter the name "Davolio" or "King" in the text box and click the button.
<br />
<asp:textbox
id="LastNameBox"
runat="server" />
<br />
<asp:button
id="Button1"
runat="server"
text="Get Records" />
<br />
<asp:gridview
id="GridView1"
runat="server"
allowsorting="True"
datasourceid="AccessDataSource1">
</asp:gridview>
</form>
</body>
</html>
Açıklamalar
sınıfı, ParameterCollection veri kaynağı denetimleriyle gelişmiş veri bağlama senaryolarında kullanılan bir nesne koleksiyonunu Parameter temsil eder. Parameter Nesneler, verileri alırken, güncelleştirirken, silerken ve eklerken yerel Page değişkenler, HTTP tanımlama bilgileri, oturum değişkenleri ve diğer denetimlerin değerlerini veri kaynağı denetimlerine bağlamak için kullanılır.
ParameterCollection Bir nesne kümesini program aracılığıyla yönetmek için sınıfını Parameter kullanın. Sınıfın uygun yöntemlerini ParameterCollection kullanarak nesneleri ekleyebilir, ekleyebilir ve kaldırabilirsinizParameter. Bir koleksiyondan program aracılığıyla nesne almak Parameter için aşağıdaki yöntemlerden birini kullanın:
Koleksiyondan ada göre veya dizi gösterimi kullanarak tek Parameter bir nesne almak için dizin oluşturucuyu kullanın.
GetEnumerator Yöntemini kullanarak -implemented nesnesini oluşturunSystem.Collections.IEnumerator. Bu nesne daha sonra koleksiyondan öğe almak için kullanılabilir.
Count özelliği koleksiyondaki öğelerin toplam sayısını belirtir ve koleksiyonun üst sınırlarını belirlemek için kullanılır. , , InsertRemoveve yöntemlerini kullanarak Addkoleksiyona öğe ekleyebilir ve RemoveAt koleksiyondan öğe kaldırabilirsiniz.
Belirli bir veri kaynağı denetiminin uygulamasına ve semantiğine bağlı olarak, parametrelerin koleksiyonda ParameterCollection depolanma sırası önemli olabilir. Örneğin, denetimi bir ODBC veri kaynağı olarak kullanırkenSqlDataSource, koleksiyondaki ParameterCollection nesnelerin sırasıParameter, kullandığınız parametreleştirilmiş SQL sorgularındaki parametrelerin sırasıyla aynı olmalıdır. Ancak, denetimi Microsoft SQL Server ile kullanırken SqlDataSource nesnelerin sırası Parameter önemli değildir.
Önemli
Veri kaynağı denetimlerini kullandığınızda, değerler doğrulama olmadan komut parametrelerine eklenir ve bu olası bir güvenlik tehdididir. Komut yürütülmeden önce parametre değerlerini doğrulamak için veri kaynağı denetiminde bir olay kullanın. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.
Aşağıdaki tabloda farklı parametre sınıfları ve bunların nasıl kullanıldığı listelenir.
| Parametre Sınıfı | Açıklama |
|---|---|
| Parameter | Temel parametre sınıfı. özelliğini kullanarak yerel bir değişkene veya herhangi bir statik dizeye DefaultValue bağlanmak için bunu kullanın. |
| ControlParameter | Bir denetimin özelliğine veya yöntem dönüş değerine bağlanmak için kullanılabilecek bir parametre. |
| CookieParameter | Tanımlama bilgisinin değerine bağlanmak için kullanılabilecek bir parametre. |
| FormParameter | Geçerli Web Forms sayfasının özniteliğine bağlanmak için kullanılabilecek bir parametre. |
| QueryStringParameter | Sorgu dizesinde Web Forms sayfasına geçirilen bir değere bağlanmak için kullanılabilecek parametre. |
| SessionParameter | Bir oturum değişkeninin değerine bağlanmak için kullanılabilecek bir parametre. |
| ProfileParameter | bir ASP.NET Profili özelliğinin değerine bağlanmak için kullanılabilecek bir parametre. |
Oluşturucular
| Name | Description |
|---|---|
| ParameterCollection() |
Sınıfı devralınan bir sınıf örneği tarafından kullanılmak üzere başlatır. Bu oluşturucu yalnızca devralınan bir sınıf tarafından çağrılabilir. |
Özellikler
| Name | Description |
|---|---|
| Count |
Koleksiyonda StateManagedCollection bulunan öğe sayısını alır. (Devralındığı yer: StateManagedCollection) |
| Item[Int32] |
Nesneyi koleksiyonda Parameter belirtilen dizinde alır veya ayarlar. |
| Item[String] |
Koleksiyonda Parameter belirtilen ada sahip nesneyi alır veya ayarlar. |
Yöntemler
| Name | Description |
|---|---|
| Add(Parameter) |
Belirtilen Parameter nesneyi koleksiyonun sonuna ekler. |
| Add(String, DbType, String) |
Belirtilen ada, veritabanı türüne ve varsayılan değere sahip bir Parameter nesne oluşturur ve bunu koleksiyonun sonuna ekler. |
| Add(String, String) |
Belirtilen ada ve varsayılan değere sahip bir Parameter nesne oluşturur ve bunu koleksiyonun sonuna ekler. |
| Add(String, TypeCode, String) |
Belirtilen ada, TypeCodeve varsayılan değere sahip bir Parameter nesne oluşturur ve bunu koleksiyonun sonuna ekler. |
| Clear() |
Koleksiyondaki StateManagedCollection tüm öğeleri kaldırır. (Devralındığı yer: StateManagedCollection) |
| Contains(Parameter) |
Koleksiyonun ParameterCollection belirli bir değer içerip içermediğini belirler. |
| CopyTo(Array, Int32) |
Koleksiyonun öğelerini StateManagedCollection belirli bir dizi dizininden başlayarak bir diziye kopyalar. (Devralındığı yer: StateManagedCollection) |
| CopyTo(Parameter[], Int32) |
Parametre dizisinin belirtilen dizinini parametre koleksiyonuna kopyalar. |
| CreateKnownType(Int32) |
Varsayılan Parameter nesnenin bir örneğini oluşturur. |
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| GetEnumerator() |
Koleksiyonda StateManagedCollection yineleyen bir yineleyici döndürür. (Devralındığı yer: StateManagedCollection) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetKnownTypes() |
Koleksiyonun Parameter içerebileceği bir tür ParameterCollection dizisi alır. |
| GetType() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| GetValues(HttpContext, Control) |
Şu anda koleksiyonda yer alan nesne adlarının Parameter ve buna karşılık gelen değerlerin sıralı bir koleksiyonunu alır. |
| IndexOf(Parameter) |
Koleksiyonda belirtilen Parameter bir nesnenin dizinini ParameterCollection belirler. |
| Insert(Int32, Parameter) |
Belirtilen nesneyi belirtilen Parameter dizindeki ParameterCollection koleksiyona ekler. |
| MemberwiseClone() |
Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object) |
| OnClear() |
Türetilmiş bir sınıfta geçersiz kılındığında, yöntemi koleksiyondan tüm öğeleri kaldırmadan önce Clear() ek iş gerçekleştirir. (Devralındığı yer: StateManagedCollection) |
| OnClearComplete() |
Koleksiyonun içeriğini temizledikten sonra ek özel işlemler gerçekleştirir. |
| OnInsert(Int32, Object) |
Yöntemi çağrılmadan Insert(Int32, Parameter) önce gerçekleşir. |
| OnInsertComplete(Int32, Object) |
Yöntem tamamlandıktan sonra Insert(Int32, Parameter) gerçekleşir. |
| OnParametersChanged(EventArgs) |
Olayı tetikler ParametersChanged . |
| OnRemove(Int32, Object) |
Türetilmiş bir sınıfta geçersiz kılındığında, veya IList.RemoveAt(Int32) yöntemi belirtilen öğeyi koleksiyondan kaldırmadan önce IList.Remove(Object) ek iş gerçekleştirir. (Devralındığı yer: StateManagedCollection) |
| OnRemoveComplete(Int32, Object) |
Yöntem tamamlandıktan sonra Remove(Parameter) gerçekleşir. |
| OnValidate(Object) |
Bir değeri doğrularken ek özel işlemler gerçekleştirir. |
| Remove(Parameter) |
Belirtilen Parameter nesneyi koleksiyondan ParameterCollection kaldırır. |
| RemoveAt(Int32) |
Parameter Belirtilen dizindeki nesneyi koleksiyondan ParameterCollection kaldırır. |
| SetDirty() |
Koleksiyonun tamamının StateManagedCollection görünüm durumuna seri hale getirilmeye zorlanması. (Devralındığı yer: StateManagedCollection) |
| SetDirtyObject(Object) |
Belirtilen Parameter nesneyi son yüklemeden sonra değişmiş veya görünüm durumundan kaydet olarak işaretler. |
| ToString() |
Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object) |
| UpdateValues(HttpContext, Control) |
Koleksiyonun Parameter içerdiği nesneleri yineler ve her birinde yöntemini çağırır |
Ekinlikler
| Name | Description |
|---|---|
| ParametersChanged |
Koleksiyon tarafından kapsanan bir veya daha fazla Parameter nesnenin durumu değiştiğinde gerçekleşir. |
Belirtik Arabirim Kullanımları
| Name | Description |
|---|---|
| ICollection.Count |
Koleksiyonda StateManagedCollection bulunan öğe sayısını alır. (Devralındığı yer: StateManagedCollection) |
| ICollection.IsSynchronized |
Koleksiyonun StateManagedCollection eşitlenip eşitlenmediğini belirten bir değer alır (iş parçacığı güvenli). Bu yöntem her durumda döndürür |
| ICollection.SyncRoot |
Koleksiyona erişimi StateManagedCollection eşitlemek için kullanılabilecek bir nesne alır. Bu yöntem her durumda döndürür |
| IEnumerable.GetEnumerator() |
Koleksiyonda StateManagedCollection yineleyen bir yineleyici döndürür. (Devralındığı yer: StateManagedCollection) |
| IList.Add(Object) |
Koleksiyona StateManagedCollection bir öğe ekler. (Devralındığı yer: StateManagedCollection) |
| IList.Clear() |
Koleksiyondaki StateManagedCollection tüm öğeleri kaldırır. (Devralındığı yer: StateManagedCollection) |
| IList.Contains(Object) |
Koleksiyonun StateManagedCollection belirli bir değer içerip içermediğini belirler. (Devralındığı yer: StateManagedCollection) |
| IList.IndexOf(Object) |
Koleksiyonda belirtilen öğenin dizinini StateManagedCollection belirler. (Devralındığı yer: StateManagedCollection) |
| IList.Insert(Int32, Object) |
Belirtilen dizinde koleksiyona StateManagedCollection bir öğe ekler. (Devralındığı yer: StateManagedCollection) |
| IList.IsFixedSize |
Koleksiyonun StateManagedCollection sabit bir boyutu olup olmadığını belirten bir değer alır. Bu yöntem her durumda döndürür |
| IList.IsReadOnly |
Koleksiyonun StateManagedCollection salt okunur olup olmadığını belirten bir değer alır. (Devralındığı yer: StateManagedCollection) |
| IList.Item[Int32] |
IStateManager Belirtilen dizindeki öğesini alır. (Devralındığı yer: StateManagedCollection) |
| IList.Remove(Object) |
Belirtilen nesnenin ilk oluşumunu koleksiyondan StateManagedCollection kaldırır. (Devralındığı yer: StateManagedCollection) |
| IList.RemoveAt(Int32) |
Belirtilen dizindeki IStateManager öğesini kaldırır. (Devralındığı yer: StateManagedCollection) |
| IStateManager.IsTrackingViewState |
Koleksiyonun StateManagedCollection değişiklikleri görünüm durumuna kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: StateManagedCollection) |
| IStateManager.LoadViewState(Object) |
Koleksiyonun ve IStateManager içerdiği öğelerin önceden kaydedilmiş görünüm durumunu StateManagedCollection geri yükler. (Devralındığı yer: StateManagedCollection) |
| IStateManager.SaveViewState() |
Sayfa sunucuya geri gönderildiğinden StateManagedCollection bu yana koleksiyonda ve içerdiği her IStateManager nesnede yapılan değişiklikleri kaydeder. (Devralındığı yer: StateManagedCollection) |
| IStateManager.TrackViewState() |
Koleksiyonun StateManagedCollection ve içerdiği nesnelerin her birinin IStateManager , aynı sayfaya yönelik istekler arasında kalıcı olabilmeleri için görünüm durumlarındaki değişiklikleri izlemesine neden olur. (Devralındığı yer: StateManagedCollection) |
Uzantı Metotları
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Sorgunun paralelleştirilmesini etkinleştirir. |
| AsQueryable(IEnumerable) |
bir IEnumerable öğesine IQueryabledönüştürür. |
| Cast<TResult>(IEnumerable) |
öğesinin IEnumerable öğelerini belirtilen türe yazar. |
| OfType<TResult>(IEnumerable) |
Belirtilen türe göre bir IEnumerable öğesinin öğelerini filtreler. |
