GridViewDesigner Sınıf

Tanım

public ref class GridViewDesigner : System::Web::UI::Design::WebControls::DataBoundControlDesigner

public class GridViewDesigner : System.Web.UI.Design.WebControls.DataBoundControlDesigner

type GridViewDesigner = class
    inherit DataBoundControlDesigner

Public Class GridViewDesigner
Inherits DataBoundControlDesigner

Devralma

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

GridViewDesigner

Örnekler

Aşağıdaki kod örneği, tasarım zamanında denetimden türetilen denetimlerin görünümünü değiştirmek için sınıfın GridView nasıl genişletildiğini GridViewDesigner gösterir.

Örnek, denetiminden türetir MyGridViewGridView. yalnızca MyGridView öğesinin GridViewbir kopyasıdır. Örnek ayrıca sınıfından sınıfını MyGridViewDesignerGridViewDesigner türetir ve denetimine için MyGridViewDesignerMyGridView bir DesignerAttribute nesnesi yerleştirir.

, MyGridViewDesigner özelliği tasarım zamanında Özellikler kılavuzunda görünür hale getirmek Page için yöntemini geçersiz kılarPreFilterProperties. Belirtildiyse, tasarım zamanında denetimin Caption yeni bir ilk satırı MyGridView olarak özelliğini eklemek için yöntemini geçersiz kılarGetDesignTimeHtml. Denetimin BorderStyleMyGridView özelliği veya None değerine sahipseNotSet, GetDesignTimeHtml kapsamını daha görünür hale getirmek için denetimin çevresine mavi kesikli bir kenarlık çizer.

using System;
using System.Web;
using System.Drawing;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The MyGridView is a copy of the GridView.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyGridViewDesigner))]
    public class MyGridView : GridView
    {
    } // MyGridView

    // Override members of the GridViewDesigner.
    [ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
    public class MyGridViewDesigner : GridViewDesigner
    {
        // Shadow the control properties with design-time properties.
        protected override void PreFilterProperties(IDictionary properties)
        {
            // Call the base method first.
            base.PreFilterProperties(properties);

            // Make the Page visible in the Properties grid.
            PropertyDescriptor selectProp = 
                (PropertyDescriptor)properties["Page"];
            properties["Page"] =
                TypeDescriptor.CreateProperty(selectProp.ComponentType, 
                    selectProp, BrowsableAttribute.Yes);
        } // PreFilterProperties

        // Generate the design-time markup.
        const string capTag = "caption";
        const string trOpen = "tr><td colspan=9 align=center";
        const string trClose = "td></tr";

        public override string GetDesignTimeHtml()
        {
            // Make the full extent of the control more visible in the designer.
            // If the border style is None or NotSet, change the border to
            // a wide, blue, dashed line. Include the caption within the border.
            MyGridView myGV = (MyGridView)Component;
            string markup = null;
            int charX;

            // Check if the border style should be changed.
            if (myGV.BorderStyle == BorderStyle.NotSet ||
                myGV.BorderStyle == BorderStyle.None)
            {
                BorderStyle oldBorderStyle = myGV.BorderStyle;
                Unit oldBorderWidth = myGV.BorderWidth;
                Color oldBorderColor = myGV.BorderColor;

                // Set the design-time properties and catch any exceptions.
                try
                {
                    myGV.BorderStyle = BorderStyle.Dashed;
                    myGV.BorderWidth = Unit.Pixel(3);
                    myGV.BorderColor = Color.Blue;

                    // Call the base method to generate the markup.
                    markup = base.GetDesignTimeHtml();
                }
                catch (Exception ex)
                {
                    markup = GetErrorDesignTimeHtml(ex);
                }
                finally
                {
                    // Restore the properties to their original settings.
                    myGV.BorderStyle = oldBorderStyle;
                    myGV.BorderWidth = oldBorderWidth;
                    myGV.BorderColor = oldBorderColor;
                }
            }
            else
            {
                // Call the base method to generate the markup.
                markup = base.GetDesignTimeHtml();
            }

            // Look for a <caption> tag.
            if ((charX = markup.IndexOf(capTag)) > 0)
            {
                // Replace the first caption with 
                // "tr><td colspan=9 align=center".
                // It is okay if the colspan exceeds the 
                // number of columns in the table.
                markup = markup.Remove(charX,
                    capTag.Length).Insert(charX, trOpen);

                // Replace the second caption with "td></tr".
                if ((charX = markup.IndexOf(capTag, charX)) > 0)
                    markup = markup.Remove(charX,
                        capTag.Length).Insert(charX, trClose);
            }
            return markup;
        } // GetDesignTimeHtml
    } // MyGridViewDesigner
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.Drawing
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The MyGridView is a copy of the GridView.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyGridViewDesigner))> _
    Public Class MyGridView
        Inherits GridView
    End Class

    ' Override members of the GridViewDesigner.
    <ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _
    Public Class MyGridViewDesigner
        Inherits GridViewDesigner

        ' Shadow the control properties with design-time properties.
        Protected Overrides Sub PreFilterProperties( _
            ByVal properties As IDictionary)

            ' Call the base method first.
            MyBase.PreFilterProperties(properties)

            ' Make the Page visible in the Properties grid.
            Dim selectProp As PropertyDescriptor = _
                CType(properties("Page"), PropertyDescriptor)
            properties("Page") = _
                TypeDescriptor.CreateProperty(selectProp.ComponentType, _
                    selectProp, BrowsableAttribute.Yes)
        End Sub

        ' Generate the design-time markup.
        Private Const capTag As String = "caption"
        Private Const trOpen As String = "tr><td colspan=9 align=center"
        Private Const trClose As String = "td></tr"

        Public Overrides Function GetDesignTimeHtml() As String

            ' Make the full extent of the control more visible in the designer.
            ' If the border style is None or NotSet, change the border to
            ' a wide, blue, dashed line. Include the caption within the border.
            Dim myGV As MyGridView = CType(Component, MyGridView)
            Dim markup As String = Nothing
            Dim charX As Integer

            ' Check if the border style should be changed.
            If (myGV.BorderStyle = BorderStyle.NotSet Or _
                myGV.BorderStyle = BorderStyle.None) Then

                Dim oldBorderStyle As BorderStyle = myGV.BorderStyle
                Dim oldBorderWidth As Unit = myGV.BorderWidth
                Dim oldBorderColor As Color = myGV.BorderColor

                ' Set the design-time properties and catch any exceptions.
                Try
                    myGV.BorderStyle = BorderStyle.Dashed
                    myGV.BorderWidth = Unit.Pixel(3)
                    myGV.BorderColor = Color.Blue

                    ' Call the base method to generate the markup.
                    markup = MyBase.GetDesignTimeHtml()

                Catch ex As Exception
                    markup = GetErrorDesignTimeHtml(ex)

                Finally
                    ' Restore the properties to their original settings.
                    myGV.BorderStyle = oldBorderStyle
                    myGV.BorderWidth = oldBorderWidth
                    myGV.BorderColor = oldBorderColor
                End Try

            Else
                ' Call the base method to generate the markup.
                markup = MyBase.GetDesignTimeHtml()
            End If

            ' Look for a <caption> tag.
            charX = markup.IndexOf(capTag)
            If charX > 0 Then

                ' Replace the first caption with 
                ' "tr><td colspan=9 align=center".
                ' It is okay if the colspan exceeds the 
                ' number of columns in the table.
                markup = markup.Remove(charX, _
                    capTag.Length).Insert(charX, trOpen)

                ' Replace the second caption with "td></tr".
                charX = markup.IndexOf(capTag, charX)
                If charX > 0 Then
                    markup = markup.Remove(charX, _
                        capTag.Length).Insert(charX, trClose)
                End If
            End If

            Return markup

        End Function ' GetDesignTimeHtml
    End Class
End Namespace ' Examples.VB.WebControls.Design

Açıklamalar

Görsel tasarımcıda, Kaynak görünümünden Tasarım görünümüne geçtiğinizde, denetimi açıklayan GridView işaretleme kaynak kodu ayrıştırılır ve tasarım yüzeyinde denetimin tasarım zamanı sürümü oluşturulur. Kaynak görünümüne geri döndüğünüzde, tasarım zamanı denetimi işaretleme kaynak kodunda kalıcı hale getirilir ve Web sayfasının işaretlemesinde düzenlenir.

sınıfının özellikleri GridViewDesigner aşağıdaki işlevleri sağlar:

• ActionLists özelliği, genellikle tasarımcının DesignerActionList devralma ağacındaki her düzey için sınıfından türetilmiş bir nesne içeren bir nesnesi döndürürDesignerActionListCollection.

• özelliği, AutoFormatsOtomatik Biçim iletişim kutusunda görüntülenmek üzere bir biçimlendirme düzenleri koleksiyonu döndürür.

• özelliği, TemplateGroups ilişkili GridView denetimin alanları ve en üst düzey GridView şablonlar için bir şablon grupları koleksiyonu döndürür.

• UsePreviewControl özelliği her zaman değerini döndürür trueve tasarımcının tasarım zamanı işaretlemesini oluşturmak için ilişkili GridView öğesinin geçici bir kopyasını oluşturduğunu gösterir.

sınıfının yöntemleri GridViewDesigner aşağıdaki işlevleri sağlar:

• yöntemi, DataBind ilişkili GridView denetimi bir tasarım zamanı veri kaynağına bağlar.

• yöntemi, GetDesignTimeHtml tasarım zamanında ilişkiliyi GridView işlemek için kullanılan işaretlemeyi döndürür.

• Initialize yöntemi, tasarımcıyı ilişkili GridViewöğesini görüntülemeye, düzenlemeye ve tasarlamaya hazırlar.

• yöntemi OnClick , ilişkili GridView tasarım zamanı görünümünün bir bölgesine tıklandığında çağrılır.

• yöntemi OnSchemaRefreshed , ilişkili GridView veri kaynağının şeması değiştiğinde çağrılır.

• PreFilterProperties yöntemi, ilişkili GridViewöğesinin özelliklerini kaldırmak veya eklemek ya da gölge özelliklerine eklemek için kullanılır.

Tasarım zamanı düzenlenebilir bölgeler denetimde GridView desteklenmez, bu nedenle ve SetEditableDesignerRegionContent yöntemlerinin GetEditableDesignerRegionContent işlevselliği yoktur.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• GridView
• DataBoundControlDesigner
• ASP.NET Denetim Tasarımcılarına Giriş
• İzlenecek yol: Web Sunucusu Denetimi için Temel Denetim Tasarımcısı Oluşturma