DataGridDesigner Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Utökar designtidsbeteendet för DataGrid webbserverkontrollen.
public ref class DataGridDesigner : System::Web::UI::Design::WebControls::BaseDataListDesignerpublic class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesignertype DataGridDesigner = class
inherit BaseDataListDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type DataGridDesigner = class
inherit BaseDataListDesignerPublic Class DataGridDesigner
Inherits BaseDataListDesigner- Arv
- Attribut
Exempel
Följande kodexempel visar hur du DataGridDesigner utökar klassen. Koden åsidosätter GetDesignTimeHtml metoden för att anpassa CellPaddingegenskaperna , BorderWidthoch BorderColor när DataGrid kontrollen återges på en designyta.
Imports System.Diagnostics
Imports System.ComponentModel
Imports System.Drawing
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls
Namespace Examples.AspNet
' Create a designer class for the SimpleDataList class.
<System.Security.Permissions.SecurityPermission( _
System.Security.Permissions.SecurityAction.Demand, _
Flags:=System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Public Class SimpleDataListDesigner
Inherits DataListDesigner
Private simpleList As SimpleDataList
' Override the GetDesignTimeHtml method to add style to the control
' on the design surface.
Public Overrides Function GetDesignTimeHtml() As String
' Cast the control to the Component property of the designer.
simpleList = CType(Component, SimpleDataList)
Dim designTimeHtml As String = Nothing
' Create variables to hold current property values.
Dim oldBorderWidth As Unit = simpleList.BorderWidth
Dim oldBorderColor As Color = simpleList.BorderColor
' Set the properties and generate the design-time HTML.
If (simpleList.Enabled) Then
Try
simpleList.BorderWidth = Unit.Point(5)
simpleList.BorderColor = Color.Purple
designTimeHtml = MyBase.GetDesignTimeHtml()
' Call the GetErrorDesignTimeHtml method if an
' exception occurs.
Catch ex As Exception
designTimeHtml = GetErrorDesignTimeHtml(ex)
' Return the properties to their original settings.
Finally
simpleList.BorderWidth = oldBorderWidth
simpleList.BorderColor = oldBorderColor
End Try
' If the list is not enabled, call the GetEmptyDesignTimeHtml
' method.
Else
designTimeHtml = GetEmptyDesignTimeHtml()
End If
Return designTimeHtml
End Function
Protected Overrides Function GetEmptyDesignTimeHtml() As String
Dim emptyText As String
' Check the CanEnterTemplateMode property to
' specify which text to display if ItemTemplate
' does not contain a value.
If CanEnterTemplateMode Then
emptyText = _
"<b>Either the Enabled property value is false " + _
"or you need to set the ItemTemplate for this " + _
"control.<br>Right-click to edit templates.</b>"
Else
emptyText = _
"<b>You cannot edit templates in this view.<br>" + _
"Switch to HTML view to define the ItemTemplate.</b>"
End If
Return CreatePlaceHolderDesignTimeHtml(emptyText)
End Function
' Generate HTML to indicate that an error has occurred.
Protected Overrides Function GetErrorDesignTimeHtml(ByVal exc As _
Exception) As String
Return CreatePlaceHolderDesignTimeHtml( _
"<b>An error occurred</b>.<br>Check to ensure that all " + _
"properties are valid.")
End Function
' Override the Initialize method to ensure that
' only an instance of the SimpleDataList class is
' used by this designer class.
Public Overrides Sub Initialize(ByVal component As IComponent)
simpleList = CType(component, SimpleDataList)
If IsNothing(simpleList) Then
Throw New ArgumentException("Must be a SimpleDataList.", "component")
End If
MyBase.Initialize(component)
End Sub
End Class
End Namespace
I följande exempel visas hur du använder DesignerAttribute attributet för att associera designern med DataGrid kontrollen.
' Override the Initialize method to ensure that
' only an instance of the SimpleDataList class is
' used by this designer class.
Public Overrides Sub Initialize(ByVal component As IComponent)
simpleList = CType(component, SimpleDataList)
If IsNothing(simpleList) Then
Throw New ArgumentException("Must be a SimpleDataList.", "component")
End If
MyBase.Initialize(component)
End Sub
Konstruktorer
| Name | Description |
|---|---|
| DataGridDesigner() |
Initierar en ny instans av DataGridDesigner klassen. |
Egenskaper
| Name | Description |
|---|---|
| ActionLists |
Hämtar designerns åtgärdslistasamling för den här designern. (Ärvd från BaseDataListDesigner) |
| ActiveTemplateEditingFrame |
Föråldrad.
Hämtar den aktiva mallredigeringsramen. (Ärvd från TemplatedControlDesigner) |
| AllowResize |
Hämtar ett värde som anger om kontrollen kan ändras i designmiljön. (Ärvd från ControlDesigner) |
| AssociatedComponents |
Hämtar den samling komponenter som är associerade med komponenten som hanteras av designern. (Ärvd från ComponentDesigner) |
| AutoFormats |
Hämtar objektet som DesignerAutoFormatCollection är associerat med den här designern. |
| Behavior |
Föråldrad.
Hämtar eller anger det DHTML-beteende som är associerat med designern. (Ärvd från HtmlControlDesigner) |
| CanEnterTemplateMode |
Hämtar ett värde som anger om den här designern tillåter visning eller redigering av mallar. (Ärvd från TemplatedControlDesigner) |
| Component |
Hämtar komponenten som designern designar. (Ärvd från ComponentDesigner) |
| DataBindings |
Hämtar databindningssamlingen för den aktuella kontrollen. (Ärvd från HtmlControlDesigner) |
| DataBindingsEnabled |
Hämtar ett värde som anger om designern tillåter databindning. (Ärvd från TemplatedControlDesigner) |
| DataKeyField |
Hämtar eller anger värdet för datanyckelfältet för den associerade kontrollen. (Ärvd från BaseDataListDesigner) |
| DataMember |
Hämtar eller anger värdet för datamedlemsfältet för den associerade kontrollen. (Ärvd från BaseDataListDesigner) |
| DataSource |
Hämtar eller anger värdet för datakällans egenskap för den associerade kontrollen. (Ärvd från BaseDataListDesigner) |
| DataSourceDesigner |
Hämtar datakällans designer när en väljs för databindning. (Ärvd från BaseDataListDesigner) |
| DataSourceID |
Hämtar eller anger designerns version av datakällans ID-egenskap och används för att skugga motsvarande egenskap för den associerade kontrollen. (Ärvd från BaseDataListDesigner) |
| DesignerState |
Hämtar ett objekt som används för att bevara data för den associerade kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| DesignerView |
Hämtar standardvyn för datakällan som är bunden till den associerade kontrollen. (Ärvd från BaseDataListDesigner) |
| DesignTimeElement |
Föråldrad.
Hämtar designtidsobjektet som representerar kontrollen som är associerad med HtmlControlDesigner objektet på designytan. (Ärvd från HtmlControlDesigner) |
| DesignTimeElementView |
Föråldrad.
Hämtar visningskontrollobjektet för kontrolldesignern. (Ärvd från ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Hämtar ett värde som anger om inläsningen måste vara klar för att visa designtidsmarkeringen. (Ärvd från BaseDataListDesigner) |
| Expressions |
Hämtar uttrycksbindningarna för den aktuella kontrollen vid designtillfället. (Ärvd från HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Hämtar ett värde som anger om kontrollens egenskaper ska döljas när kontrollen placeras i mallredigeringsläge. (Ärvd från TemplatedControlDesigner) |
| ID |
Hämtar eller anger ID-strängen för kontrollen. (Ärvd från ControlDesigner) |
| InheritanceAttribute |
Hämtar ett attribut som anger typen av arv för den associerade komponenten. (Ärvd från ComponentDesigner) |
| Inherited |
Hämtar ett värde som anger om den här komponenten ärvs. (Ärvd från ComponentDesigner) |
| InTemplateMode |
Föråldrad.
Hämtar ett värde som anger om designerdokumentet är i mallläge. (Ärvd från TemplatedControlDesigner) |
| IsDirty |
Föråldrad.
Hämtar eller anger ett värde som anger om webbserverkontrollen har markerats som ändrad. (Ärvd från ControlDesigner) |
| ParentComponent |
Hämtar den överordnade komponenten för den här designern. (Ärvd från ComponentDesigner) |
| ReadOnly |
Föråldrad.
Hämtar eller anger ett värde som anger om egenskaperna för kontrollen är skrivskyddade vid designtillfället. (Ärvd från ControlDesigner) |
| RootDesigner |
Hämtar kontrolldesignern för sidan Webbformulär som innehåller den associerade kontrollen. (Ärvd från ControlDesigner) |
| ShadowProperties |
Hämtar en samling egenskapsvärden som åsidosätter användarinställningar. (Ärvd från ComponentDesigner) |
| ShouldCodeSerialize |
Föråldrad.
Hämtar eller anger ett värde som anger om du vill skapa en fältdeklaration för kontrollen i filen bakom koden för det aktuella designdokumentet under serialiseringen. (Ärvd från HtmlControlDesigner) |
| Tag |
Hämtar ett objekt som representerar HTML-markeringselementet för den associerade kontrollen. (Ärvd från ControlDesigner) |
| TemplateGroups |
Hämtar en samling mallgrupper som var och en innehåller en malldefinition. (Ärvd från TemplatedControlDesigner) |
| UsePreviewControl |
Hämtar ett värde som anger om kontrolldesignern använder en tillfällig förhandsgranskningskontroll för att generera HTML-kod för designtid. (Ärvd från ControlDesigner) |
| Verbs |
Hämtar samlingen med verb som är tillgängliga för den här designern. (Ärvd från BaseDataListDesigner) |
| ViewControl |
Hämtar eller anger en webbserverkontroll som kan användas för att förhandsgranska HTML-markeringen för designtid. (Ärvd från ControlDesigner) |
| ViewControlCreated |
Hämtar eller anger ett värde som anger om en |
| Visible |
Hämtar ett värde som anger om kontrollen är synlig vid designtillfället. (Ärvd från ControlDesigner) |
Metoder
| Name | Description |
|---|---|
| CreateErrorDesignTimeHtml(String, Exception) |
Skapar HTML-koden för att visa ett angivet undantagsfel vid designtillfället. (Ärvd från ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Skapar HTML-kod för att visa ett angivet felmeddelande vid designtillfället. (Ärvd från ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Ger en enkel rektangulär platshållarrepresentation som visar kontrollens typ och ID. (Ärvd från ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Tillhandahåller en enkel rektangulär platshållarrepresentation som visar kontrollens typ och ID, samt ytterligare angivna instruktioner eller information. (Ärvd från ControlDesigner) |
| CreateTemplateEditingFrame(TemplateEditingVerb) |
Föråldrad.
Skapar en mallredigeringsram med det angivna verbet. |
| CreateViewControl() |
Returnerar en kopia av den associerade kontrollen för visning eller återgivning på designytan. (Ärvd från ControlDesigner) |
| Dispose() |
Släpper alla resurser som används av ComponentDesigner. (Ärvd från ComponentDesigner) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av DataGridDesigner objektet och släpper eventuellt de hanterade resurserna. |
| DoDefaultAction() |
Skapar en metodsignatur i källkodsfilen för standardhändelsen på komponenten och navigerar användarens markören till den platsen. (Ärvd från ComponentDesigner) |
| EnterTemplateMode(ITemplateEditingFrame) |
Föråldrad.
Öppnar ett visst mallramobjekt för redigering i designern. (Ärvd från TemplatedControlDesigner) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| ExitTemplateMode(Boolean, Boolean, Boolean) |
Föråldrad.
Stänger den aktiva mallredigeringsramen när relevanta ändringar har sparats. (Ärvd från TemplatedControlDesigner) |
| GetBounds() |
Hämtar koordinaterna för rektangeln som representerar gränserna för kontrollen enligt designytan. (Ärvd från ControlDesigner) |
| GetCachedTemplateEditingVerbs() |
Föråldrad.
Hämtar de cachelagrade mallredigeringsverb som är tillgängliga för designern. |
| GetDesignTimeDataSource(IEnumerable, Int32, Boolean) |
Genererar ett objekt som kan användas som datakälla vid designtillfället. (Ärvd från BaseDataListDesigner) |
| GetDesignTimeDataSource(Int32, Boolean) |
Genererar ett objekt som kan användas som datakälla vid designtillfället. (Ärvd från BaseDataListDesigner) |
| GetDesignTimeHtml() |
Hämtar HTML-markering som används för att representera DataGrid kontrollen vid designtillfället. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Hämtar HTML-markering för att visa kontrollen och fyller samlingen med de aktuella kontrolldesignerregionerna. (Ärvd från ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Returnerar innehållet för en redigerbar region i designtidsvyn för den associerade kontrollen. (Ärvd från ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Hämtar HTML-markering som används för att representera en tom mallbaserad kontroll vid designtillfället. |
| GetErrorDesignTimeHtml(Exception) |
Hämtar HTML-koden som visas vid designtillfället för det angivna undantaget när ett fel har påträffats när kontrollen återges. |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetPersistenceContent() |
Hämtar den bestående inre HTML-koden för kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| GetPersistInnerHtml() |
Hämtar markeringen för att bevara innehållet som finns i den associerade serverkontrollkörningen. (Ärvd från TemplatedControlDesigner) |
| GetResolvedSelectedDataSource() |
Hämtar datakällkomponenten från den associerade kontrollcontainern, matchad till en specifik datamedlem. (Ärvd från BaseDataListDesigner) |
| GetSelectedDataSource() |
Hämtar datakällkomponenten från den associerade kontrollcontainern. (Ärvd från BaseDataListDesigner) |
| GetService(Type) |
Försöker hämta den angivna typen av tjänst från designlägesplatsen för designerns komponent. (Ärvd från ComponentDesigner) |
| GetTemplateContainerDataItemProperty(String) |
Föråldrad.
Hämtar dataobjektegenskapen för mallcontainern. |
| GetTemplateContainerDataSource(String) |
Föråldrad.
Hämtar datakällan för mallens container. (Ärvd från BaseDataListDesigner) |
| GetTemplateContent(ITemplateEditingFrame, String, Boolean) |
Föråldrad.
Hämtar innehållet i mallen. |
| GetTemplateEditingVerbs() |
Föråldrad.
Hämtar mallredigeringsverb som är tillgängliga för designern. (Ärvd från TemplatedControlDesigner) |
| GetTemplateFromText(String) |
Skapar en mall från den angivna texten. (Ärvd från TemplatedControlDesigner) |
| GetTemplatePropertyParentType(String) |
Föråldrad.
Hämtar objektet Type som motsvarar den överordnade mallen. |
| GetTextFromTemplate(ITemplate) |
Hämtar en textsträng som representerar den angivna mallen. (Ärvd från TemplatedControlDesigner) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetViewRendering() |
Hämtar ett objekt som innehåller designtidsmarkeringen för innehållet och regionerna i den associerade kontrollen. (Ärvd från ControlDesigner) |
| Initialize(IComponent) |
Initierar designern med den angivna DataGrid kontrollen. |
| InitializeExistingComponent(IDictionary) |
Initierar om en befintlig komponent. (Ärvd från ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Initierar en nyskapade komponent. (Ärvd från ComponentDesigner) |
| InitializeNonDefault() |
Föråldrad.
Föråldrad.
Initierar inställningarna för en importerad komponent som redan har initierats till andra inställningar än standardinställningarna. (Ärvd från ComponentDesigner) |
| Invalidate() |
Ogiltigförklarar hela området av kontrollen som visas på designytan och signalerar kontrolldesignern att rita om kontrollen. (Ärvd från ControlDesigner) |
| Invalidate(Rectangle) |
Ogiltigförklarar det angivna området för kontrollen som visas på designytan och signalerar kontrolldesignern att rita om kontrollen. (Ärvd från ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Hämtar den InheritanceAttribute angivna ComponentDesigner. (Ärvd från ComponentDesigner) |
| InvokePropertyBuilder(Int32) |
Anropar en komponentredigerare för den associerade kontrollen. (Ärvd från BaseDataListDesigner) |
| IsPropertyBound(String) |
Föråldrad.
Hämtar ett värde som anger om den angivna egenskapen för den associerade kontrollen är databunden. (Ärvd från ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Använder den angivna resursskrivaren för att bevara de localizable egenskaperna för den associerade kontrollen till en resurs i designvärden. (Ärvd från ControlDesigner) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnAutoFormat(Object, EventArgs) |
Föråldrad.
Hanterar händelsen |
| OnAutoFormatApplied(DesignerAutoFormat) |
Anropas när ett automatiskt formateringsschema har tillämpats på den associerade kontrollen. (Ärvd från BaseDataListDesigner) |
| OnBehaviorAttached() |
Föråldrad.
Ger en möjlighet att utföra ytterligare bearbetning när ett beteende är kopplat till designern. (Ärvd från TemplatedControlDesigner) |
| OnBehaviorDetaching() |
Föråldrad.
Anropas när ett beteende avassocierar från elementet. (Ärvd från HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Föråldrad.
Anropas när databindningssamlingen ändras. (Ärvd från ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Anropas av designvärden när användaren klickar på den associerade kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| OnColumnsChanged() |
Anropas när kolumnerna i mallen ändras. |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Anropas när den associerade kontrollen ändras. (Ärvd från BaseDataListDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Representerar den metod som ska hantera ComponentChanging händelsen för den associerade kontrollen. (Ärvd från ControlDesigner) |
| OnControlResize() |
Föråldrad.
Anropas när den associerade webbserverkontrollen har ändrats i designvärden vid designtillfället. (Ärvd från ControlDesigner) |
| OnDataSourceChanged() |
Anropas när datakällan för den associerade kontrollen har ändrats. (Ärvd från BaseDataListDesigner) |
| OnPaint(PaintEventArgs) |
Anropas när kontrolldesignern ritar den associerade kontrollen på designytan, om CustomPaint värdet är |
| OnPropertyBuilder(Object, EventArgs) |
Representerar den metod som hanterar händelsen property-builder. (Ärvd från BaseDataListDesigner) |
| OnSchemaRefreshed() |
Anropas när schemat för datakällan för den associerade kontrollen ändras. (Ärvd från BaseDataListDesigner) |
| OnSetComponentDefaults() |
Föråldrad.
Föråldrad.
Anger standardegenskaperna för komponenten. (Ärvd från ComponentDesigner) |
| OnSetParent() |
Ger en möjlighet att utföra ytterligare bearbetning när den överordnade designern ändras. (Ärvd från TemplatedControlDesigner) |
| OnStylesChanged() |
Kan åsidosättas för att implementera funktioner som ska inträffa när ett format för den associerade kontrollen har ändrats. (Ärvd från BaseDataListDesigner) |
| OnTemplateEditingVerbsChanged() |
Anropas när mallredigeringsverb ändras. |
| OnTemplateModeChanged() |
Ger möjlighet att utföra ytterligare bearbetning när mallläget ändras. (Ärvd från TemplatedControlDesigner) |
| PostFilterAttributes(IDictionary) |
Gör att en designer kan ändra eller ta bort objekt från den uppsättning attribut som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Gör att en designer kan ändra eller ta bort objekt från den uppsättning händelser som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Gör att en designer kan ändra eller ta bort objekt från den uppsättning egenskaper som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Gör att en designer kan lägga till i den uppsättning attribut som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Anger listan över händelser som exponeras vid designtid för TypeDescriptor objektet för komponenten. (Ärvd från HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Används av designern för att ta bort egenskaper från eller lägga till ytterligare egenskaper i visningen i rutnätet Egenskaper eller skuggegenskaper för den associerade kontrollen. (Ärvd från BaseDataListDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Meddelar IComponentChangeService att den här komponenten har ändrats. (Ärvd från ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
IComponentChangeService Meddelar att den här komponenten håller på att ändras. (Ärvd från ComponentDesigner) |
| RaiseResizeEvent() |
Föråldrad.
Genererar händelsen OnControlResize() . (Ärvd från ControlDesigner) |
| RegisterClone(Object, Object) |
Registrerar interna data i en klonad kontroll. (Ärvd från ControlDesigner) |
| SaveActiveTemplateEditingFrame() |
Sparar den aktiva mallredigeringsramen. (Ärvd från TemplatedControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Anger innehållet för en redigerbar region för kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Anger innehållet för en redigerbar region i kontrollens designtidsvy. (Ärvd från ControlDesigner) |
| SetTemplateContent(ITemplateEditingFrame, String, String) |
Föråldrad.
Anger innehållet för den angivna mallen och ramen. |
| SetViewFlags(ViewFlags, Boolean) |
Tilldelar den angivna bitvis ViewFlags uppräkning till det angivna flaggvärdet. (Ärvd från ControlDesigner) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| UpdateDesignTimeHtml() |
Uppdaterar HTML-koden för designtid. (Ärvd från TemplatedControlDesigner) |
