QueryStringParameter Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Ö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.

HTTP isteği sorgu dizesi alanının değerini parametre nesnesine bağlar.

public ref class QueryStringParameter : System::Web::UI::WebControls::Parameter

public class QueryStringParameter : System.Web.UI.WebControls.Parameter

type QueryStringParameter = class
    inherit Parameter

Public Class QueryStringParameter
Inherits Parameter

Devralma: Object

Parameter
QueryStringParameter

Örnekler

Aşağıdaki örnekte, bir GridView denetiminde veri görüntülerken filtre olarak kullanılacak bir QueryStringParameter nesnesinin nasıl oluşturulacağı gösterilmektedir. QueryStringParameter nesnesini AccessDataSource denetiminin FilterParameters koleksiyonuna eklersiniz. parametre nesnesi, country adlı sorgu dizesi alanının değerini FilterExpression dizesine bağlar. parametresi için hiçbir DefaultValue özelliği belirtilmediğinden, sorgu dizesiyle country adlı bir alan geçirilmezse, AccessDataSource denetimi NullReferenceException özel durumu oluşturur. country adlı bir alan geçirildiyse ancak değeri yoksa, GridView denetimi veri görüntülemez.

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>
    </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">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>

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

Açıklamalar

http isteği sorgu dizesinin parçası olarak geçirilen bir alanın değerini parametreli sorgu veya komutta kullanılan bir parametreye bağlamak için QueryStringParameter sınıfını kullanabilirsiniz. Alan QueryString koleksiyonundan alınır.

Parametreye veri bağlayan denetimler, bir QueryStringParameter nesnesine başvurulsa, ancak karşılık gelen sorgu dizesi adı/değer çifti geçirilmediyse bir özel durum oluşturabilir. Benzer şekilde, sorgu dizesi alan adı karşılık gelen bir değer olmadan geçirilirse veri görüntülemeyebilirler. Bu durumlardan kaçınmak için DefaultValue özelliğini uygun yerlerde ayarlayın.

QueryStringParameter sınıfı, bağlanacak sorgu dizesi değerinin adını tanımlayan QueryStringField özelliğini sağlar. Ayrıca Parameter sınıfından devralınan özellikleri de sağlar.

Önemli

QueryStringParameter sınıfı geçirilen değeri doğrulamaz; ham değeri sağlar. Ancak, veri kaynağı denetimindeki bir QueryStringParameter nesnesinin değerini doğrulayabilirsiniz. Bunu yapmak için veri kaynağı denetiminin Selecting, Updating, Insertingveya Deleting olayını işleyin ve olay işleyicisindeki parametre değerini denetleyin. parametresinin değeri doğrulama testlerini geçmezse, ilişkili CancelEventArgs sınıfının Cancel özelliğini trueolarak ayarlayarak veri işlemini iptal edebilirsiniz.

Oluşturucular

QueryStringParameter()	QueryStringParameter sınıfının adlandırılmamış yeni bir örneğini başlatır.
QueryStringParameter(QueryStringParameter)	`original` parametresi tarafından belirtilen örneğin değerlerini kullanarak QueryStringParameter sınıfının yeni bir örneğini başlatır.
QueryStringParameter(String, DbType, String)	Belirtilen sorgu dizesi alanını ve parametrenin veri türünü kullanarak QueryStringParameter sınıfının yeni bir adlandırılmış örneğini başlatır.
QueryStringParameter(String, String)	Hangi sorgu dizesi alanına bağlanacağını belirlemek için belirtilen dizeyi kullanarak QueryStringParameter sınıfının yeni bir adlandırılmış örneğini başlatır.
QueryStringParameter(String, TypeCode, String)	Hangi sorgu dizesi alanına bağlanacağını belirlemek için belirtilen dizeyi kullanarak QueryStringParameter sınıfının adlandırılmış ve kesin olarak türü belirtilmiş yeni bir örneğini başlatır.

Özellikler

ConvertEmptyStringToNull	Parameter nesnesinin bağlı olduğu değerin Emptyise `null` dönüştürülmesi 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	Evaluate(HttpContext, Control) yöntemi çağrıldığında 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	Parameter nesnesinin 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)
IsTrackingViewState	Parameter nesnesinin 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)
QueryStringField	Parametresinin bağlandığını sorgu dizesi alanının adını alır veya ayarlar.
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	Sorgu dizesi parametresinin değerinin doğrulanıp doğrulanmadığını alır veya ayarlar.
ViewState	Aynı sayfa için birden çok istekte bir Parameter nesnesinin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır. (Devralındığı yer: Parameter)

Yöntemler

Clone()	Geçerli QueryStringParameter örneğinin 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)	QueryStringParameter nesnesinin değerini güncelleştirir ve döndürür.
GetDatabaseType()	Geçerli Parameter örneğinin CLR türüne eşdeğer DbType değerini alır. (Devralındığı yer: Parameter)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type 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 Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnParameterChanged()	Parameter nesnesini içeren ParameterCollection koleksiyonunun OnParametersChanged(EventArgs) yöntemini çağırır. (Devralındığı yer: Parameter)
SaveViewState()	Sayfa sunucuya geri gönderildiğinden bu yana Parameter nesnesinin görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: Parameter)
SetDirty()	Parameter nesnesini, durumunun görünüm durumunda kaydedilecek şekilde işaretler. (Devralındığı yer: Parameter)
ToString()	Bu örneğin değerini eşdeğer dize gösterimine dönüştürür. (Devralındığı yer: Parameter)
TrackViewState()	Parameter nesnesinin, denetimin ViewState nesnesinde depolanabilmeleri ve aynı sayfaya yönelik istekler arasında kalıcı olabilmeleri için görünüm durumundaki değişiklikleri izlemesine neden olur. (Devralındığı yer: Parameter)

Belirtik Arabirim Kullanımları

ICloneable.Clone()	Geçerli Parameter örneğinin bir kopyasını döndürür. (Devralındığı yer: Parameter)
IStateManager.IsTrackingViewState	Parameter nesnesinin 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 bu yana Parameter nesnesinin görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: Parameter)
IStateManager.TrackViewState()	Parameter nesnesinin, denetimin ViewState nesnesinde depolanabilmeleri ve aynı sayfaya yönelik istekler arasında kalıcı olabilmeleri için görünüm durumundaki değişiklikleri izlemesine neden olur. (Devralındığı yer: Parameter)

Şunlara uygulanır

Aracılığıyla paylaş