Aracılığıyla paylaş


FormParameter Sınıf

Tanım

HTTP istek Form alanının değerini parametre nesnesine bağlar.

public ref class FormParameter : System::Web::UI::WebControls::Parameter
public class FormParameter : System.Web.UI.WebControls.Parameter
type FormParameter = class
    inherit Parameter
Public Class FormParameter
Inherits Parameter
Devralma
FormParameter

Örnekler

Aşağıdaki kod örneği, denetimi ve basit bir ASP.NET Web sayfasını kullanarak SqlDataSource veritabanına veri eklemeyi gösterir. Veri tablosundaki geçerli veriler denetimde DropDownList görüntülenir. Denetimlere TextBox değerler girip düğmeye tıklayarak yeni kayıtlar ekleyebilirsiniz. Düğmeye tıklandığında, belirtilen değerler veritabanına eklenir ve DropDownList yenilenir.

Ö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">
private void InsertShipper (object source, EventArgs e) {
  SqlDataSource1.Insert();
}
</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:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

      <br /><asp:textbox
           id="CompanyNameBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

      <br /><asp:textbox
           id="PhoneBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

    </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 InsertShipper (ByVal Source As Object, ByVal e As EventArgs)
  SqlDataSource1.Insert()
End Sub ' InsertShipper
</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:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

      <br /><asp:textbox
           id="CompanyNameBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

      <br /><asp:textbox
           id="PhoneBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

    </form>
  </body>
</html>

Açıklamalar

sınıfını FormParameter kullanarak koleksiyondaki Form bir form değişkeninin değerini parametreli sorgu veya komutta kullanılan bir parametreye bağlayabilirsiniz. Parametresine veri bağlayan denetimler, belirtildiyse ancak karşılık gelen form değişkeni geçirilmezse FormParameter bir özel durum oluşturabilir. Form değişkeni karşılık gelen değer olmadan geçirilirse de veri görüntülemeyebilirler. DefaultValue Uygun durumlarda bu durumlardan kaçınmak için öğesini ayarlayın.

FormParameter sınıfı, sınıfından FormField devralınanlara Parameter ek olarak bağlanacak form değişkeninin adını tanımlayan özelliğini sağlar.

Önemli

, FormParameter form öğesi tarafından geçirilen değeri herhangi bir şekilde doğrulamaz; ham değeri kullanır. Çoğu durumda, bir veri kaynağı denetimi tarafından kullanılmadan önce değerini FormParameter doğrulamak için kullandığınız veri kaynağı denetimi tarafından kullanıma sunulan , Updating, Insertingveya Deleting olayı gibi Selectingbir olayı işleyebilirsiniz. parametresinin değeri doğrulama testlerinizi geçmezse, ilişkili CancelEventArgs sınıfın trueözelliğini olarak ayarlayarak Cancel veri işlemini iptal edebilirsiniz.

Oluşturucular

FormParameter()

sınıfının yeni bir adsız örneğini FormParameter başlatır.

FormParameter(FormParameter)

parametresi tarafından belirtilen örneğin değerleriyle sınıfının yeni bir örneğini FormParameteroriginal başlatır.

FormParameter(String, DbType, String)

Hangi form değişkeni alanına bağlanacağını belirlemek için belirtilen dizeyi kullanarak sınıfının yeni bir örneğini FormParameter başlatır.

FormParameter(String, String)

Hangi form değişkeni alanına bağlanacağını belirlemek için belirtilen dizeyi kullanarak sınıfının yeni bir adlandırılmış örneğini FormParameter başlatır.

FormParameter(String, TypeCode, String)

Hangi form değişkenine FormParameter bağlanacağını belirlemek için belirtilen dizeyi kullanarak sınıfın adlandırılmış ve kesin olarak belirlenmiş yeni bir örneğini başlatır.

Özellikler

ConvertEmptyStringToNull

nesnenin bağlı olduğu değerin Parameter ise Emptydeğerine dönüştürülmesi null gerekip gerekmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: Parameter)
DbType

Parametresinin veritabanı türünü alır veya ayarlar.

(Devralındığı yer: Parameter)
DefaultValue

Yöntemi çağrıldığında Evaluate(HttpContext, Control) parametrenin başlatılmamış olarak bağlı olduğu değerin parametresi için varsayılan bir değer belirtir.

(Devralındığı yer: Parameter)
Direction

Nesnenin Parameter bir değeri bir denetime bağlamak için kullanılıp kullanılmadığını veya denetimin değeri değiştirmek için kullanılıp kullanılamayacağını gösterir.

(Devralındığı yer: Parameter)
FormField

Parametrenin bağlanacağı form değişkeninin adını alır veya ayarlar.

IsTrackingViewState

Nesnenin Parameter görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır.

(Devralındığı yer: Parameter)
Name

Parametresinin adını alır veya ayarlar.

(Devralındığı yer: Parameter)
Size

Parametresinin boyutunu alır veya ayarlar.

(Devralındığı yer: Parameter)
Type

Parametresinin türünü alır veya ayarlar.

(Devralındığı yer: Parameter)
ValidateInput

parametresindeki istemci girişinin doğrulanıp doğrulanmadığını belirten bir değer alır veya ayarlar.

ViewState

Aynı sayfa için birden çok istekte bir nesnenin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum Parameter bilgileri sözlüğü alır.

(Devralındığı yer: Parameter)

Yöntemler

Clone()

Geçerli FormParameter örneğin bir kopyasını döndürür.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
Evaluate(HttpContext, Control)

Nesnesini güncelleştirir ve değerini FormParameter döndürür.

GetDatabaseType()

DbType Geçerli Parameter örneğin CLR türüne eşdeğer değeri alır.

(Devralındığı yer: Parameter)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
LoadViewState(Object)

Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler.

(Devralındığı yer: Parameter)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnParameterChanged()

OnParametersChanged(EventArgs) nesnesini içeren Parameter koleksiyonun ParameterCollection yöntemini çağırır.

(Devralındığı yer: Parameter)
SaveViewState()

Sayfa sunucuya geri gönderildiğinden Parameter beri nesnenin görünüm durumundaki değişiklikleri kaydeder.

(Devralındığı yer: Parameter)
SetDirty()

Parameter Durumu görünüm durumunda kaydedilecek şekilde nesneyi işaretler.

(Devralındığı yer: Parameter)
ToString()

Bu örneğinin değerini eşdeğer dize gösterimine dönüştürür.

(Devralındığı yer: Parameter)
TrackViewState()

Nesnenin görünüm durumundaki Parameter değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState nesnesinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir.

(Devralındığı yer: Parameter)

Belirtik Arabirim Kullanımları

ICloneable.Clone()

Geçerli Parameter örneğin bir kopyasını döndürür.

(Devralındığı yer: Parameter)
IStateManager.IsTrackingViewState

Nesnenin Parameter görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır.

(Devralındığı yer: Parameter)
IStateManager.LoadViewState(Object)

Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler.

(Devralındığı yer: Parameter)
IStateManager.SaveViewState()

Sayfa sunucuya geri gönderildiğinden Parameter beri nesnenin görünüm durumundaki değişiklikleri kaydeder.

(Devralındığı yer: Parameter)
IStateManager.TrackViewState()

Nesnenin görünüm durumundaki Parameter değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState nesnesinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir.

(Devralındığı yer: Parameter)

Şunlara uygulanır

Ayrıca bkz.