ParameterCollection Klass

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Representerar en samling Parameter och Parameter-härledda objekt som används av datakällans kontroller i avancerade databindningsscenarier.

public ref class ParameterCollection : System::Web::UI::StateManagedCollection
public class ParameterCollection : System.Web.UI.StateManagedCollection
type ParameterCollection = class
    inherit StateManagedCollection
Public Class ParameterCollection
Inherits StateManagedCollection
Arv
Object
StateManagedCollection
ParameterCollection

Exempel

Följande kodexempel visar hur du använder en AccessDataSource-kontroll och en FormParameter för att visa information från en Microsoft Access databas i en GridView kontroll. Objektet FormParameter läggs till i SelectParameters samlingen med hjälp av Add metoden .

Important

Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.

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

Kommentarer

Klassen ParameterCollection representerar en samling Parameter objekt som används i avancerade databindningsscenarier med datakällans kontroller. Objekten Parameter används för att binda värdena som finns i lokala Page variabler, HTTP-cookies, sessionsvariabler och andra kontrollers värden till datakällans kontroller när du hämtar, uppdaterar, tar bort och infogar data.

ParameterCollection Använd klassen för att programmatiskt hantera en uppsättning Parameter objekt. Du kan lägga till, infoga och ta bort Parameter objekt med lämpliga metoder för ParameterCollection klassen. Använd någon av följande metoder för att programmatiskt hämta Parameter objekt från en samling:

  • Använd indexeraren för att hämta ett enda Parameter objekt från samlingen, efter namn eller med matris notation.

  • GetEnumerator Använd metoden för att skapa ett System.Collections.IEnumerator-implementerat objekt som sedan kan användas för att hämta objekt från samlingen.

Egenskapen Count anger det totala antalet objekt i samlingen och används för att fastställa samlingens övre gräns. Du kan lägga till och ta bort objekt från samlingen med hjälp Addav metoderna , Insert, Removeoch RemoveAt .

Beroende på implementeringen och semantiken för en viss datakällakontroll kan det vara viktigt i vilken ordning parametrarna lagras i ParameterCollection samlingen. När du till exempel använder SqlDataSource kontrollen som en ODBC-datakälla måste ordningen på objekten ParameterParameterCollection i samlingen vara samma som ordningen på parametrarna i de parametriserade SQL-frågor som du använder. Men när du använder kontrollen SqlDataSource med Microsoft SQL Server är ordningen på objekten Parameter inte viktiga.

Important

När du använder datakällkontroller infogas värden i kommandoparametrar utan validering, vilket är ett potentiellt säkerhetshot. Använd en händelse i datakällkontrollen för att verifiera parametervärden innan kommandot körs. Mer information finns i Översikt över skriptexploateringar.

I följande tabell visas de olika parameterklasserna och hur de används.

Parameterklass Description
Parameter Basparameterklassen. Använd den för att binda till en lokal variabel eller en statisk sträng med hjälp av DefaultValue egenskapen .
ControlParameter En parameter som kan användas för att binda till en kontrolls egenskap eller metodreturvärde.
CookieParameter En parameter som kan användas för att binda till värdet för en cookie.
FormParameter En parameter som kan användas för att binda till ett attribut för den aktuella webbformulärsidan.
QueryStringParameter En parameter som kan användas för att binda till ett värde som skickas till en webbformulärsida i en frågesträng.
SessionParameter En parameter som kan användas för att binda till värdet för en sessionsvariabel.
ProfileParameter En parameter som kan användas för att binda till värdet för en ASP.NET Profile-egenskap.

Konstruktorer

Name Description
ParameterCollection()

Initierar klassen för användning av en ärvd klassinstans. Den här konstruktorn kan bara anropas av en ärvd klass.

Egenskaper

Name Description
Count

Hämtar antalet element som finns i StateManagedCollection samlingen.

(Ärvd från StateManagedCollection)
Item[Int32]

Hämtar eller anger objektet Parameter vid det angivna indexet i samlingen.
Item[String]

Hämtar eller anger objektet Parameter med det angivna namnet i samlingen.

Metoder

Name Description
Add(Parameter)

Lägger till det angivna Parameter objektet i slutet av samlingen.
Add(String, DbType, String)

Skapar ett Parameter objekt med det angivna namnet, databastypen och standardvärdet och lägger till det i slutet av samlingen.
Add(String, String)

Skapar ett Parameter objekt med det angivna namnet och standardvärdet och lägger till det i slutet av samlingen.
Add(String, TypeCode, String)

Skapar ett Parameter objekt med det angivna namnet , TypeCodeoch standardvärdet och lägger till det i slutet av samlingen.
Clear()

Tar bort alla objekt från StateManagedCollection samlingen.

(Ärvd från StateManagedCollection)
Contains(Parameter)

Avgör om samlingen ParameterCollection innehåller ett specifikt värde.
CopyTo(Array, Int32)

Kopierar elementen i StateManagedCollection samlingen till en matris med början vid ett visst matrisindex.

(Ärvd från StateManagedCollection)
CopyTo(Parameter[], Int32)

Kopierar ett angivet index för en parametermatris till parametersamlingen.
CreateKnownType(Int32)

Skapar en instans av ett standardobjekt Parameter .
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetEnumerator()

Returnerar en iterator som itererar genom StateManagedCollection samlingen.

(Ärvd från StateManagedCollection)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetKnownTypes()

Hämtar en matris med Parameter typer som ParameterCollection samlingen kan innehålla.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
GetValues(HttpContext, Control)

Hämtar en ordnad samling Parameter objektnamn och deras motsvarande värden som för närvarande finns i samlingen.
IndexOf(Parameter)

Avgör indexet för ett angivet Parameter objekt i ParameterCollection samlingen.
Insert(Int32, Parameter)

Infogar det angivna Parameter objektet i ParameterCollection samlingen vid det angivna indexet.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnClear()

När du åsidosättas i en härledd klass utför du ytterligare arbete innan Clear() metoden tar bort alla objekt från samlingen.

(Ärvd från StateManagedCollection)
OnClearComplete()

Utför ytterligare anpassade processer efter att innehållet i samlingen har rensats.
OnInsert(Int32, Object)

Inträffar innan Insert(Int32, Parameter) metoden anropas.
OnInsertComplete(Int32, Object)

Inträffar när Insert(Int32, Parameter) metoden har slutförts.
OnParametersChanged(EventArgs)

Genererar händelsen ParametersChanged .
OnRemove(Int32, Object)

När det åsidosättas i en härledd klass utför du ytterligare arbete innan IList.Remove(Object) metoden eller IList.RemoveAt(Int32) tar bort det angivna objektet från samlingen.

(Ärvd från StateManagedCollection)
OnRemoveComplete(Int32, Object)

Inträffar när Remove(Parameter) metoden har slutförts.
OnValidate(Object)

Utför ytterligare anpassade processer när du verifierar ett värde.
Remove(Parameter)

Tar bort det angivna Parameter objektet från ParameterCollection samlingen.
RemoveAt(Int32)

Tar Parameter bort objektet vid det angivna indexet ParameterCollection från samlingen.
SetDirty()

Tvingar hela StateManagedCollection samlingen att serialiseras i visningstillstånd.

(Ärvd från StateManagedCollection)
SetDirtyObject(Object)

Markerar det angivna Parameter objektet som ändrat sedan den senaste inläsningen eller spara från visningstillståndet.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
UpdateValues(HttpContext, Control)

Itererar genom objekten Parameter som ingår i samlingen och anropar Evaluate metoden på var och en.

Händelser

Name Description
ParametersChanged

Inträffar när ett eller flera Parameter objekt som ingår i samlingen ändrar tillstånd.

Explicita gränssnittsimplementeringar

Name Description
ICollection.Count

Hämtar antalet element som finns i StateManagedCollection samlingen.

(Ärvd från StateManagedCollection)
ICollection.IsSynchronized

Hämtar ett värde som anger om StateManagedCollection samlingen är synkroniserad (trådsäker). Den här metoden returnerar false i alla fall.

(Ärvd från StateManagedCollection)
ICollection.SyncRoot

Hämtar ett objekt som kan användas för att synkronisera åtkomsten StateManagedCollection till samlingen. Den här metoden returnerar null i alla fall.

(Ärvd från StateManagedCollection)
IEnumerable.GetEnumerator()

Returnerar en iterator som itererar genom StateManagedCollection samlingen.

(Ärvd från StateManagedCollection)
IList.Add(Object)

Lägger till ett objekt i StateManagedCollection samlingen.

(Ärvd från StateManagedCollection)
IList.Clear()

Tar bort alla objekt från StateManagedCollection samlingen.

(Ärvd från StateManagedCollection)
IList.Contains(Object)

Avgör om samlingen StateManagedCollection innehåller ett specifikt värde.

(Ärvd från StateManagedCollection)
IList.IndexOf(Object)

Avgör indexet för ett angivet objekt i StateManagedCollection samlingen.

(Ärvd från StateManagedCollection)
IList.Insert(Int32, Object)

Infogar ett objekt i StateManagedCollection samlingen vid det angivna indexet.

(Ärvd från StateManagedCollection)
IList.IsFixedSize

Hämtar ett värde som anger om StateManagedCollection samlingen har en fast storlek. Den här metoden returnerar false i alla fall.

(Ärvd från StateManagedCollection)
IList.IsReadOnly

Hämtar ett värde som anger om StateManagedCollection samlingen är skrivskyddad.

(Ärvd från StateManagedCollection)
IList.Item[Int32]

Hämtar elementet IStateManager vid det angivna indexet.

(Ärvd från StateManagedCollection)
IList.Remove(Object)

Tar bort den första förekomsten av det angivna objektet från StateManagedCollection samlingen.

(Ärvd från StateManagedCollection)
IList.RemoveAt(Int32)

Tar bort elementet IStateManager vid det angivna indexet.

(Ärvd från StateManagedCollection)
IStateManager.IsTrackingViewState

Hämtar ett värde som anger om StateManagedCollection samlingen sparar ändringar i visningstillståndet.

(Ärvd från StateManagedCollection)
IStateManager.LoadViewState(Object)

Återställer det tidigare sparade visningstillståndet för StateManagedCollection samlingen och de objekt som den IStateManager innehåller.

(Ärvd från StateManagedCollection)
IStateManager.SaveViewState()

Sparar ändringarna i StateManagedCollection samlingen och varje IStateManager objekt som den innehåller sedan den tid då sidan publicerades tillbaka till servern.

(Ärvd från StateManagedCollection)
IStateManager.TrackViewState()

Orsakar samlingen StateManagedCollection och vart och ett av de objekt som den IStateManager innehåller för att spåra ändringar i deras visningstillstånd så att de kan sparas mellan begäranden för samma sida.

(Ärvd från StateManagedCollection)

Tilläggsmetoder

Name Description
AsParallel(IEnumerable)

Möjliggör parallellisering av en fråga.
AsQueryable(IEnumerable)

Konverterar en IEnumerable till en IQueryable.
Cast<TResult>(IEnumerable)

Omvandlar elementen i en IEnumerable till den angivna typen.
OfType<TResult>(IEnumerable)

Filtrerar elementen i en IEnumerable baserat på en angiven typ.

Gäller för

Se även