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 microsoft access veritabanındaki bilgileri bir denetimde görüntülemek için öğesinin GridView nasıl kullanılacağını gösterir. FormParameter nesnesi yöntemi kullanılarak koleksiyona SelectParametersAdd eklenir.
Ö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ı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 veya dizi gösterimine göre tek Parameter bir nesne almak için dizin oluşturucuyu kullanın.
GetEnumerator Yöntemi kullanarak -implemented nesnesi 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ı | Description |
|---|---|
| Parameter | Temel parametre sınıfı. özelliğini kullanarak yerel bir değişkene veya herhangi bir statik dizeye DefaultValue bağlamak için 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 | 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
| 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
| Count |
Koleksiyondaki StateManagedCollection öğelerin 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
| 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 koleksiyonun sonuna ekler. |
| Add(String, String) |
Belirtilen ad 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 içerebileceği tür dizisini ParameterParameterCollection alır. |
| GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
| GetValues(HttpContext, Control) |
Şu anda koleksiyonda bulunan nesne adlarının Parameter ve ilgili değerlerinin sıralı bir koleksiyonunu alır. |
| IndexOf(Parameter) |
Koleksiyondaki belirtilen Parameter nesnenin dizinini ParameterCollection belirler. |
| Insert(Int32, Parameter) |
Belirtilen nesneyi belirtilen Parameter dizindeki ParameterCollection koleksiyona ekler. |
| MemberwiseClone() |
Geçerli Objectöğesinin sığ 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() |
Tüm StateManagedCollection koleksiyonun görünüm durumuna seri hale getirilmeye zorlar. (Devralındığı yer: StateManagedCollection) |
| SetDirtyObject(Object) |
Belirtilen Parameter nesneyi son yüklemeden veya görünümden kaydetme durumundan sonra değişmiş olarak işaretler. |
| ToString() |
Geçerli nesneyi temsil eden dizeyi 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
| ParametersChanged |
Koleksiyon tarafından kapsanan bir veya daha fazla Parameter nesnenin durumu değiştiğinde gerçekleşir. |
Belirtik Arabirim Kullanımları
| ICollection.Count |
Koleksiyondaki StateManagedCollection öğelerin 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) |
Koleksiyondaki 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 sabit bir boyuta StateManagedCollection sahip 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 görünüm durumundaki değişiklikleri 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 beri 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 görünüm durumlarındaki değişiklikleri izlemesine neden olur, böylece aynı sayfaya yönelik istekler arasında kalıcı hale gelebilirler. (Devralındığı yer: StateManagedCollection) |
Uzantı Metotları
| Cast<TResult>(IEnumerable) |
öğesinin IEnumerable öğelerini belirtilen türe atar. |
| OfType<TResult>(IEnumerable) |
Bir öğesinin IEnumerable öğelerini belirtilen türe göre filtreler. |
| AsParallel(IEnumerable) |
Sorgunun paralelleştirilmesini sağlar. |
| AsQueryable(IEnumerable) |
bir IEnumerable öğesini öğesine IQueryabledönüştürür. |
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin