BoundField Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein Feld dar, das als Text in einem datengebundenen Steuerelement angezeigt wird.

public ref class BoundField : System::Web::UI::WebControls::DataControlField

public class BoundField : System.Web.UI.WebControls.DataControlField

type BoundField = class
    inherit DataControlField

Public Class BoundField
Inherits DataControlField

Vererbung: Object

DataControlField
BoundField

Abgeleitet: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe eines BoundField -Objekts die Werte eines Felds in einem GridView -Steuerelement anzeigen.


<%@ 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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Hinweise

Die BoundField -Klasse wird von datengebundenen Steuerelementen (z GridView . B. und DetailsView) verwendet, um den Wert eines Felds als Text anzuzeigen. Das BoundField Objekt wird je nach dem datengebundenen Steuerelement, in dem es verwendet wird, unterschiedlich angezeigt. Beispielsweise zeigt das GridView Steuerelement ein BoundField Objekt als Spalte an, während es vom DetailsView Steuerelement als Zeile angezeigt wird.

Um das feld anzugeben, das in einem BoundField -Objekt angezeigt werden soll, legen Sie die DataField -Eigenschaft auf den Namen des Felds fest. Der Wert des Felds kann HTML-codiert werden, bevor er angezeigt wird, indem die HtmlEncode -Eigenschaft auf truefestgelegt wird. Sie können eine benutzerdefinierte Formatierungszeichenfolge auf den Wert des Felds anwenden, indem Sie die DataFormatString -Eigenschaft festlegen. Wenn die HtmlEncode -Eigenschaft ist true, wird der codierte Zeichenfolgenwert des Felds in der benutzerdefinierten Formatzeichenfolge verwendet. Standardmäßig wird die Formatierungszeichenfolge nur auf Feldwerte angewendet, wenn sich das datengebundene Steuerelement im schreibgeschützten Modus befindet. Um die Formatierungszeichenfolge auf Werte anzuwenden, die angezeigt werden, während sich das datengebundene Steuerelement im Bearbeitungsmodus befindet, legen Sie die ApplyFormatInEditMode -Eigenschaft auf fest true. Wenn der Wert eines Felds NULL ist, können Sie eine benutzerdefinierte Beschriftung anzeigen, indem Sie die NullDisplayText -Eigenschaft festlegen. Das BoundField -Objekt kann auch leere Zeichenfolgen-Feldwerte ("") automatisch in NULL-Werte konvertieren, indem die ConvertEmptyStringToNull -Eigenschaft auf truefestgelegt wird.

Sie können ein BoundField Objekt in einem datengebundenen Steuerelement ausblenden, indem Sie die Visible -Eigenschaft auf falsefestlegen. Um zu verhindern, dass der Wert eines Felds im Bearbeitungsmodus geändert wird, legen Sie die ReadOnly -Eigenschaft auf fest true. In datengebundenen Steuerelementen, die das Einfügen von Datensätzen (z. B. das DetailsView -Steuerelement) unterstützen, können Sie ein BoundField Objekt ausblenden, indem Sie die InsertVisible -Eigenschaft auf falsefestlegen. Dies geschieht häufig, wenn Sie ein automatisch generiertes Schlüsselfeld im Einfügemodus ausblenden möchten.

Sie können die Kopf- und Fußzeilenabschnitte eines BoundField Objekts anpassen. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitte anzuzeigen, legen Sie die HeaderText oder FooterText Eigenschaften bzw. Anstatt Text im Kopfzeilenabschnitt anzuzeigen, können Sie ein Bild anzeigen, indem Sie die HeaderImageUrl -Eigenschaft festlegen. Der Headerabschnitt kann im BoundField -Objekt ausgeblendet werden, indem die ShowHeader -Eigenschaft auf falsefestgelegt wird.

Hinweis

Einige datengebundene Steuerelemente (z. B. das GridView -Steuerelement) können nur den gesamten Headerabschnitt des Steuerelements anzeigen oder ausblenden. Diese datengebundenen Steuerelemente unterstützen die ShowHeader -Eigenschaft für ein einzelnes gebundenes Feld nicht. Verwenden Sie die -Eigenschaft des Steuerelements, um den gesamten Headerabschnitt eines datengebundenen Steuerelements ShowHeader (falls verfügbar) ein- oder auszublenden.

Sie können auch die Darstellung des BoundField Objekts (Schriftfarbe, Hintergrundfarbe usw.) anpassen, indem Sie die Stileigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Stileigenschaften aufgeführt.

Style-Eigenschaft	BESCHREIBUNG
ControlStyle	Die Stileinstellungen für die untergeordneten Webserversteuerelemente des BoundField -Objekts.
FooterStyle	Die Stileinstellungen für den Fußzeilenabschnitt des BoundField Objekts.
HeaderStyle	Die Stileinstellungen für den Headerabschnitt des BoundField Objekts.
ItemStyle	Die Stileinstellungen für die Datenelemente im BoundField -Objekt.

Konstruktoren

BoundField()

Initialisiert eine neue Instanz der BoundField-Klasse.

Felder

ThisExpression

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht.

Stellt den Ausdruck „this“ dar.

Eigenschaften

AccessibleHeaderText	Ruft Text ab, der in einigen Steuerelementen als `AbbreviatedText`-Eigenschaftswert gerendert wird, oder legt diesen fest. (Geerbt von DataControlField)
ApplyFormatInEditMode	Ruft einen Wert ab, der anzeigt, ob die von der DataFormatString-Eigenschaft angegebene Formatierungszeichenfolge auf Feldwerte angewendet wird, wenn sich das datengebundene Steuerelement, das das BoundField-Objekt enthält, im Bearbeitungsmodus befindet, oder legt diesen fest.
Control	Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist. (Geerbt von DataControlField)
ControlStyle	Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab. (Geerbt von DataControlField)
ConvertEmptyStringToNull	Ruft einen Wert ab, der angibt, ob bei der Aktualisierung des Datenfelds in der Datenquelle Werte, die leere Zeichenfolgen ("") darstellen, in NULL-Werte konvertiert werden, oder legt diesen fest.
DataField	Ruft den Namen des Datenfelds ab, das an das BoundField-Objekt gebunden werden soll, oder legt diesen fest.
DataFormatString	Ruft die Zeichenfolge ab, die das Anzeigeformat für den Wert des Felds angibt, oder legt diese fest.
DesignMode	Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Geerbt von DataControlField)
FooterStyle	Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest. (Geerbt von DataControlField)
FooterText	Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest. (Geerbt von DataControlField)
HeaderImageUrl	Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest. (Geerbt von DataControlField)
HeaderStyle	Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest. (Geerbt von DataControlField)
HeaderText	Ruft den Text ab, der im Header eines Datensteuerelements angezeigt wird, oder legt diesen fest.
HtmlEncode	Ruft einen Wert ab, der angibt, ob die Feldwerte vor dem Anzeigen in einem BoundField-Objekt HTML-codiert werden.
HtmlEncodeFormatString	Ruft einen Wert ab, der angibt, ob durch Übernehmen der DataFormatString-Eigenschaft für den BoundField-Wert erstellter Text beim Anzeigen HTML-codiert werden soll, oder legt ihn fest.
InsertVisible	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von DataControlField)
ItemStyle	Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden. (Geerbt von DataControlField)
NullDisplayText	Ruft die Beschriftung ab, die für ein Feld angezeigt wird, wenn der Wert des Felds NULL ist, oder legt diesen fest.
ReadOnly	Ruft einen Wert ab, der angibt, ob der Feldwert im Bearbeitungsmodus geändert werden kann, oder legt diesen fest.
ShowHeader	Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest. (Geerbt von DataControlField)
SortExpression	Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest. (Geerbt von DataControlField)
SupportsHtmlEncode	Ruft einen Wert ab, der angibt, ob die HTML-Codierung von einem BoundField-Objekt unterstützt wird.
ValidateRequestMode	Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob das Steuerelement Clienteingaben überprüft.
ValidateRequestMode	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft. (Geerbt von DataControlField)
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von DataControlField)
Visible	Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest. (Geerbt von DataControlField)

Methoden

CloneField()	Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts. (Geerbt von DataControlField)
CopyProperties(DataControlField)	Kopiert die Eigenschaften des aktuellen BoundField-Objekts in das angegebene DataControlField-Objekt.
CreateField()	Erstellt ein leeres BoundField-Objekt.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Füllt das angegebene IDictionary-Objekt mit den Werten aus dem angegebenen TableCell-Objekt.
FormatDataValue(Object, Boolean)	Formatiert den angegebenen Feldwert für eine Zelle im BoundField-Objekt.
GetDesignTimeValue()	Ruft beim Rendern des BoundField-Objekts in einem Designer den für den Wert des Felds verwendeten Wert ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(Control)	Ruft den Wert des Felds ab, das an das BoundField-Objekt gebunden ist.
Initialize(Boolean, Control)	Initialisiert das BoundField-Objekt.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand.
LoadViewState(Object)	Stellt die zuvor gespeicherten Ansichtszustandsinformationen für das Feld wieder her.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnDataBindField(Object, EventArgs)	Bindet den Wert eines Felds an das BoundField-Objekt.
OnFieldChanged()	Löst das `FieldChanged`-Ereignis aus. (Geerbt von DataControlField)
SaveViewState()	Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde. (Geerbt von DataControlField)
ToString()	Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt. (Geerbt von DataControlField)
TrackViewState()	Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden. (Geerbt von DataControlField)
ValidateSupportsCallback()	Bestimmt, ob die in einem BoundField-Objekt enthaltenen Steuerelemente Rückrufe unterstützen.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest. (Geerbt von DataControlField)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von DataControlField)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her. (Geerbt von DataControlField)
IStateManager.SaveViewState()	Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde. (Geerbt von DataControlField)
IStateManager.TrackViewState()	Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden. (Geerbt von DataControlField)

Gilt für: