LoginDesigner.GetDesignTimeHtml(DesignerRegionCollection) Methode

Definitie

Naamruimte:
System.Web.UI.Design.WebControls
Assembly:
System.Design.dll

Hiermee haalt u de markering op die wordt gebruikt om het bijbehorende besturingselement op het ontwerptijd weer te geven en wordt een verzameling ontwerpregio's ingevuld.

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

Parameters

regions
DesignerRegionCollection

Een DesignerRegionCollection definitie van de selecteerbare en klikbare regio's in de ontwerptijdweergave van het besturingselement worden toegevoegd.

Retouren

String

Een tekenreeks met de markeringen die worden gebruikt om de Login ontwerptijd weer te geven.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de GetDesignTimeHtml methode in een klasse overschrijft die wordt overgenomen van de LoginDesigner klasse om het uiterlijk te wijzigen van een besturingselement dat tijdens het ontwerp is afgeleid van het Login besturingselement. In het voorbeeld wordt een blauwe, stippelrand rond het besturingselement tekend om de omvang ervan beter zichtbaar te maken als de BorderStyle eigenschap van het besturingselement de NotSet of None waarde is.

// Generate the design-time markup.
public override string GetDesignTimeHtml()
{
    // Make the control more visible in the designer.  If the border 
    // style is None or NotSet, change the border to a blue dashed line. 
    MyLogin myLoginCtl = (MyLogin)ViewControl;
    string markup = null;

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

        // Set the design time properties and catch any exceptions.
        try
        {
            myLoginCtl.BorderStyle = BorderStyle.Dashed;
            myLoginCtl.BorderColor = Color.Blue;

            // Call the base method to generate the markup.
            markup = base.GetDesignTimeHtml();
        }
        catch (Exception ex)
        {
            markup = GetErrorDesignTimeHtml(ex);
        }
        finally
        {
            // It is not necessary to restore the border properties 
            // to their original values because the ViewControl 
            // was used to reference the associated control and the 
            // UsePreviewControl was not overridden.  

            // myLoginCtl.BorderStyle = oldBorderStyle;
            // myLoginCtl.BorderColor = oldBorderColor;
        }
    }
    else
    {
        // Call the base method to generate the markup.
        markup = base.GetDesignTimeHtml();
    }

    return markup;
} // GetDesignTimeHtml

' Generate the design-time markup.
Public Overrides Function GetDesignTimeHtml() As String

    ' Make the control more visible in the designer.  If the border 
    ' style is None or NotSet, change the border to a blue dashed line. 
    Dim myLoginCtl As MyLogin = CType(ViewControl, MyLogin)
    Dim markup As String = Nothing

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

        Dim oldBorderStyle As BorderStyle = myLoginCtl.BorderStyle
        Dim oldBorderColor As Color = myLoginCtl.BorderColor

        ' Set the design time properties and catch any exceptions.
        Try
            myLoginCtl.BorderStyle = BorderStyle.Dashed
            myLoginCtl.BorderColor = Color.Blue

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

        Catch ex As Exception
            markup = GetErrorDesignTimeHtml(ex)

        Finally
            ' It is not necessary to restore the border properties 
            ' to their original values because the ViewControl 
            ' was used to reference the associated control and the 
            ' UsePreviewControl was not overridden.  

            ' myLoginCtl.BorderStyle = oldBorderStyle
            ' myLoginCtl.BorderColor = oldBorderColor
        End Try

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

    Return markup

End Function ' GetDesignTimeHtml

Opmerkingen

De GetDesignTimeHtml methode maakt een EditableDesignerRegion object voor de eigenschap van het LayoutTemplate gekoppelde Login besturingselement en voegt dit toe aan het DesignerRegionCollection object waarnaar wordt verwezen door de regions parameter. De GetDesignTimeHtml methode gebruikt de GetDesignTimeHtml basismethode om de opmaak te genereren voor de ontwerptijdweergave van het Login besturingselement.

Notities voor overnemers

Als u de GetDesignTimeHtml(DesignerRegionCollection) methode overschrijft, moet u de GetDesignTimeHtml() basismethode aanroepen, omdat deze uiteindelijk, via verschillende onderdrukkingsniveaus, het Login besturingselement of een kopie van het besturingselement aanroept om de opmaak te genereren.

Van toepassing op

Zie ook