DataKey Klass

Definition

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

Representerar primärnyckelfältet eller fälten för en post i en databunden kontroll.

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
Arv
Object
DataKey
Implementeringar
IStateManager IEquatable<DataKey>

Exempel

Följande kodexempel visar hur du fastställer primärnyckelvärdet för en post i en DetailsView kontroll med hjälp Value av egenskapen för ett DataKey objekt.


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

Kommentarer

Klassen DataKey används för att representera den primära nyckeln för en post i en databunden kontroll. Den primära nyckeln för en post kan bestå av ett av flera fält från datakällan. DataKey Även om klassen inte är en samling kan den lagra flera nyckelfältvärden. Nyckelfältvärdena fylls i när en av konstruktorerna DataKey för klassen anropas. Du kan hämta ett nyckelfältvärde från ett DataKey objekt på följande sätt:

  • Använd egenskapen DataKey.Item[Int32] för att hämta ett nyckelfältvärde vid ett specifikt index i DataKey objektet.

  • Använd egenskapen DataKey.Item[String] för att hämta ett nyckelfältvärde för ett visst fält.

  • Använd egenskapen Value för att hämta värdet för nyckelfältet vid index 0 i DataKey objektet. Den här egenskapen används ofta som en genväg för att hämta nyckelvärdet för en post när primärnyckeln bara innehåller ett fält.

  • Använd egenskapen Values för att skapa ett IOrderedDictionary objekt som kan användas för att iterera genom nyckelfältvärdena.

I allmänhet DataKey genereras objekt automatiskt av databundna kontroller när kontrollens DataKeyNames egenskap anges. Objekten DataKey innehåller värdena för nyckelfältet eller fälten som anges i DataKeyNames egenskapen. Databundna kontroller som visar en enskild post i taget (till exempel DetailsView eller ) lagrar DataKey vanligtvis objektet för den aktuella posten som visas i DataKeyFormViewkontrollens egenskap. Databundna kontroller som visar flera poster åt gången (till exempel GridView) lagrar vanligtvis objekten DataKey för varje post i kontrollen i en DataKeyArray samling. Samlingen DataKeyArray lagras sedan i DataKeys kontrollens egenskap.

Konstruktorer

Name Description
DataKey(IOrderedDictionary, String[])

Initierar en ny instans av DataKey klassen med den angivna ordlistan med nyckelfältvärden och matris med fältnamn.
DataKey(IOrderedDictionary)

Initierar en ny instans av DataKey klassen med den angivna ordlistan med nyckelfältvärden.

Egenskaper

Name Description
IsTrackingViewState

Hämtar ett värde som anger om DataKey objektet spårar ändringar i visningstillståndet.
Item[Int32]

Hämtar värdet för nyckelfältet vid det angivna indexet från ett DataKey objekt.
Item[String]

Hämtar värdet för nyckelfältet med det angivna fältnamnet från ett DataKey objekt.
Value

Hämtar värdet för nyckelfältet vid index 0 i DataKey objektet.
Values

Hämtar ett IOrderedDictionary objekt som innehåller varje nyckelfält i DataKey objektet.

Metoder

Name Description
Equals(DataKey)

Avgör om den angivna DataKey matrisen är lika med den aktuella datanyckeln.
Equals(Object)

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

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
LoadViewState(Object)

Läser in objektets tidigare sparade vytillstånd DataKey .
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
SaveViewState()

Sparar objektets aktuella vytillstånd DataKey .
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TrackViewState()

Markerar den startpunkt där du kan börja spåra och spara ändringar i visningstillståndet för DataKey objektet.

Explicita gränssnittsimplementeringar

Name Description
IStateManager.IsTrackingViewState

Hämtar ett värde som anger om DataKey objektet spårar ändringar i visningstillståndet.
IStateManager.LoadViewState(Object)

Läser in objektets tidigare sparade vytillstånd DataKey .
IStateManager.SaveViewState()

Sparar objektets aktuella vytillstånd DataKey .
IStateManager.TrackViewState()

Markerar den startpunkt där du kan börja spåra och spara ändringar i visningstillståndet för DataKey objektet.

Gäller för

Se även