DetailsViewDesigner.GetDesignTimeHtml Metod

Definition

Namnområde:
System.Web.UI.Design.WebControls
Sammansättning:
System.Design.dll

Hämtar den markering som används för att återge den associerade DetailsView kontrollen vid designtillfället.

Överlagringar

Name Description
GetDesignTimeHtml()

Hämtar den markering som används för att återge den associerade kontrollen vid designtillfället.
GetDesignTimeHtml(DesignerRegionCollection)

Hämtar den markering som används för att återge den associerade kontrollen vid designtillfället och fyller i en samling designerregioner.

GetDesignTimeHtml()

Hämtar den markering som används för att återge den associerade kontrollen vid designtillfället.

public:
 override System::String ^ GetDesignTimeHtml();
public override string GetDesignTimeHtml();
override this.GetDesignTimeHtml : unit -> string
Public Overrides Function GetDesignTimeHtml () As String

Returer

String

En String som innehåller den markering som används för att återge vid DetailsView designtillfället.

Exempel

I följande kodexempel visas hur du åsidosätter GetDesignTimeHtml metoden i en klass som ärvts från DetailsViewDesigner klassen för att ändra kontrollens DetailsView utseende vid designtillfället. Exemplet lägger till en ny första rad i rutnätet för att innehålla Caption egenskapen, om den Caption har definierats. BorderStyle Om egenskapen för kontrollen som härleds från DetailsView är NotSet värdet eller None ritar GetDesignTimeHtml den en blå streckad kantlinje runt kontrollen för att göra dess omfattning mer synlig. Det ändrar inte körningsutseendet för kontrollen.

// Generate the design-time markup.
const string capTag = "caption";
const string trOpen = "tr><td colspan=2 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.
    MyDetailsView myDV = (MyDetailsView)Component;
    string markup = null;
    int charX;

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

        // Set design-time properties and catch any exceptions.
        try
        {
            myDV.BorderStyle = BorderStyle.Dashed;
            myDV.BorderWidth = Unit.Pixel(3);
            myDV.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.
            myDV.BorderStyle = oldBorderStyle;
            myDV.BorderWidth = oldBorderWidth;
            myDV.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=2 align=center".
        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=2 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 myDV As MyDetailsView = CType(Component, MyDetailsView)
    Dim markup As String = Nothing
    Dim charX As Integer

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

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

        ' Set design-time properties and catch any exceptions.
        Try
            myDV.BorderStyle = BorderStyle.Dashed
            myDV.BorderWidth = Unit.Pixel(3)
            myDV.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.
            myDV.BorderStyle = oldBorderStyle
            myDV.BorderWidth = oldBorderWidth
            myDV.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=2 align=center".
        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

Kommentarer

GetDesignTimeHtml() Först anger AutoGenerateRows metoden -egenskapen för DetailsView kontrollen till true, om Fields samlingen är tom. Sedan GetDesignTimeHtml anger samlingen DataKeyNames av GetDesignTimeHtml kontrollen till en tom String matris om schemat för datakällan inte kan hämtas. Det uppdaterar TypeDescriptor objektet för att tvinga metoden PreFilterProperties att anropas. Den anropar sedan basmetoden för att generera pålägget.

Anteckningar till arvingar

Om du åsidosätter GetDesignTimeHtml() metoden måste du anropa basmetoden eftersom den så småningom, via flera åsidosättningsnivåer, anropar DetailsView kontrollen eller en kopia av kontrollen för att generera pålägget.

Se även

Gäller för

GetDesignTimeHtml(DesignerRegionCollection)

Hämtar den markering som används för att återge den associerade kontrollen vid designtillfället och fyller i en samling designerregioner.

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

Parametrar

regions
DesignerRegionCollection

En DesignerRegionCollection som du vill lägga till definitioner av de valbara och klickbara regionerna i kontrollens designtidsvy.

Returer

String

En String som innehåller den markering som används för att återge vid DetailsView designtillfället.

Exempel

I följande kodexempel visas hur du åsidosätter GetDesignTimeHtml metoden i en klass som ärvs från DetailsViewDesigner klassen för att ändra kontrollens DetailsView utseende vid designtillfället. Exemplet lägger till en ny första rad i rutnätet för att innehålla Caption egenskapen, om den Caption har definierats. BorderStyle Om egenskapen för kontrollen som härleds från DetailsView är NotSet eller-värdet None ritar GetDesignTimeHtml den en blå streckad kantlinje runt kontrollen för att göra dess omfattning mer synlig. Det ändrar inte körningsutseendet för kontrollen.

// Generate the design-time markup.
const string capTag = "caption";
const string trOpen = "tr><td colspan=2 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.
    MyDetailsView myDV = (MyDetailsView)Component;
    string markup = null;
    int charX;

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

        // Set design-time properties and catch any exceptions.
        try
        {
            myDV.BorderStyle = BorderStyle.Dashed;
            myDV.BorderWidth = Unit.Pixel(3);
            myDV.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.
            myDV.BorderStyle = oldBorderStyle;
            myDV.BorderWidth = oldBorderWidth;
            myDV.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=2 align=center".
        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=2 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 myDV As MyDetailsView = CType(Component, MyDetailsView)
    Dim markup As String = Nothing
    Dim charX As Integer

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

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

        ' Set design-time properties and catch any exceptions.
        Try
            myDV.BorderStyle = BorderStyle.Dashed
            myDV.BorderWidth = Unit.Pixel(3)
            myDV.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.
            myDV.BorderStyle = oldBorderStyle
            myDV.BorderWidth = oldBorderWidth
            myDV.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=2 align=center".
        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

Kommentarer

Metoden DetailsViewDesigner.GetDesignTimeHtml anropar DetailsViewDesigner.GetDesignTimeHtml metoden för att generera markering för designtidsåtergivningen DetailsView av kontrollen. Metoden DetailsViewDesigner.GetDesignTimeHtml fylls regions också med ett DesignerRegion objekt för varje klickbar eller valbar region i designtidsåtergivningen.

DetailsViewFör är den första cellen på varje rad valbar. Alla celler i raderna kan klickas.

Anteckningar till arvingar

Om du åsidosätter GetDesignTimeHtml(DesignerRegionCollection) metoden måste du anropa basmetoden eller överlagringen GetDesignTimeHtml() eftersom de slutligen, via flera åsidosättningsnivåer, anropar DetailsView kontrollen eller en kopia av kontrollen för att generera pålägget.

Se även

Gäller för