QueryStringParameter Klass

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Binder värdet för ett frågesträngsfält för HTTP-begäran till ett parameterobjekt.

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

Arv: Object

Parameter
QueryStringParameter

Exempel

I följande exempel visas hur du skapar ett QueryStringParameter objekt som ska användas som filter när du visar data i en GridView kontroll. Du lägger till objektet QueryStringParameter i AccessDataSource kontrollens FilterParameters samling. Parameterobjektet binder värdet för frågesträngsfältet med namnet country till dess FilterExpression sträng. Eftersom ingen DefaultValue egenskap har angetts för parametern genereras ett country undantag om inget fält med namnet AccessDataSource skickas med frågesträngenNullReferenceException. Om ett fält med namnet country skickas men inte har något värde GridView , visar kontrollen inga data.

<%@ 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>

Kommentarer

Du kan använda QueryStringParameter klassen för att binda värdet för ett fält som skickas som en del av en HTTP-frågesträng för begäran till en parameter som används i en parameteriserad fråga eller ett kommando. Fältet hämtas från QueryString samlingen.

Kontroller som binder data till parametern kan utlösa ett undantag om ett QueryStringParameter objekt refereras, men inget motsvarande frågesträngsnamn/värdepar skickas. På samma sätt kanske de inte visar några data om frågesträngens fältnamn skickas utan motsvarande värde. För att undvika dessa situationer anger du egenskapen där det DefaultValue är lämpligt.

Klassen QueryStringParameter tillhandahåller egenskapen QueryStringField som identifierar namnet på frågesträngsvärdet som ska bindas till. Den innehåller också de egenskaper som ärvs från Parameter klassen.

Important

Klassen verifierar inte det värde som skickas. Det QueryStringParameter ger det råa värdet. Du kan dock verifiera värdet för ett QueryStringParameter objekt i en datakällskontroll. Det gör du genom att hantera Selectinghändelsen , Updating, Insertingeller Deleting för datakällans kontroll och kontrollera parametervärdet i händelsehanteraren. Om värdet för parametern inte klarar valideringstesterna kan du avbryta dataåtgärden genom att ange Cancel egenskapen för den associerade CancelEventArgs klassen till true.

Konstruktorer

Name	Description
QueryStringParameter()	Initierar en ny namnlös instans av QueryStringParameter klassen.
QueryStringParameter(QueryStringParameter)	Initierar en ny instans av QueryStringParameter klassen med hjälp av värdena för den instans som anges av parametern `original` .
QueryStringParameter(String, DbType, String)	Initierar en ny namngiven QueryStringParameter instans av klassen med det angivna frågesträngsfältet och parameterns datatyp.
QueryStringParameter(String, String)	Initierar en ny namngiven QueryStringParameter instans av klassen med hjälp av den angivna strängen för att identifiera vilket frågesträngsfält som ska bindas till.
QueryStringParameter(String, TypeCode, String)	Initierar en ny namngiven och starkt typinstans av klassen med hjälp av den angivna strängen QueryStringParameter för att identifiera vilket frågesträngsfält som ska bindas till.

Egenskaper

Name	Description
ConvertEmptyStringToNull	Hämtar eller anger ett värde som anger om värdet som objektet är bundet Parameter till ska konverteras till `null` om det är Empty. (Ärvd från Parameter)
DbType	Hämtar eller anger parameterns databastyp. (Ärvd från Parameter)
DefaultValue	Anger ett standardvärde för parametern om värdet som parametern är bunden till är onitialiserat när Evaluate(HttpContext, Control) metoden anropas. (Ärvd från Parameter)
Direction	Anger om objektet Parameter används för att binda ett värde till en kontroll eller om kontrollen kan användas för att ändra värdet. (Ärvd från Parameter)
IsTrackingViewState	Hämtar ett värde som anger om Parameter objektet sparar ändringar i visningstillståndet. (Ärvd från Parameter)
Name	Hämtar eller anger namnet på parametern. (Ärvd från Parameter)
QueryStringField	Hämtar eller anger namnet på frågesträngsfältet som parametern binder till.
Size	Hämtar eller anger parameterns storlek. (Ärvd från Parameter)
Type	Hämtar eller anger parametertypen. (Ärvd från Parameter)
ValidateInput	Hämtar eller anger om värdet för frågesträngsparametern verifieras eller inte.
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för ett Parameter objekt över flera begäranden för samma sida. (Ärvd från Parameter)

Metoder

Name	Description
Clone()	Returnerar en dubblett av den aktuella QueryStringParameter instansen.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
Evaluate(HttpContext, Control)	Uppdaterar och returnerar objektets QueryStringParameter värde.
GetDatabaseType()	Hämtar värdet DbType som motsvarar CLR-typen för den aktuella Parameter instansen. (Ärvd från Parameter)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
LoadViewState(Object)	Återställer datakällans tidigare sparade vytillstånd. (Ärvd från Parameter)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnParameterChanged()	Anropar metoden för OnParametersChanged(EventArgs) samlingen ParameterCollection som innehåller Parameter objektet. (Ärvd från Parameter)
SaveViewState()	Sparar ändringarna i Parameter objektets visningstillstånd sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från Parameter)
SetDirty()	Parameter Markerar objektet så att dess tillstånd registreras i visningstillstånd. (Ärvd från Parameter)
ToString()	Konverterar värdet för den här instansen till motsvarande strängrepresentation. (Ärvd från Parameter)
TrackViewState()	Parameter Gör att objektet spårar ändringar i dess visningstillstånd så att de kan lagras i kontrollens ViewState objekt och sparas mellan begäranden för samma sida. (Ärvd från Parameter)

Explicita gränssnittsimplementeringar

Name	Description
ICloneable.Clone()	Returnerar en dubblett av den aktuella Parameter instansen. (Ärvd från Parameter)
IStateManager.IsTrackingViewState	Hämtar ett värde som anger om Parameter objektet sparar ändringar i visningstillståndet. (Ärvd från Parameter)
IStateManager.LoadViewState(Object)	Återställer datakällans tidigare sparade vytillstånd. (Ärvd från Parameter)
IStateManager.SaveViewState()	Sparar ändringarna i Parameter objektets visningstillstånd sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från Parameter)
IStateManager.TrackViewState()	Parameter Gör att objektet spårar ändringar i dess visningstillstånd så att de kan lagras i kontrollens ViewState objekt och sparas mellan begäranden för samma sida. (Ärvd från Parameter)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?