TableDesigner Klasse
Definition
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.
Erweitert das Entwurfszeitverhalten für das Table Webserversteuerelement.
public ref class TableDesigner : System::Web::UI::Design::ControlDesignerpublic class TableDesigner : System.Web.UI.Design.ControlDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class TableDesigner : System.Web.UI.Design.ControlDesignertype TableDesigner = class
inherit ControlDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type TableDesigner = class
inherit ControlDesignerPublic Class TableDesigner
Inherits ControlDesigner- Vererbung
- Attribute
Beispiele
Der Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie eine Klasse von der TableDesigner Klasse abgeleitet wird. Im zweiten Codebeispiel wird veranschaulicht, wie die StyledTable Klasse zur Entwurfszeit angezeigt wird.
Im folgenden Codebeispiel wird veranschaulicht, wie eine Designerklasse namens StyledTableDesigner, die von der TableDesigner Klasse abgeleitet wird, erstellt wird und zum Anzeigen von zwei Zellen zur Entwurfszeit für eine von der Table Klasse abgeleitete Klasse verwendet wird.
' Create a class, named StyledTableDesigner,
' that derives from the TableDesigner class.
' This class displays a class named StyledTable
' at design time.
Public Class StyledTableDesigner
Inherits TableDesigner
' Override the GetDesignTimeHtml method to display
' placeholder text at design time for the
' rows and cells of the StyledTable class.
Public Overrides Function GetDesignTimeHtml() As String
Dim sTable As StyledTable = CType(Component, StyledTable)
Dim designTimeHTML As String
Dim rows As TableRowCollection = sTable.Rows
Dim cellsWithDummyContents As ArrayList = Nothing
Dim emptyTable As Boolean = rows.Count = 0
Dim emptyRows As Boolean = False
Dim counter As Integer = 1
Dim numcells As Integer = 2
Try
' Create two cells to display
' in a row at design time.
If emptyTable Then
Dim row As TableRow = New TableRow()
rows.Add(row)
Dim i As Integer
For i = 0 To numcells - 1
Dim c As TableCell = New TableCell()
c.Text = "Cell #" & counter.ToString()
counter += 1
rows(0).Cells.Add(c)
Next i
Else
emptyRows = True
Dim j As Integer
For j = 0 To rows.Count - 1
If rows(j).Cells.Count <> 0 Then
emptyRows = False
Exit For
End If
Next j
If emptyRows = True Then
Dim k As Integer
For k = 0 To numcells - 1
Dim c As TableCell = New TableCell()
c.Text = "Cell #" & counter.ToString()
counter += 1
rows(0).Cells.Add(c)
Next k
End If
End If
If emptyTable = False Then
' If the rows and cells were defined by the user, but the
' cells remain empty this code defines a string to display
' in them at design time.
Dim row As TableRow
For Each row In rows
Dim c As TableCell
For Each c In row.Cells
If ((c.Text.Length = 0) AndAlso (c.HasControls() = False)) Then
If cellsWithDummyContents Is Nothing Then
cellsWithDummyContents = New ArrayList()
End If
cellsWithDummyContents.Add(c)
c.Text = "Cell #" & counter.ToString()
counter += 1
End If
Next c
Next row
End If
' Retrieve the design-time HTML for the StyledTable class.
designTimeHTML = MyBase.GetDesignTimeHtml()
Finally
' If the StyledTable was empty before the dummy text was added,
' restore it to that state.
If emptyTable Then
rows.Clear()
Else
' Clear the cells that were empty before the dummy text
' was added.
If Not (cellsWithDummyContents Is Nothing) Then
Dim c As TableCell
For Each c In cellsWithDummyContents
c.Text = [String].Empty
Next c
End If
If emptyRows Then
rows(0).Cells.Clear()
End If
End If
End Try
Return designTimeHTML
End Function
End Class
Im folgenden Codebeispiel wird die DesignerAttribute Klasse der Klasse StyledTable zugeordnetStyledTableDesigner, sodass sie zur Entwurfszeit angezeigt werden kann.
' Create a class that uses the StyledTableDesigner
' class to display its contents at design time.
<Designer("Examples.AspNet.Design.StyledTableDesigner", "TableDesigner")> _
Public Class StyledTable
Inherits Table
Private tableStyle As Style = New Style()
Public Sub New()
tableStyle.BackColor = Color.LightBlue
tableStyle.BorderColor = Color.Black
CellSpacing = 4
CellPadding = 0
GridLines = GridLines.None
BorderWidth = Unit.Point(1)
Width = Unit.Percentage(100)
Height = Unit.Percentage(100)
End Sub
End Class
Konstruktoren
| Name | Beschreibung |
|---|---|
| TableDesigner() |
Initialisiert eine neue Instanz der TableDesigner-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ActionLists |
Ruft die Aktionslistenauflistung für den Steuerelement-Designer ab. (Geerbt von ControlDesigner) |
| AllowResize |
Ruft einen Wert ab, der angibt, ob die Größe des Steuerelements in der Entwurfszeitumgebung geändert werden kann. (Geerbt von ControlDesigner) |
| AssociatedComponents |
Ruft die Auflistung der Komponenten ab, die der vom Designer verwalteten Komponente zugeordnet sind. (Geerbt von ComponentDesigner) |
| AutoFormats |
Ruft die Auflistung vordefinierter automatischer Formatierungsschemas ab, die im Dialogfeld " AutoFormat " für das zugeordnete Steuerelement zur Entwurfszeit angezeigt werden sollen. (Geerbt von ControlDesigner) |
| Behavior |
Veraltet.
Ruft das DHTML-Verhalten ab, das dem Designer zugeordnet ist, oder legt dieses fest. (Geerbt von HtmlControlDesigner) |
| Component |
Ruft die Komponente ab, die dieser Designer entwerfen soll. (Geerbt von ComponentDesigner) |
| DataBindings |
Ruft die Datenbindungsauflistung für das aktuelle Steuerelement ab. (Geerbt von HtmlControlDesigner) |
| DataBindingsEnabled |
Ruft einen Wert ab, der angibt, ob die Datenbindung durch den enthaltenden Bereich für das zugeordnete Steuerelement unterstützt wird. (Geerbt von ControlDesigner) |
| DesignerState |
Ruft ein Objekt ab, das zum Speichern von Daten für das zugeordnete Steuerelement zur Entwurfszeit verwendet wird. (Geerbt von ControlDesigner) |
| DesignTimeElement |
Veraltet.
Ruft das Entwurfszeitobjekt ab, das das Steuerelement darstellt, das dem HtmlControlDesigner Objekt auf der Entwurfsoberfläche zugeordnet ist. (Geerbt von HtmlControlDesigner) |
| DesignTimeElementView |
Veraltet.
Ruft das Ansichtssteuerelement-Objekt für den Steuerelement-Designer ab. (Geerbt von ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Veraltet.
Ruft einen Wert ab, der angibt, ob der Entwurfshost das Laden beenden muss, bevor die GetDesignTimeHtml Methode aufgerufen werden kann. (Geerbt von ControlDesigner) |
| Expressions |
Ruft die Ausdrucksbindungen für das aktuelle Steuerelement zur Entwurfszeit ab. (Geerbt von HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Ruft einen Wert ab, der angibt, ob die Eigenschaften des zugeordneten Steuerelements ausgeblendet sind, wenn sich das Steuerelement im Vorlagenmodus befindet. (Geerbt von ControlDesigner) |
| ID |
Dient zum Abrufen oder Festlegen der ID-Zeichenfolge für das Steuerelement. (Geerbt von ControlDesigner) |
| InheritanceAttribute |
Ruft ein Attribut ab, das den Vererbungstyp der zugeordneten Komponente angibt. (Geerbt von ComponentDesigner) |
| Inherited |
Ruft einen Wert ab, der angibt, ob diese Komponente geerbt wird. (Geerbt von ComponentDesigner) |
| InTemplateMode |
Ruft einen Wert ab, der angibt, ob sich das Steuerelement entweder im Vorlagenanzeige- oder Bearbeitungsmodus im Entwurfshost befindet. Die InTemplateMode Eigenschaft ist schreibgeschützt. (Geerbt von ControlDesigner) |
| IsDirty |
Veraltet.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Webserversteuerelement als geändert markiert wurde. (Geerbt von ControlDesigner) |
| ParentComponent |
Ruft die übergeordnete Komponente für diesen Designer ab. (Geerbt von ComponentDesigner) |
| ReadOnly |
Veraltet.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Eigenschaften des Steuerelements zur Entwurfszeit schreibgeschützt sind. (Geerbt von ControlDesigner) |
| RootDesigner |
Ruft den Steuerelement-Designer für die Web Forms-Seite ab, die das zugeordnete Steuerelement enthält. (Geerbt von ControlDesigner) |
| ShadowProperties |
Ruft eine Auflistung von Eigenschaftswerten ab, die Benutzereinstellungen außer Kraft setzen. (Geerbt von ComponentDesigner) |
| ShouldCodeSerialize |
Veraltet.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine Felddeklaration für das Steuerelement in der CodeBehind-Datei für das aktuelle Entwurfsdokument während der Serialisierung erstellt werden soll. (Geerbt von HtmlControlDesigner) |
| Tag |
Ruft ein Objekt ab, das das HTML-Markupelement für das zugeordnete Steuerelement darstellt. (Geerbt von ControlDesigner) |
| TemplateGroups |
Ruft eine Auflistung von Vorlagengruppen ab, die jeweils eine oder mehrere Vorlagendefinitionen enthalten. (Geerbt von ControlDesigner) |
| UsePreviewControl |
Ruft einen Wert ab, der angibt, ob der Steuerelement-Designer ein temporäres Vorschausteuerelement verwendet, um das Entwurfszeit-HTML-Markup zu generieren. (Geerbt von ControlDesigner) |
| Verbs |
Ruft die Entwurfszeitverben ab, die von der Komponente unterstützt werden, die dem Designer zugeordnet ist. (Geerbt von ComponentDesigner) |
| ViewControl |
Dient zum Abrufen oder Festlegen eines Webserver-Steuerelements, das für die Vorschau des Entwurfszeit-HTML-Markups verwendet werden kann. (Geerbt von ControlDesigner) |
| ViewControlCreated |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein |
| Visible |
Ruft einen Wert ab, der angibt, ob das Steuerelement zur Entwurfszeit sichtbar ist. (Geerbt von ControlDesigner) |
Methoden
| Name | Beschreibung |
|---|---|
| CreateErrorDesignTimeHtml(String, Exception) |
Erstellt das HTML-Markup zum Anzeigen einer angegebenen Ausnahmefehlermeldung zur Entwurfszeit. (Geerbt von ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Erstellt HTML-Markup zum Anzeigen einer angegebenen Fehlermeldung zur Entwurfszeit. (Geerbt von ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Stellt eine einfache rechteckige Platzhalterdarstellung bereit, die den Typ und die ID des Steuerelements anzeigt. (Geerbt von ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Stellt eine einfache rechteckige Platzhalterdarstellung bereit, die den Typ und die ID des Steuerelements sowie zusätzliche angegebene Anweisungen oder Informationen anzeigt. (Geerbt von ControlDesigner) |
| CreateViewControl() |
Gibt eine Kopie des zugeordneten Steuerelements zum Anzeigen oder Rendern auf der Entwurfsoberfläche zurück. (Geerbt von ControlDesigner) |
| Dispose() |
Veröffentlicht alle ressourcen, die von der ComponentDesigner. (Geerbt von ComponentDesigner) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die HtmlControlDesigner vom Objekt verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von HtmlControlDesigner) |
| DoDefaultAction() |
Erstellt eine Methodensignatur in der Quellcodedatei für das Standardereignis in der Komponente und navigiert den Cursor des Benutzers zu diesem Speicherort. (Geerbt von ComponentDesigner) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetBounds() |
Ruft die Koordinaten des Rechtecks ab, die die Begrenzungen für das Steuerelement darstellen, wie auf der Entwurfsoberfläche angezeigt. (Geerbt von ControlDesigner) |
| GetDesignTimeHtml() |
Ruft den HTML-Code ab, der zum Darstellen des Steuerelements zur Entwurfszeit verwendet wird. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Ruft das HTML-Markup ab, um das Steuerelement anzuzeigen, und füllt die Auflistung mit den aktuellen Steuerelement-Designerbereichen auf. (Geerbt von ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Gibt den Inhalt für einen bearbeitbaren Bereich der Entwurfszeitansicht des zugeordneten Steuerelements zurück. (Geerbt von ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Ruft das HTML-Markup ab, um ein Webserversteuerelement zur Entwurfszeit darzustellen, das zur Laufzeit keine visuelle Darstellung hat. (Geerbt von ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Ruft das HTML-Markup ab, das Informationen zur angegebenen Ausnahme bereitstellt. (Geerbt von ControlDesigner) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetPersistenceContent() |
Ruft das permanente innere HTML-Markup des Steuerelements zur Entwurfszeit ab. (Geerbt von ControlDesigner) |
| GetPersistInnerHtml() |
Dieses Element überschreibt GetPersistInnerHtml(). |
| GetPersistInnerHtml() |
Veraltet.
Ruft das permanente interne HTML-Markup des Steuerelements ab. (Geerbt von ControlDesigner) |
| GetService(Type) |
Versucht, den angegebenen Diensttyp von der Entwurfsmoduswebsite der Komponente des Designers abzurufen. (Geerbt von ComponentDesigner) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetViewRendering() |
Ruft ein Objekt ab, das das Entwurfszeitmarkup für den Inhalt und die Bereiche des zugehörigen Steuerelements enthält. (Geerbt von ControlDesigner) |
| Initialize(IComponent) |
Initialisiert den Steuerelement-Designer und lädt die angegebene Komponente. (Geerbt von ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Initialisiert eine vorhandene Komponente erneut. (Geerbt von ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Initialisiert eine neu erstellte Komponente. (Geerbt von ComponentDesigner) |
| InitializeNonDefault() |
Veraltet.
Initialisiert die Einstellungen für eine importierte Komponente, die bereits in anderen Einstellungen als den Standardwerten initialisiert ist. (Geerbt von ComponentDesigner) |
| Invalidate() |
Deaktiviert den gesamten Bereich des Steuerelements, das auf der Entwurfsoberfläche angezeigt wird, und signalisiert dem Steuerelement-Designer, das Steuerelement neu zu zeichnen. (Geerbt von ControlDesigner) |
| Invalidate(Rectangle) |
Deaktiviert den angegebenen Bereich des Steuerelements, das auf der Entwurfsoberfläche angezeigt wird, und signalisiert dem Steuerelement-Designer, das Steuerelement neu zu zeichnen. (Geerbt von ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Ruft den InheritanceAttribute angegebenen ComponentDesignerab. (Geerbt von ComponentDesigner) |
| IsPropertyBound(String) |
Veraltet.
Ruft einen Wert ab, der angibt, ob die angegebene Eigenschaft für das zugeordnete Steuerelement datengebunden ist. (Geerbt von ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Verwendet den bereitgestellten Ressourcenschreiber, um die lokalisierbaren Eigenschaften des zugeordneten Steuerelements für eine Ressource im Entwurfshost beizubehalten. (Geerbt von ControlDesigner) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Wird aufgerufen, wenn ein vordefiniertes, automatisches Formatierungsschema auf das zugeordnete Steuerelement angewendet wurde. (Geerbt von ControlDesigner) |
| OnBehaviorAttached() |
Wird aufgerufen, wenn der Steuerelement-Designer an ein Behavior-Objekt angefügt ist. (Geerbt von ControlDesigner) |
| OnBehaviorDetaching() |
Veraltet.
Wird aufgerufen, wenn ein Verhalten vom Element getrennt wird. (Geerbt von HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Veraltet.
Wird aufgerufen, wenn sich die Datenbindungsauflistung ändert. (Geerbt von ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Wird vom Entwurfshost aufgerufen, wenn der Benutzer zur Entwurfszeit auf das zugeordnete Steuerelement klickt. (Geerbt von ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Wird aufgerufen, wenn sich das zugeordnete Steuerelement ändert. (Geerbt von ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Stellt die Methode dar, die das ComponentChanging Ereignis für das zugeordnete Steuerelement behandelt. (Geerbt von ControlDesigner) |
| OnControlResize() |
Veraltet.
Wird aufgerufen, wenn die größe des zugeordneten Webserversteuerelements zur Entwurfszeit im Entwurfshost geändert wurde. (Geerbt von ControlDesigner) |
| OnPaint(PaintEventArgs) |
Wird aufgerufen, wenn der Steuerelement-Designer das zugeordnete Steuerelement auf der Entwurfsoberfläche zeichnet, wenn der CustomPaint Wert ist |
| OnSetComponentDefaults() |
Veraltet.
Legt die Standardeigenschaften für die Komponente fest. (Geerbt von ComponentDesigner) |
| OnSetParent() |
Bietet eine Möglichkeit, zusätzliche Verarbeitung durchzuführen, wenn das zugeordnete Steuerelement an ein übergeordnetes Steuerelement angefügt ist. (Geerbt von HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Ermöglicht es einem Designer, Elemente aus der Gruppe von Attributen zu ändern oder zu entfernen, die er über eine TypeDescriptor. (Geerbt von ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus der Gruppe von Ereignissen, die er über eine TypeDescriptor. (Geerbt von ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Ermöglicht es einem Designer, Elemente aus dem Satz von Eigenschaften zu ändern oder zu entfernen, die er über eine TypeDescriptor. (Geerbt von ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Ermöglicht es einem Designer, den Satz von Attributen hinzuzufügen, die er über eine TypeDescriptor. (Geerbt von ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Legt die Liste der Ereignisse fest, die zur Entwurfszeit für das TypeDescriptor Objekt für die Komponente verfügbar gemacht werden. (Geerbt von HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Fügt Eigenschaften zu oder entfernt Eigenschaften aus dem Eigenschaftenraster in einem Entwurfshost zur Entwurfszeit oder stellt neue Entwurfszeiteigenschaften bereit, die Eigenschaften für das zugeordnete Steuerelement entsprechen können. (Geerbt von ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Benachrichtigt die IComponentChangeService Änderung dieser Komponente. (Geerbt von ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Benachrichtigt die IComponentChangeService Komponente darüber, dass diese Komponente geändert werden soll. (Geerbt von ComponentDesigner) |
| RaiseResizeEvent() |
Veraltet.
Löst das OnControlResize()-Ereignis aus. (Geerbt von ControlDesigner) |
| RegisterClone(Object, Object) |
Registriert interne Daten in einem geklonten Steuerelement. (Geerbt von ControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Gibt den Inhalt für einen bearbeitbaren Bereich des Steuerelements zur Entwurfszeit an. (Geerbt von ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Gibt den Inhalt für einen bearbeitbaren Bereich in der Entwurfszeitansicht des Steuerelements an. (Geerbt von ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Weist die angegebene bitweise ViewFlags Aufzählung dem angegebenen Flagwert zu. (Geerbt von ControlDesigner) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| UpdateDesignTimeHtml() |
Aktualisiert das Entwurfszeit-HTML-Markup für das zugeordnete Webserversteuerelement durch Aufrufen der GetDesignTimeHtml Methode. (Geerbt von ControlDesigner) |