BoundField Klasse

Definition

Stellt ein Feld dar, das als Text in einem datengebundenen Steuerelement angezeigt wird.Represents a field that is displayed as text in a data-bound control.

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
Abgeleitet

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein-Objekt verwendet wird BoundField , um die Werte eines-Felds in einem-Steuerelement anzuzeigen GridView .The following code example demonstrates how to use a BoundField object to display the values of a field in a GridView control.


<%@ 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 Daten gebundenen Steuerelementen (z. b. GridView und DetailsView ) verwendet, um den Wert eines Felds als Text anzuzeigen.The BoundField class is used by data-bound controls (such as GridView and DetailsView) to display the value of a field as text. Das BoundField Objekt wird unterschiedlich angezeigt, je nach dem Daten gebundenen Steuerelement, in dem es verwendet wird.The BoundField object is displayed differently depending on the data-bound control in which it is used. Das-Steuerelement GridView zeigt z. b. ein- BoundField Objekt als Spalte an, während das- DetailsView Steuerelement es als Zeile anzeigt.For example, the GridView control displays a BoundField object as a column, while the DetailsView control displays it as a row.

Um das Feld anzugeben, das in einem- BoundField Objekt angezeigt werden soll, legen DataField Sie die-Eigenschaft auf den Namen des Felds fest.To specify the field to display in a BoundField object, set the DataField property to the field's name. Der Wert des Felds kann HTML-codiert werden, bevor er angezeigt wird, indem die-Eigenschaft auf festgelegt wird HtmlEncode true .The field's value can be HTML-encoded before it is displayed by setting the HtmlEncode property to true. Sie können eine benutzerdefinierte Formatierungs Zeichenfolge auf den Wert des Felds anwenden, indem Sie die- DataFormatString Eigenschaft festlegen.You can apply a custom formatting string to the field's value by setting the DataFormatString property. Wenn die- HtmlEncode Eigenschaft ist true , wird der codierte Zeichen folgen Wert des Felds in der benutzerdefinierten Format Zeichenfolge verwendet.When the HtmlEncode property is true, the encoded string value of the field is used in the custom format string. Standardmäßig wird die Formatierungs Zeichenfolge nur dann auf Feldwerte angewendet, wenn sich das Daten gebundene Steuerelement im schreibgeschützten Modus befindet.By default, the formatting string is applied to field values only when the data-bound control is in read-only mode. Legen Sie die-Eigenschaft auf fest, um die Formatierungs Zeichenfolge auf die angezeigten Werte anzuwenden, während sich das Daten gebundene Steuerelement im Bearbeitungsmodus befindet ApplyFormatInEditMode true .To apply the formatting string to values displayed while the data-bound control is in edit mode, set the ApplyFormatInEditMode property to true. Wenn der Wert eines Felds NULL ist, können Sie eine benutzerdefinierte Beschriftung anzeigen, indem Sie die- NullDisplayText Eigenschaft festlegen.If a field's value is null, you can display a custom caption by setting the NullDisplayText property. Das BoundField Objekt kann auch leere Zeichen folgen ("")-Feldwerte automatisch in NULL-Werte konvertieren, indem die-Eigenschaft auf festgelegt wird ConvertEmptyStringToNull true .The BoundField object can also automatically convert empty string ("") field values to null values by setting the ConvertEmptyStringToNull property to true.

Sie können ein- BoundField Objekt in einem Daten gebundenen Steuerelement ausblenden, indem Sie die- Visible Eigenschaft auf festlegen false .You can hide a BoundField object in a data-bound control by setting the Visible property to false. Legen Sie die-Eigenschaft auf fest, um zu verhindern, dass der Wert eines Felds im Bearbeitungsmodus geändert wird ReadOnly true .To prevent the value of a field from being modified in edit mode, set the ReadOnly property to true. Wenn Sie Daten gebundene Steuerelemente einfügen (z. b. das- DetailsView Steuerelement), können Sie ein-Objekt ausblenden, BoundField indem Sie die- InsertVisible Eigenschaft auf festlegen false .In data-bound controls that support inserting records (such as the DetailsView control), you can hide a BoundField object by setting the InsertVisible property to false. Dies geschieht in der Regel, wenn Sie ein automatisch generiertes Schlüsselfeld im Einfügemodus ausblenden möchten.This is commonly done when you want to hide an automatically generated key field in insert mode.

Sie können die Kopf-und Fußzeilen Abschnitte eines- BoundField Objekts anpassen.You can customize the header and footer sections of a BoundField object. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitte anzuzeigen, legen Sie die HeaderText oder FooterText Eigenschaften bzw.To display a caption in the header or footer sections, set the HeaderText or FooterText properties, respectively. Anstatt Text im Header Abschnitt anzuzeigen, können Sie ein Bild anzeigen, indem Sie die- HeaderImageUrl Eigenschaft festlegen.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. Der Header Abschnitt kann im-Objekt ausgeblendet werden BoundField , indem die-Eigenschaft auf festgelegt wird ShowHeader false .The header section can be hidden in the BoundField object by setting the ShowHeader property to false.

Hinweis

Einige Daten gebundene Steuerelemente (z. b. das- GridView Steuerelement) können nur den gesamten Header Abschnitt des Steuer Elements anzeigen oder ausblenden.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Diese Daten gebundenen Steuerelemente unterstützen die- ShowHeader Eigenschaft für ein einzelnes gebundenes Feld nicht.These data-bound controls do not support the ShowHeader property for an individual bound field. Verwenden Sie die-Eigenschaft des-Steuer Elements, um den gesamten Header Abschnitt eines Daten gebundenen Steuer Elements (falls verfügbar) anzuzeigen oder auszublenden ShowHeader .To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

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.You also can customize the appearance of the BoundField object (font color, background color, and so on) by setting the style properties for the different parts of the field. In der folgenden Tabelle werden die verschiedenen Stileigenschaften aufgelistet.The following table lists the different style properties.

Style-EigenschaftStyle property BESCHREIBUNGDescription
ControlStyle Die Stileinstellungen für die untergeordneten Webserver-Steuerelemente des- BoundField Objekts.The style settings for the child Web server controls of the BoundField object.
FooterStyle Die Stileinstellungen für den Footerbereich des- BoundField Objekts.The style settings for the footer section of the BoundField object.
HeaderStyle Die Stileinstellungen für den Header Abschnitt des- BoundField Objekts.The style settings for the header section of the BoundField object.
ItemStyle Die Stileinstellungen für die Datenelemente im- BoundField Objekt.The style settings for the data items in the BoundField object.

Konstruktoren

BoundField()

Initialisiert eine neue Instanz der BoundField-Klasse.Initializes a new instance of the BoundField class.

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.Represents the "this" expression.

Eigenschaften

AccessibleHeaderText

Ruft Text ab, der in einigen Steuerelementen als AbbreviatedText-Eigenschaftswert gerendert wird, oder legt diesen fest.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(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.Gets or sets a value indicating whether the formatting string specified by the DataFormatString property is applied to field values when the data-bound control that contains the BoundField object is in edit mode.

Control

Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist.Gets a reference to the data control that the DataControlField object is associated with.

(Geerbt von DataControlField)
ControlStyle

Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab.Gets the style of any Web server controls contained by the DataControlField object.

(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.Gets or sets a value indicating whether empty string values ("") are automatically converted to null values when the data field is updated in the data source.

DataField

Ruft den Namen des Datenfelds ab, das an das BoundField-Objekt gebunden werden soll, oder legt diesen fest.Gets or sets the name of the data field to bind to the BoundField object.

DataFormatString

Ruft die Zeichenfolge ab, die das Anzeigeformat für den Wert des Felds angibt, oder legt diese fest.Gets or sets the string that specifies the display format for the value of the field.

DesignMode

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Geerbt von DataControlField)
FooterStyle

Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the footer of the data control field.

(Geerbt von DataControlField)
FooterText

Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.Gets or sets the text that is displayed in the footer item of a data control field.

(Geerbt von DataControlField)
HeaderImageUrl

Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Geerbt von DataControlField)
HeaderStyle

Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the header of the data control field.

(Geerbt von DataControlField)
HeaderText

Ruft den Text ab, der im Header eines Datensteuerelements angezeigt wird, oder legt diesen fest.Gets or sets the text that is displayed in the header of a data control.

HtmlEncode

Ruft einen Wert ab, der angibt, ob die Feldwerte vor dem Anzeigen in einem BoundField-Objekt HTML-codiert werden.Gets or sets a value indicating whether field values are HTML-encoded before they are displayed in a BoundField object.

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.Gets or sets a value that indicates whether text that is created by applying the DataFormatString property to the BoundField value should be HTML encoded when it is displayed.

InsertVisible

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Geerbt von DataControlField)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Geerbt von DataControlField)
ItemStyle

Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden.Gets the style of any text-based content displayed by a data control field.

(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.Gets or sets the caption displayed for a field when the field's value is null.

ReadOnly

Ruft einen Wert ab, der angibt, ob der Feldwert im Bearbeitungsmodus geändert werden kann, oder legt diesen fest.Gets or sets a value indicating whether the value of the field can be modified in edit mode.

ShowHeader

Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest.Gets or sets a value indicating whether the header item of a data control field is rendered.

(Geerbt von DataControlField)
SortExpression

Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest.Gets or sets a sort expression that is used by a data source control to sort data.

(Geerbt von DataControlField)
SupportsHtmlEncode

Ruft einen Wert ab, der angibt, ob die HTML-Codierung von einem BoundField-Objekt unterstützt wird.Gets a value indicating whether HTML encoding is supported by a BoundField object.

ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob das Steuerelement Clienteingaben überprüft.Gets or sets a value that determines whether the control validates client input or not.

ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft.Gets or sets a value that specifies whether the control validates client input.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Geerbt von DataControlField)
Visible

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest.Gets or sets a value indicating whether a data control field is rendered.

(Geerbt von DataControlField)

Methoden

CloneField()

Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts.Creates a duplicate copy of the current DataControlField-derived object.

(Geerbt von DataControlField)
CopyProperties(DataControlField)

Kopiert die Eigenschaften des aktuellen BoundField-Objekts in das angegebene DataControlField-Objekt.Copies the properties of the current BoundField object to the specified DataControlField object.

CreateField()

Erstellt ein leeres BoundField-Objekt.Creates an empty BoundField object.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Füllt das angegebene IDictionary-Objekt mit den Werten aus dem angegebenen TableCell-Objekt.Fills the specified IDictionary object with the values from the specified TableCell object.

FormatDataValue(Object, Boolean)

Formatiert den angegebenen Feldwert für eine Zelle im BoundField-Objekt.Formats the specified field value for a cell in the BoundField object.

GetDesignTimeValue()

Ruft beim Rendern des BoundField-Objekts in einem Designer den für den Wert des Felds verwendeten Wert ab.Retrieves the value used for a field's value when rendering the BoundField object in a designer.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(Control)

Ruft den Wert des Felds ab, das an das BoundField-Objekt gebunden ist.Retrieves the value of the field bound to the BoundField object.

Initialize(Boolean, Control)

Initialisiert das BoundField-Objekt.Initializes the BoundField object.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand.Initializes the specified TableCell object to the specified row state.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand.Initializes the specified TableCell object to the specified row state.

LoadViewState(Object)

Stellt die zuvor gespeicherten Ansichtszustandsinformationen für das Feld wieder her.Restores the previously stored view-state information for this field.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnDataBindField(Object, EventArgs)

Bindet den Wert eines Felds an das BoundField-Objekt.Binds the value of a field to the BoundField object.

OnFieldChanged()

Löst das FieldChanged-Ereignis aus.Raises the FieldChanged event.

(Geerbt von DataControlField)
SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Geerbt von DataControlField)
ToString()

Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt.Returns a string that represents this DataControlField object.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Geerbt von DataControlField)
ValidateSupportsCallback()

Bestimmt, ob die in einem BoundField-Objekt enthaltenen Steuerelemente Rückrufe unterstützen.Determines whether the controls contained in a BoundField object support callbacks.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest.Gets or sets the schema associated with this DataControlField object.

(Geerbt von DataControlField)
IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Geerbt von DataControlField)
IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her.Restores the data control field's previously saved view state.

(Geerbt von DataControlField)
IStateManager.SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Geerbt von DataControlField)

Gilt für:

Siehe auch