DataKey Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt het primaire-sleutelveld of de velden van een record in een gegevensgebonden besturingselement.

public ref class DataKey : System::Web::UI::IStateManager

public ref class DataKey : IEquatable<System::Web::UI::WebControls::DataKey ^>, System::Web::UI::IStateManager

public class DataKey : System.Web.UI.IStateManager

public class DataKey : IEquatable<System.Web.UI.WebControls.DataKey>, System.Web.UI.IStateManager

type DataKey = class
    interface IStateManager

type DataKey = class
    interface IStateManager
    interface IEquatable<DataKey>

Public Class DataKey
Implements IStateManager

Public Class DataKey
Implements IEquatable(Of DataKey), IStateManager

Overname: Object
DataKey

Implementeringen: IStateManager IEquatable<DataKey>

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de primaire-sleutelwaarde van een record in een DetailsView besturingselement bepaalt met behulp van de Value eigenschap van een DataKey object.


<%@ 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 CustomerDetailsView_DataBound(Object sender, EventArgs e)
  {
    // Get the DataKey object for the current record.
    DataKey key = CustomerDetailsView.DataKey;
    
    // Display the value of the key field.
    MessageLabel.Text = "The key field value for the displayed record is " + 
      key.Value.ToString() + ".";
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

  <head runat="server">
    <title>DataKey Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DataKey Example</h3>
                       
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          autogeneraterows="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          ondatabound="CustomerDetailsView_DataBound" 
          runat="server">
            
        </asp:detailsview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </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">

  Sub CustomerDetailsView_DataBound(ByVal sender As Object, ByVal e As EventArgs) Handles CustomerDetailsView.DataBound

    ' Get the DataKey object for the current record.
    Dim key As DataKey = CustomerDetailsView.DataKey
    
    ' Display the value of the key field.
    MessageLabel.Text = "The key field value for the displayed record is " & _
      key.Value.ToString() & "."
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

  <head runat="server">
    <title>DataKey Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DataKey Example</h3>
                       
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          autogeneraterows="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
            
        </asp:detailsview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Opmerkingen

De DataKey klasse wordt gebruikt om de primaire sleutel voor een record in een gegevensgebonden besturingselement weer te geven. De primaire sleutel voor een record kan bestaan uit een van de velden uit de gegevensbron. Hoewel de DataKey klasse geen verzameling is, kunnen er meerdere sleutelveldwaarden worden opgeslagen. De sleutelveldwaarden worden ingevuld wanneer een van de constructors voor de DataKey klasse wordt aangeroepen. U kunt op de volgende manieren een sleutelveldwaarde ophalen uit een DataKey object:

Gebruik de DataKey.Item[Int32] eigenschap om een sleutelveldwaarde op te halen bij een specifieke index in het DataKey object.
Gebruik de DataKey.Item[String] eigenschap om een sleutelveldwaarde van een specifiek veld op te halen.
Gebruik de Value eigenschap om de waarde van het sleutelveld op index 0 in het DataKey object op te halen. Deze eigenschap wordt vaak gebruikt als snelkoppeling om de sleutelwaarde van een record op te halen wanneer de primaire sleutel slechts één veld bevat.
Gebruik de Values eigenschap om een IOrderedDictionary object te maken dat kan worden gebruikt om de sleutelveldwaarden te doorlopen.

In het algemeen DataKey worden objecten automatisch gegenereerd door gegevensgebonden besturingselementen wanneer de eigenschap van DataKeyNames het besturingselement is ingesteld. De DataKey objecten bevatten de waarden van het sleutelveld of de velden die zijn opgegeven in de DataKeyNames eigenschap. Met gegevens gebonden besturingselementen waarmee één record tegelijk (zoals DetailsView of FormView) wordt weergegeven, wordt het DataKey object doorgaans opgeslagen voor de huidige record die wordt weergegeven in de DataKey eigenschap van het besturingselement. Met gegevens gebonden besturingselementen waarmee meerdere records tegelijk worden weergegeven (zoals GridView) worden de DataKey objecten meestal opgeslagen voor elke record in het besturingselement in een DataKeyArray verzameling. De DataKeyArray verzameling wordt vervolgens opgeslagen in de DataKeys eigenschap van het besturingselement.

Constructors

Name	Description
DataKey(IOrderedDictionary, String[])	Initialiseert een nieuw exemplaar van de DataKey klasse met behulp van de opgegeven woordenlijst met sleutelveldwaarden en matrix met veldnamen.
DataKey(IOrderedDictionary)	Initialiseert een nieuw exemplaar van de DataKey klasse met behulp van de opgegeven woordenlijst met sleutelveldwaarden.

Eigenschappen

Name	Description
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het object wijzigingen in de DataKey weergavestatus bijhoudt.
Item[Int32]	Haalt de waarde op van het sleutelveld op de opgegeven index van een DataKey object.
Item[String]	Hiermee haalt u de waarde van het sleutelveld op met de opgegeven veldnaam van een DataKey object.
Value	Hiermee haalt u de waarde van het sleutelveld op index 0 in het DataKey object op.
Values	Hiermee haalt u een IOrderedDictionary object op dat elk sleutelveld in het DataKey object bevat.

Methoden

Name	Description
Equals(DataKey)	Bepaalt of de opgegeven DataKey matrix gelijk is aan de huidige gegevenssleutel.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
LoadViewState(Object)	Laadt de eerder opgeslagen weergavestatus van het DataKey object.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
SaveViewState()	Hiermee wordt de huidige weergavestatus van het DataKey object opgeslagen.
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
TrackViewState()	Hiermee geeft u het beginpunt aan waarop u wijzigingen in de weergavestatus wilt bijhouden en opslaan in het DataKey object.

Expliciete interface-implementaties

Name	Description
IStateManager.IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het object wijzigingen in de DataKey weergavestatus bijhoudt.
IStateManager.LoadViewState(Object)	Laadt de eerder opgeslagen weergavestatus van het DataKey object.
IStateManager.SaveViewState()	Hiermee wordt de huidige weergavestatus van het DataKey object opgeslagen.
IStateManager.TrackViewState()	Hiermee geeft u het beginpunt aan waarop u wijzigingen in de weergavestatus wilt bijhouden en opslaan in het DataKey object.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?