Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

BoundField-Klasse

.NET Framework 4.5

Andere Versionen

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

Vererbungshierarchie

System.Object
  System.Web.UI.WebControls.DataControlField
    System.Web.UI.WebControls.BoundField
      System.Web.UI.WebControls.AutoGeneratedField
      System.Web.UI.WebControls.CheckBoxField

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

C++

public class BoundField : DataControlField

Der BoundField-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	BoundField	Initialisiert eine neue Instanz der BoundField-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	AccessibleHeaderText	Ruft ab oder legt fest simsen, das als AbbreviatedText-Eigenschaftswert in einigen Steuerelementen gerendert wird. (Von DataControlField geerbt.)
	ApplyFormatInEditMode	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Formatierungszeichenfolge, die von der DataFormatString-Eigenschaft angegeben wird, auf Feldwerte angewendet wird, wenn sich das datengebundene Steuerelement, das das BoundField-Objekt enthält, im Bearbeitungsmodus befindet.
	Control	Ruft einen Verweis auf das Datensteuerelement ab, zu der das DataControlField-Objekt zugeordnet ist. (Von DataControlField geerbt.)
	ControlStyle	Ruft das Format aller Webserversteuerelemente ab, die vom DataControlField-Objekt enthalten sind. (Von DataControlField geerbt.)
	ConvertEmptyStringToNull	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob Werte, die leere Zeichenfolgen ("") darstellen, in NULL-Werte konvertiert werden, wenn der Aktualisierung des Datenfelds in der Datenquelle.
	DataField	Ruft den Namen des Datenfelds ab, die BoundField das Objekt gebunden werden soll.
	DataFormatString	Ruft ab oder legt die Zeichenfolge fest, die das Anzeigeformat für den Wert des Felds angibt.
	DesignMode	Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Von DataControlField geerbt.)
	FooterStyle	Ruft ab oder legt den Stil der Footerzeile des Datensteuerelement-Felds ab. (Von DataControlField geerbt.)
	FooterText	Ruft den Text ab oder legt den Text fest, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll. (Von DataControlField geerbt.)
	HeaderImageUrl	Ruft ab oder legt die URL eines Bildes ab, das im Headerelement eines Datensteuerelement-Felds angezeigt wird. (Von DataControlField geerbt.)
	HeaderStyle	Ruft das Symbol ab bzw. legt das Format des Headers des Datensteuerelement-Felds ab. (Von DataControlField geerbt.)
	HeaderText	Ruft den Text ab oder legt den Text fest, der im Header eines Datensteuerelements angezeigt wird. (Überschreibt DataControlField.HeaderText.)
	HtmlEncode	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob Feldwerte HTML-codiert werden, bevor sie in einem BoundField-Objekt angezeigt werden.
	HtmlEncodeFormatString	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob Text, der erstellt wird, indem anwendet DataFormatString-Eigenschaft auf den Wert BoundField HTML-codiert werden soll, wenn er angezeigt wird.
	InsertVisible	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt sichtbar ist, wenn sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet. (Von DataControlField geerbt.)
	IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Von DataControlField geerbt.)
	ItemStyle	Ruft das Format jeder textbasierten Inhalten ab, der durch ein Datensteuerelement-Feld angezeigt wird. (Von DataControlField geerbt.)
	NullDisplayText	Ruft die Beschriftung ab oder legt ihn fest, die für ein Feld angezeigt wird, wenn der Wert des Felds NULL ist.
	ReadOnly	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Wert des Felds im Bearbeitungsmodus geändert werden kann.
	ShowHeader	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Headerelement eines Datensteuerelement-Felds angezeigt wird. (Von DataControlField geerbt.)
	SortExpression	Ruft einen Wert ab oder legt einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest. (Von DataControlField geerbt.)
	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 Client Eingaben oder nicht überprüft.
	ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines speichern und DataControlField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg wiederherzustellen. (Von DataControlField geerbt.)
	Visible	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob ein Datensteuerelement-Feld dargestellt wird. (Von DataControlField geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	CloneField	Infrastruktur. Erstellt eine doppelte Kopie des aktuellen DataControlFieldabgeleitetes Objekt. (Von DataControlField geerbt.)
	CopyProperties	Kopiert die Eigenschaften des aktuellen BoundField-Objekts in das angegebene DataControlField-Objekt. (Überschreibt DataControlField.CopyProperties(DataControlField).)
	CreateField	Erstellt ein leeres BoundField-Objekt. (Überschreibt DataControlField.CreateField().)
	Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	ExtractValuesFromCell	Füllt das angegebene System.Collections.IDictionary-Objekt mit den Werten aus dem angegebenen TableCell-Objekt aus. (Überschreibt DataControlField.ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean).)
	Finalize	Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	FormatDataValue	Formatiert den angegebenen Feldwert für eine Zelle im BoundField-Objekt.
	GetDesignTimeValue	Ruft den Wert ab, der für den Wert des Felds verwendeten wenn das BoundField-Objekts in einem Designer verwendet werden soll.
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetValue	Ruft den Wert des Felds ab, das an das BoundField-Objekt gebunden ist.
	Initialize	Initialisiert das BoundField-Objekt. (Überschreibt DataControlField.Initialize(Boolean, Control).)
	InitializeCell	Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand. (Überschreibt DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).)
	InitializeDataCell	Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand.
	LoadViewState	Stellt den zuvor gespeicherten Informationen über den Ansichtszustand für dieses Feld wieder her. (Überschreibt DataControlField.LoadViewState(Object).)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	OnDataBindField	Bindet den Wert eines Felds an das BoundField-Objekt.
	OnFieldChanged	Löst das FieldChanged-Ereignis aus. (Von DataControlField geerbt.)
	SaveViewState	Speichert die Änderungen am Ansichtszustand DataControlField vorgenommen wurden, seit dem Zeitpunkt, zu dem die Seite an den Server zurückgesendet wurde. (Von DataControlField geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt. (Von DataControlField geerbt.)
	TrackViewState	Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Von DataControlField geerbt.)
	ValidateSupportsCallback	Bestimmt, ob die Steuerelemente, die in einem BoundField-Objekt enthalten sind, Rückrufe unterstützen. (Überschreibt DataControlField.ValidateSupportsCallback().)

Zum Seitenanfang

Felder

	Name	Beschreibung
	ThisExpression	Infrastruktur. Stellt den „this“ - Ausdruck dar.

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IDataSourceViewSchemaAccessor.DataSourceViewSchema	Infrastruktur. Ruft das Symbol ab bzw. legt das Schema fest, das diesem DataControlField-Objekt zugeordnet ist. (Von DataControlField geerbt.)
	IStateManager.IsTrackingViewState	Infrastruktur. Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Von DataControlField geerbt.)
	IStateManager.LoadViewState	Infrastruktur. Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her. (Von DataControlField geerbt.)
	IStateManager.SaveViewState	Infrastruktur. Speichert die Änderungen am Ansichtszustand DataControlField vorgenommen wurden, seit dem Zeitpunkt, zu dem die Seite an den Server zurückgesendet wurde. (Von DataControlField geerbt.)
	IStateManager.TrackViewState	Infrastruktur. Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Von DataControlField geerbt.)

Zum Seitenanfang

Hinweise

Die BoundField-Klasse wird von datengebundenen Steuerelementen (z. B. GridView und DetailsView) verwendet wird, um den Wert eines Felds als Text anzuzeigen. Im Gegensatz zu BoundField-Objekt wird in Abhängigkeit vom datengebundenen Steuerelement angezeigt, in dem es verwendet wird. Zum Beispiel wird das GridView-Steuerelement ein BoundField-Objekt als Spalte an, während das DetailsView-Steuerelement sie als Zeile angezeigt wird.

Um anzugeben, dass das Feld in einem BoundField-Objekt angezeigt werden soll, legen Sie die DataField-Eigenschaft auf den Feldnamen. Der Wert für das Feld HTML-codiert sein können, bevor sie angezeigt werden, indem Sie die HtmlEncode-Eigenschaft auf truefestlegt. Sie können eine benutzerdefinierte Formatzeichenfolge mit dem Wert des Felds anwenden, indem Sie die DataFormatString-Eigenschaft festlegen. Wenn die HtmlEncode-Eigenschaft trueist, wird der codierte Zeichenfolgenwert des Felds in der benutzerdefinierten Formatzeichenfolge verwendet. Standardmäßig wird die Formatierungszeichenfolge auf Feldwerte angewendet wird, wenn das datengebundene Steuerelement im schreibgeschützten Modus befindet. Um die Formatierungszeichenfolge auf den angezeigten Werten zu übernehmen während das datengebundene Steuerelement im Bearbeitungsmodus befindet, legen Sie die Eigenschaft auf trueApplyFormatInEditMode fest. Wenn der Wert des Felds NULL ist, können Sie eine benutzerdefinierte Beschriftung anzeigen, indem Sie die NullDisplayText-Eigenschaft festlegen. Das Objekt kann BoundField Feldwerte einer leeren Zeichenfolge ("") auch automatisch in NULL-Werte konvertiert werden, indem die Eigenschaft auf ConvertEmptyStringToNulltruefestlegt.

Sie können ein BoundField-Objekt in einem datengebundenen Steuerelement ausblenden, indem Sie die Visible-Eigenschaft auf falsefestlegen. Um den Wert eines Felds im Bearbeitungsmodus geändert werden soll, legen Sie die Eigenschaft auf trueReadOnly fest. In datengebundenen Steuerelementen, die zum Einfügen von Datensätzen unterstützen (z. B. das DetailsView-Steuerelement) können Sie ein Objekt BoundField ausblenden, indem Sie die InsertVisible-Eigenschaft auf falsefestlegen. Dies ist im Allgemeinen verwendet, wenn Sie ein automatisch generiertes Schlüsselfeld im Einfügemodus ausblenden möchten.

Sie können den Header und die Footerabschnitte eines BoundField-Objekts anpassen. Um eine Beschriftung im Header oder in den Footerabschnitten anzuzeigen, legen Sie die HeaderText oder FooterText-Eigenschaften fest. Anstatt Text im Headerbereich 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 falsefestlegt.

Hinweis
Einige datengebundene Steuerelemente (z. B. das GridView-Steuerelement) können nur den gesamten Headerbereich des Steuerelements anzeigen oder ausblenden. Diese datengebundenen Steuerelemente bieten keine Unterstützung für die ShowHeader-Eigenschaft für ein einzelnes gebundenes Feld. Um den gesamten Headerabschnitt eines datengebundenen Steuerelements anzuzeigen oder auszublenden (falls verfügbar), verwenden Sie die ShowHeader-Eigenschaft des Steuerelements.

Hinweis

Einige datengebundene Steuerelemente (z. B. das GridView-Steuerelement) können nur den gesamten Headerbereich des Steuerelements anzeigen oder ausblenden. Diese datengebundenen Steuerelemente bieten keine Unterstützung für die ShowHeader-Eigenschaft für ein einzelnes gebundenes Feld. Um den gesamten Headerabschnitt eines datengebundenen Steuerelements anzuzeigen oder auszublenden (falls verfügbar), verwenden Sie die ShowHeader-Eigenschaft des Steuerelements.

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

Formateigenschaft	Beschreibung
ControlStyle	Die Formateinstellungen für die untergeordneten Webserversteuerelemente des BoundField-Objekts.
FooterStyle	Die Stileinstellungen für den Fußzeilenbereich des BoundField-Objekts.
HeaderStyle	Die Stileinstellungen für den Headerbereich des BoundField-Objekts.
ItemStyle	Die Formateinstellungen für die Datenelemente in BoundField-Objekt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein BoundField-Objekt, mit dem die Werte eines Felds in einem GridView-Steuerelement anzuzeigen.



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

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN

Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?

Informationen zur Datensicherheit

BoundField-Klasse

.NET Framework

Referenz

Community-Beiträge