次の方法で共有

HyperLinkDesigner.GetDesignTimeHtml メソッド

デザイン時にコントロールを表すために使用する HTML を取得します。

Overrides Public Function GetDesignTimeHtml() As String
[C#]
public override string GetDesignTimeHtml();
[C++]
public: String* GetDesignTimeHtml();
[JScript]
public override function GetDesignTimeHtml() : String;

戻り値

デザイン時にコントロールを表すために使用する HTML。

解説

このメソッドは、 HyperLink コントロールの Text プロパティと href プロパティがデータ連結されているかどうかを確認します。プロパティがデータ連結されている場合、このメソッドは Text プロパティの値を "DataBound" に設定し、 href プロパティがデータ連結されている場合、このメソッドはプロパティの値をテキスト文字列に設定して、コントロールに有効なハイパーリンクのような外観を持たせます。

使用例

[Visual Basic] CustomHyperLinkDesigner という名前のクラスを HyperLinkDesigner クラスから継承して作成するコード例を次に示します。このクラスは、デザイン時に CustomHyperLink クラスを表示するために使用します。このクラスは GetDesignTimeHtml メソッドをオーバーライドします。これにより、ユーザーが Text プロパティの値を設定していない場合でも、このプロパティに対するカスタマイズされた値がデザイン画面に表示されるようにします。

[Visual Basic] このコード例は、 HyperLinkDesigner クラスのトピックで取り上げているコード例の一部分です。

 
' Create a class, named CustomHyperLinkDesigner,
' that derives from the HyperLinkDesigner class.
' This new class displays the custom class,
' CustomHyperLink at design time.
 Public Class CustomHyperLinkDesigner
   Inherits HyperLinkDesigner
   
   
   ' Override the GetDesignTimeHtml method to set the 
   ' string property values of the CustomHyperLink class
   ' so that they will display at design time.
   Public Overrides Function GetDesignTimeHtml() As String
      Dim hl As CustomHyperLink = CType(Component, CustomHyperLink)
      
      Dim designTimeHtml As String = Nothing
      
      Dim text As String = hl.Text
      Dim noText As Boolean = (text.Trim().Length = 0)
      
      Try         
         If noText Then
            hl.Text = "Click here."
         End If 
            
         designTimeHtml = MyBase.GetDesignTimeHtml()
         
      Catch e As New Exception()
         designTimeHtml=GetErrorDesignTimeHtml(e)
      Finally
         If noText Then
           hl.Text = text
         End If
      End Try
      
      If ((designTimeHtml = Nothing) Or (designTimeHtml.Length = 0)) Then
         designTimeHtml = GetEmptyDesignTimeHtml()
      End If
      
      Return designTimeHtml
      
   End Function 
 End Class

[C#, C++, JScript] C#、C++、および JScript のサンプルはありません。Visual Basic のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

HyperLinkDesigner クラス | HyperLinkDesigner メンバ | System.Web.UI.Design.WebControls 名前空間 | HyperLink