HyperLinkDesigner クラス

リファレンス

定義

名前空間:: System.Web.UI.Design.WebControls

アセンブリ:: System.Design.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

HyperLink Web サーバーコントロールに、ビジュアルデザイナーでのデザイン時サポートを提供します。

public ref class HyperLinkDesigner : System::Web::UI::Design::TextControlDesigner

public class HyperLinkDesigner : System.Web.UI.Design.TextControlDesigner

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class HyperLinkDesigner : System.Web.UI.Design.TextControlDesigner

type HyperLinkDesigner = class
    inherit TextControlDesigner

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type HyperLinkDesigner = class
    inherit TextControlDesigner

Public Class HyperLinkDesigner
Inherits TextControlDesigner

継承: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

TextControlDesigner
HyperLinkDesigner

属性: SupportsPreviewControlAttribute

例

このセクションには、2 つのコード例が含まれています。最初の例では、クラスから HyperLinkDesigner クラスを派生させ、メソッドをオーバーライドし、プロパティ値を指定する方法を示します。 2 つ目は、コントロールからコントロールを派生させ、 HyperLink 派生コントロールに属性を適用する方法を示しています。

次のコード例は、クラスからクラスを CustomHyperLinkDesigner 派生させる方法を HyperLinkDesigner 示しています。の元の値Textが空のGetDesignTimeHtml文字列 ("") の場合は、メソッドをオーバーライドしてプロパティのText既定値を指定します。これにより、関連付けられているコントロールがデザイン時に表示されるようになります。

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

次のコード例は、コントロールからコントロールをCustomHyperLink派生させ、コントロールに属性をCustomHyperLinkDesignerAttribute適用してに関連付ける方法をCustomHyperLinkDesigner示HyperLinkしています。

using System.Web;
using System.Web.UI.WebControls;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The CustomHyperLink is a copy of the HyperLink.
    // It uses the CustomHyperLinkDesigner for design-time support. 
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.
        CustomHyperLinkDesigner))]
    public class CustomHyperLink : HyperLink
    {
    } // CustomHyperLink
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The CustomHyperLink is a copy of the HyperLink.
    ' It uses the CustomHyperLinkDesigner for design-time support. 
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design. _
        CustomHyperLinkDesigner))> _
    Public Class CustomHyperLink
        Inherits HyperLink
    End Class
End Namespace ' Examples.VB.WebControls.Design

注釈

コントロールは HyperLink 、クライアントブラウザーが別の Web ページに移動するためのリンクを作成します。

ビジュアルデザイナーでは、ソースビューからデザインビューに切り替えると、コントロールを記述 HyperLink するマークアップソースコードが解析され、デザインサーフェイスにデザイン時バージョンのコントロールが作成されます。 [ソース] ビューに戻ると、デザイン時コントロールはマークアップソースコードに保持され、Web ページのマークアップに編集されます。クラスは HyperLinkDesigner 、コントロールのデザイン時のサポートを HyperLink 提供します。

メソッドは GetDesignTimeHtml 、関連付けられた HyperLink コントロールをデザイン時にレンダリングするために使用されるマークアップを返します。メソッドは OnComponentChanged 、関連付けられているコントロールに変更がある場合に呼び出されます。

コンストラクター

HyperLinkDesigner()

HyperLinkDesigner クラスの新しいインスタンスを初期化します。

プロパティ

ActionLists	コントロールデザイナーのアクションリストコレクションを取得します。 (継承元 ControlDesigner)
AllowResize	デザイン時環境でコントロールのサイズを変更できるかどうかを示す値を取得します。 (継承元 ControlDesigner)
AssociatedComponents	デザイナーで管理されているコンポーネントに関連付けられているコンポーネントのコレクションを取得します。 (継承元 ComponentDesigner)
AutoFormats	関連付けられたコントロールの [オートフォーマット] ダイアログボックスにデザイン時に表示される定義済みの自動書式指定スキームのコレクションを取得します。 (継承元 ControlDesigner)
Behavior	古い. デザイナーに関連付けられている DHTML 動作を取得または設定します。 (継承元 HtmlControlDesigner)
Component	デザイナーがデザインするコンポーネントを取得します。 (継承元 ComponentDesigner)
DataBindings	現在のコントロールのデータバインディングコレクションを取得します。 (継承元 HtmlControlDesigner)
DataBindingsEnabled	関連付けられているコントロールの格納先の領域がデータバインディングをサポートするかどうかを示す値を取得します。 (継承元 ControlDesigner)
DesignerState	デザイン時に関連付けられているコントロールのデータを永続化するために使用するオブジェクトを取得します。 (継承元 ControlDesigner)
DesignTimeElement	古い. デザインサーフェイスの HtmlControlDesigner オブジェクトと関連付けられているコントロールを表すデザイン時オブジェクトを取得します。 (継承元 HtmlControlDesigner)
DesignTimeElementView	古い. コントロールデザイナーのビューコントロールオブジェクトを取得します。 (継承元 ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	古い. デザインホストが読み込みを完了しないと GetDesignTimeHtml メソッドを呼び出すことができないかどうかを示す値を取得します。 (継承元 ControlDesigner)
Expressions	現在のコントロールの式バインディングをデザイン時に取得します。 (継承元 HtmlControlDesigner)
HidePropertiesInTemplateMode	コントロールがテンプレートモードのときに関連付けられているコントロールのプロパティが非表示に設定されるかどうかを示す値を取得します。 (継承元 ControlDesigner)
ID	コントロールの ID 文字列を取得または設定します。 (継承元 ControlDesigner)
InheritanceAttribute	関連付けられているコンポーネントの継承の種類を示す属性を取得します。 (継承元 ComponentDesigner)
Inherited	コンポーネントが継承されているかどうかを示す値を取得します。 (継承元 ComponentDesigner)
InTemplateMode	デザインホストでコントロールがテンプレート表示モードまたは編集モードのいずれかであるかどうかを示す値を取得します。 InTemplateMode プロパティは読み取り専用です。 (継承元 ControlDesigner)
IsDirty	古い. Web サーバーコントロールが変更済みとしてマークされているかどうかを示す値を取得または設定します。 (継承元 ControlDesigner)
ParentComponent	このデザイナーの親コンポーネントを取得します。 (継承元 ComponentDesigner)
ReadOnly	古い. コントロールのプロパティがデザイン時に読み取り専用かどうかを示す値を取得または設定します。 (継承元 ControlDesigner)
RootDesigner	関連付けられているコントロールを含む Web フォームページのコントロールデザイナーを取得します。 (継承元 ControlDesigner)
SetTextualDefaultProperty	HyperLink Web サーバーコントロールに、ビジュアルデザイナーでのデザイン時サポートを提供します。 (継承元 ComponentDesigner)
ShadowProperties	ユーザー設定値をオーバーライドするプロパティ値のコレクションを取得します。 (継承元 ComponentDesigner)
ShouldCodeSerialize	古い. シリアル化中に、現在のデザインドキュメントの分離コードファイル内でコントロールのフィールド宣言を作成するかどうかを示す値を取得または設定します。 (継承元 HtmlControlDesigner)
Tag	関連付けられているコントロールの HTML マークアップ要素を表すオブジェクトを取得します。 (継承元 ControlDesigner)
TemplateGroups	それぞれが 1 つまたは複数のテンプレート定義を含む、テンプレートグループのコレクションを取得します。 (継承元 ControlDesigner)
UsePreviewControl	コントロールデザイナーが一時プレビューコントロールを使用してデザイン時 HTML マークアップを生成するかどうかを示す値を取得します。 (継承元 ControlDesigner)
Verbs	デサイナに関連付けられているコンポーネントがサポートしているデザイン時の動詞を取得します。 (継承元 ComponentDesigner)
ViewControl	デザイン時 HTML マークアップのプレビュー用に使用できる Web サーバーコントロールを取得または設定します。 (継承元 ControlDesigner)
ViewControlCreated	`View` コントロールがデザインサーフェイスでの表示用に作成されているかどうかを示す値を取得または設定します。 (継承元 ControlDesigner)
Visible	コントロールがデザイン時に表示されるかどうかを示す値を取得します。 (継承元 ControlDesigner)

メソッド

CreateErrorDesignTimeHtml(String)	指定したエラーメッセージをデザイン時に表示するための HTML マークアップを作成します。 (継承元 ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)	指定した例外エラーメッセージをデザイン時に表示するための HTML マークアップを作成します。 (継承元 ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	コントロールの種類と ID を表示する単純な四角形のプレースホルダー表示を提供します。 (継承元 ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	コントロールの種類と ID を表示する単純な四角形のプレースホルダー表示を提供します。指定された追加指示または追加情報も提供します。 (継承元 ControlDesigner)
CreateViewControl()	デザインサーフェイスで表示または描画するために関連付けられているコントロールのコピーを返します。 (継承元 ControlDesigner)
Dispose()	ComponentDesigner によって使用されているすべてのリソースを解放します。 (継承元 ComponentDesigner)
Dispose(Boolean)	HtmlControlDesigner オブジェクトによって使用されているアンマネージドリソースを解放します。オプションでマネージドリソースも解放できます。 (継承元 HtmlControlDesigner)
DoDefaultAction()	コンポーネントの既定イベントに対するメソッドシグネチャをソースコードファイル内に作成し、コード内のその位置にカーソルを移動します。 (継承元 ComponentDesigner)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetBounds()	デザインサーフェイスに表示されるコントロールの境界を表す四角形の座標を取得します。 (継承元 ControlDesigner)
GetDesignTimeHtml()	デザイン時に関連付けられたコントロールを描画するために使用するマークアップを取得します。
GetDesignTimeHtml(DesignerRegionCollection)	コントロールを表示する HTML マークアップを取得し、現在のコントロールデザイナー領域をコレクションに設定します。 (継承元 ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	関連付けられたコントロールのデザイン時ビューの編集可能領域の内容を返します。 (継承元 ControlDesigner)
GetEmptyDesignTimeHtml()	実行時には視覚的な表示がない Web サーバーコントロールをデザイン時に表すための HTML マークアップを取得します。 (継承元 ControlDesigner)
GetErrorDesignTimeHtml(Exception)	指定された例外に関する情報を提供する HTML マークアップを取得します。 (継承元 ControlDesigner)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetPersistenceContent()	コントロールの永続化できる内部 HTML マークアップをデザイン時に取得します。 (継承元 ControlDesigner)
GetPersistInnerHtml()	コントロールの内部タグに永続的に適用するマークアップを取得します。 (継承元 TextControlDesigner)
GetService(Type)	デザイナーのコンポーネントのデザインモードサイトから、指定した型のサービスの取得を試みます。 (継承元 ComponentDesigner)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetViewRendering()	関連付けられているコントロールの内容および領域のデザイン時マークアップを格納しているオブジェクトを取得します。 (継承元 ControlDesigner)
Initialize(IComponent)	コンポーネントを指定して、デザイナーを初期化します。 (継承元 TextControlDesigner)
InitializeExistingComponent(IDictionary)	既存のコンポーネントを再初期化します。 (継承元 ComponentDesigner)
InitializeNewComponent(IDictionary)	新たに作成されたコンポーネントを初期化します。 (継承元 ComponentDesigner)
InitializeNonDefault()	古い. 古い. 既定値以外の値に既に初期化されている、インポートされたコンポーネントの設定値を初期化します。 (継承元 ComponentDesigner)
Invalidate()	デザインサーフェイスに表示されたコントロールの領域全体を無効化し、コントロールを再描画するようにコントロールデザイナーに通知します。 (継承元 ControlDesigner)
Invalidate(Rectangle)	デザインサーフェイスに表示されたコントロールの指定された領域を無効化し、コントロールを再描画するようにコントロールデザイナーに通知します。 (継承元 ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	指定した InheritanceAttribute の ComponentDesigner を取得します。 (継承元 ComponentDesigner)
IsPropertyBound(String)	古い. 関連付けられているコントロールの指定されたプロパティがデータバインドされているかどうかを示す値を取得します。 (継承元 ControlDesigner)
Localize(IDesignTimeResourceWriter)	提供されたリソースライターを使用して、関連付けられているコントロールのローカライズ可能なプロパティをデザインホストのリソースに永続化します。 (継承元 ControlDesigner)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnAutoFormatApplied(DesignerAutoFormat)	定義済みのオートフォーマットスキームが関連付けられているコントロールに適用されているときに呼び出されます。 (継承元 ControlDesigner)
OnBehaviorAttached()	コントロールデザイナーが Behavior オブジェクトにアタッチされていると、呼び出されます。 (継承元 ControlDesigner)
OnBehaviorDetaching()	古い. 動作と要素の関連付けが解除されたときに呼び出されます。 (継承元 HtmlControlDesigner)
OnBindingsCollectionChanged(String)	古い. データバインディングコレクションが変更されると、呼び出されます。 (継承元 ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	関連付けられているコントロールをデザイン時にユーザーがクリックすると、デザインホストによって呼び出されます。 (継承元 ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	関連付けられたコントロールに変更があった場合に呼び出されます。
OnComponentChanged(Object, ComponentChangedEventArgs)	関連付けられているコントロールが変更されたときに呼び出されます。 (継承元 ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	関連付けられているコントロールの ComponentChanging イベントを処理するメソッドを表します。 (継承元 ControlDesigner)
OnControlResize()	古い. 関連付けられている Web サーバーコントロールのサイズがデザイン時にデザインホストで変更された場合に呼び出されます。 (継承元 ControlDesigner)
OnPaint(PaintEventArgs)	CustomPaint 値が `true` の場合に、コントロールデザイナーが関連付けられているコントロールをデザインサーフェイスに描画すると呼び出されます。 (継承元 ControlDesigner)
OnSetComponentDefaults()	古い. 古い. コンポーネントの既定のプロパティを設定します。 (継承元 ComponentDesigner)
OnSetParent()	関連付けられたコントロールが親コントロールに結び付けられている場合に追加処理を実行する手段を提供します。 (継承元 HtmlControlDesigner)
PostFilterAttributes(IDictionary)	デザイナーが、TypeDescriptor を通じて公開する一連の属性から、項目を変更または削除できるようにします。 (継承元 ComponentDesigner)
PostFilterEvents(IDictionary)	デザイナーが、TypeDescriptor を通じて公開する一連のイベントから、項目を変更または削除できるようにします。 (継承元 ComponentDesigner)
PostFilterProperties(IDictionary)	デザイナーが、TypeDescriptor を通じて公開する一連のプロパティから、項目を変更または削除できるようにします。 (継承元 ComponentDesigner)
PreFilterAttributes(IDictionary)	デザイナーが、TypeDescriptor を通じて公開する一連の属性に項目を追加できるようにします。 (継承元 ComponentDesigner)
PreFilterEvents(IDictionary)	デザイン時にコンポーネントの TypeDescriptor オブジェクトに公開されているイベントのリストを設定します。 (継承元 HtmlControlDesigner)
PreFilterProperties(IDictionary)	デザイン時にデザインホストのプロパティグリッドを対象にプロパティの追加や削除を行ったり、関連付けられたコントロール上のプロパティに対応する新しいデザイン時プロパティを提供したりします。 (継承元 ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	コンポーネントが変更されたことを IComponentChangeService に通知します。 (継承元 ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	コンポーネントが変更されようとしていることを IComponentChangeService に通知します。 (継承元 ComponentDesigner)
RaiseResizeEvent()	古い. OnControlResize() イベントを発生させます。 (継承元 ControlDesigner)
RegisterClone(Object, Object)	複製が作成されたコントロールの内部データを登録します。 (継承元 ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	デザイン時にコントロールの編集可能領域の内容を指定します。 (継承元 ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)	コントロールのデザイン時ビューの編集可能領域の内容を指定します。 (継承元 ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	指定したビットごとの ViewFlags 列挙体を指定したフラグ値に割り当てます。 (継承元 ControlDesigner)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
UpdateDesignTimeHtml()	GetDesignTimeHtml メソッドを呼び出して、関連付けられている Web サーバーコントロールのデザイン時 HTML マークアップを更新します。 (継承元 ControlDesigner)

明示的なインターフェイスの実装

IDesignerFilter.PostFilterAttributes(IDictionary)	このメンバーの説明については、PostFilterAttributes(IDictionary) メソッドのトピックを参照してください。 (継承元 ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	このメンバーの説明については、PostFilterEvents(IDictionary) メソッドのトピックを参照してください。 (継承元 ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	このメンバーの説明については、PostFilterProperties(IDictionary) メソッドのトピックを参照してください。 (継承元 ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	このメンバーの説明については、PreFilterAttributes(IDictionary) メソッドのトピックを参照してください。 (継承元 ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	このメンバーの説明については、PreFilterEvents(IDictionary) メソッドのトピックを参照してください。 (継承元 ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	このメンバーの説明については、PreFilterProperties(IDictionary) メソッドのトピックを参照してください。 (継承元 ComponentDesigner)
ITreeDesigner.Children	このメンバーの説明については、Children プロパティを参照してください。 (継承元 ComponentDesigner)
ITreeDesigner.Parent	このメンバーの説明については、Parent プロパティを参照してください。 (継承元 ComponentDesigner)

適用対象

次の方法で共有