Aracılığıyla paylaş

HyperLinkDesigner.GetDesignTimeHtml Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.Design.WebControls
Bütünleştirilmiş Kod:
System.Design.dll

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

Tasarım zamanında ilişkili köprü denetimini işlemek için kullanılan işaretlemeyi içeren bir dize.

Örnekler

Aşağıdaki kod örneği, sınıfından sınıfın CustomHyperLinkDesigner HyperLinkDesigner nasıl türetilmiş olduğunu gösterir. özgün değeri boş bir dize ("") ise özelliği için Text varsayılan bir değer sağlamak için Text yöntemini geçersiz kılarGetDesignTimeHtml. Bu, ilişkili denetimin tasarım zamanında görünür olmasını sağlar.

Bu kod örneği, sınıfı için HyperLinkDesigner sağlanan daha büyük bir örneğin parçasıdır.

// Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
public class CustomHyperLinkDesigner : HyperLinkDesigner
{
    // Override the GetDesignTimeHtml to set the CustomHyperLink Text 
    // property so that it displays at design time.
    public override string GetDesignTimeHtml()
    {
        CustomHyperLink hype = (CustomHyperLink)Component;
        string designTimeMarkup = null;

        // Save the original Text and note if it is empty.
        string text = hype.Text;
        bool noText = (text.Trim().Length == 0);

        try
        {
            // If the Text is empty, supply a default value.
            if (noText)
                hype.Text = "Click here.";

            // Call the base method to generate the markup.
            designTimeMarkup = base.GetDesignTimeHtml();
        }
        catch (Exception ex)
        {
            // If an error occurs, generate the markup for an error message.
            designTimeMarkup = GetErrorDesignTimeHtml(ex);
        }
        finally
        {
            // Restore the original value of the Text, if necessary.
            if (noText)
                hype.Text = text;
        }

        // If the markup is empty, generate the markup for a placeholder.
        if(designTimeMarkup == null || designTimeMarkup.Length == 0)
            designTimeMarkup = GetEmptyDesignTimeHtml();

        return designTimeMarkup;
    } // GetDesignTimeHtml
} // CustomHyperLinkDesigner

' Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
Public Class CustomHyperLinkDesigner
    Inherits HyperLinkDesigner

    ' Override the GetDesignTimeHtml to set the CustomHyperLink Text
    ' property so that it displays at design time.
    Public Overrides Function GetDesignTimeHtml() As String

        Dim hype As CustomHyperLink = CType(Component, CustomHyperLink)
        Dim designTimeMarkup As String = Nothing

        ' Save the original Text and note if it is empty.
        Dim text As String = hype.Text
        Dim noText As Boolean = (text.Trim().Length = 0)

        Try
            ' If the Text is empty, supply a default value.
            If noText Then
                hype.Text = "Click here."
            End If

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

        Catch ex As Exception
            ' If an error occurs, generate the markup for an error message.
            designTimeMarkup = GetErrorDesignTimeHtml(ex)

        Finally
            ' Restore the original value of the Text, if necessary.
            If noText Then
                hype.Text = text
            End If
        End Try

        ' If the markup is empty, generate the markup for a placeholder.
        If ((designTimeMarkup = Nothing) Or _
            (designTimeMarkup.Length = 0)) Then
            designTimeMarkup = GetEmptyDesignTimeHtml()
        End If

        Return designTimeMarkup

    End Function ' GetDesignTimeHtml
End Class

Açıklamalar

yöntemi, GetDesignTimeHtml ilişkili HyperLink denetim için tasarım zamanı işaretlemesini oluşturur. yöntemi önce , NavigateUrlve özelliklerinin yerel kopyalarını Textve ImageUrl alt Controls koleksiyonu kaydeder. Özgün değerler veya boşsa bu özellikler için varsayılan değerler null sağlar. Yöntemi GetDesignTimeHtml daha sonra işaretlemeyi oluşturmak için temel yöntemi çağırır GetDesignTimeHtml ve gerekirse özellikleri ve alt denetim koleksiyonunu özgün değerlerine geri yükler.

Şunlara uygulanır

Ayrıca bkz.