GridViewDesigner.GetDesignTimeHtml Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.UI.Design.WebControls

Bütünleştirilmiş Kod:: System.Design.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Tasarım zamanında ilişkili GridView denetimi işlemek için kullanılan işaretlemeyi alır.

Aşırı Yüklemeler

GetDesignTimeHtml()	Tasarım zamanında ilişkili denetimi işlemek için kullanılan işaretlemeyi alır.
GetDesignTimeHtml(DesignerRegionCollection)	Tasarım zamanında ilişkili denetimi işlemek için kullanılan işaretlemeyi alır ve tasarımcı bölgeleri koleksiyonunu doldurur.

GetDesignTimeHtml()

Tasarım zamanında ilişkili denetimi işlemek için kullanılan işaretlemeyi alır.

public:
 override System::String ^ GetDesignTimeHtml();

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Döndürülenler

String

String Tasarım zamanında işlemek için kullanılan işaretlemeyi GridView içeren.

Örnekler

Aşağıdaki kod örneği, tasarım zamanında denetimin GetDesignTimeHtml görünümünü değiştirmek için sınıfından GridViewDesigner devralınan bir sınıfta yönteminin GridView nasıl geçersiz kılındığını gösterir. Örnek, tanımlandıysa Caption özelliğini içerecek Caption şekilde kılavuza yeni bir ilk satır ekler. BorderStyle sınıfından türetilen GridView denetimin ö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. Denetimin çalışma zamanı görünümünü değiştirmez.

// 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

' 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

Açıklamalar

GetDesignTimeHtml() yöntemi aşağıdakileri yapar:

AutoGenerateColumns Özelliği boşsa denetimin trueColumns özelliğini olarak ayarlar.
DataKeyNames Veri kaynağının şeması alınamıyorsa denetimin nullözelliğini olarak ayarlar.
yönteminin TypeDescriptor çağrılmaya zorlanması PreFilterProperties için nesnesini yeniler.
İşaretlemeyi oluşturmak için temel yöntemini çağırır.

Devralanlara Notlar

Yöntemini geçersiz kılarsanız GetDesignTimeHtml() , temel yöntemi çağırdığınızdan emin olun çünkü sonunda birkaç geçersiz kılma düzeyi aracılığıyla, işaretlemeyi oluşturmak için denetimin GridView veya denetimin bir kopyasını çağırır.

Ayrıca bkz.

Şunlara uygulanır

GetDesignTimeHtml(DesignerRegionCollection)

Tasarım zamanında ilişkili denetimi işlemek için kullanılan işaretlemeyi alır ve tasarımcı bölgeleri koleksiyonunu doldurur.

public:
 override System::String ^ GetDesignTimeHtml(System::Web::UI::Design::DesignerRegionCollection ^ regions);

public override string GetDesignTimeHtml (System.Web.UI.Design.DesignerRegionCollection regions);

override this.GetDesignTimeHtml : System.Web.UI.Design.DesignerRegionCollection -> string

Public Overrides Function GetDesignTimeHtml (regions As DesignerRegionCollection) As String

Parametreler

regions: DesignerRegionCollection

Denetimin DesignerRegionCollection tasarım zamanı görünümünde seçilebilir ve tıklanabilir bölgelerin tanımlarının eklendiği a.

Döndürülenler

String

String Tasarım zamanında işlemek için kullanılan işaretlemeyi GridView içeren.

Örnekler

// 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

' 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

Açıklamalar

yöntemi, GetDesignTimeHtml(DesignerRegionCollection) denetimin GetDesignTimeHtml() tasarım zamanı işlemesi GridView için işaretleme oluşturmak üzere yöntemini çağırır. ayrıca GetDesignTimeHtml(DesignerRegionCollection) , tasarım zamanı işlemesinin regions her tıklanabilir veya seçilebilir bölgesi için bir DesignerRegion nesneyle doldurulur.

GridViewiçin, her satırdaki ilk hücre seçilebilir; satırlardaki tüm hücreler tıklanabilir.

Devralanlara Notlar

Yöntemini geçersiz kılarsanız GetDesignTimeHtml(DesignerRegionCollection) , temel yöntemi veya aşırı yüklemeyi çağırdığınızdan GetDesignTimeHtml() emin olun çünkü sonunda birkaç geçersiz kılma düzeyi aracılığıyla, işaretlemeyi oluşturmak için denetimin GridView bir kopyasını veya denetimi çağırın.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

GridViewDesigner.GetDesignTimeHtml Yöntem

Tanım

Aşırı Yüklemeler

GetDesignTimeHtml()

Döndürülenler

Örnekler

Açıklamalar

Devralanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

GetDesignTimeHtml(DesignerRegionCollection)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Devralanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar