LoginStatusDesigner クラス

定義

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

public ref class LoginStatusDesigner : System::Web::UI::Design::WebControls::CompositeControlDesigner
public class LoginStatusDesigner : System.Web.UI.Design.WebControls.CompositeControlDesigner
type LoginStatusDesigner = class
    inherit CompositeControlDesigner
Public Class LoginStatusDesigner
Inherits CompositeControlDesigner
継承

次のコード例は、 クラスを拡張して、 LoginStatusDesigner デザイン時にコントロールから派生したコントロールの外観を変更する方法を LoginStatus 示しています。

この例では、 からコントロールをMyLoginStatusLoginStatus派生させます。 MyLoginStatusはコントロールのLoginStatusコピーです。 この例では、 から クラスをMyLoginStatusDesigner派生させ、 コントロールに のMyLoginStatusDesigner属性をMyLoginStatus適用DesignerAttributeします。LoginStatusDesigner

MyLoginStatusDesigner プロパティが GetDesignTimeHtml または None 値の場合BorderStyleは、 メソッドをオーバーライドして、コントロールの周囲に青い破線のMyLoginStatus境界線をNotSet描画して、より見えるようにします。

using System;
using System.Web;
using System.Drawing;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.IO;

namespace Examples.CS.WebControls.Design
{
    // The MyLoginStatus is a copy of the LoginStatus.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyLoginStatusDesigner))]
    public class MyLoginStatus : LoginStatus
    {
    } // MyLoginStatus

    // Override members of the LoginStatusDesigner.
    public class MyLoginStatusDesigner : LoginStatusDesigner
    {
        // 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. 
            MyLoginStatus myLoginStatusCtl = (MyLoginStatus)ViewControl;
            string markup = null;

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

                // Set the design time properties and catch any exceptions.
                try
                {
                    myLoginStatusCtl.BorderStyle = BorderStyle.Dashed;
                    myLoginStatusCtl.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
    } // MyLoginStatusDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Drawing
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The MyLoginStatus is a copy of the LoginStatus.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyLoginStatusDesigner))> _
    Public Class MyLoginStatus
        Inherits LoginStatus
    End Class

    ' Override members of the LoginStatusDesigner.
    Public Class MyLoginStatusDesigner
        Inherits LoginStatusDesigner

        ' 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 myLoginStatusCtl As MyLoginStatus = _
                CType(ViewControl, MyLoginStatus)
            Dim markup As String = Nothing

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

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

                ' Set the design time properties and catch any exceptions.
                Try
                    myLoginStatusCtl.BorderStyle = BorderStyle.Dashed
                    myLoginStatusCtl.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
    End Class
End Namespace ' Examples.VB.WebControls.Design

注釈

コントロールは LoginStatus 、ユーザーの認証状態を自動的にチェックし、適切なログインまたはログアウト オプションを表示するボタンをレンダリングします。

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

プロパティは ActionLists 、通常、デザイナーの DesignerActionListCollection 継承ツリーの各レベルの クラスから DesignerActionList 派生した オブジェクトを含む オブジェクトを返します。 プロパティは UsePreviewControl 常に を返 trueします。これは、デザイン時にユーザー認証の状態が使用できないので、デザイナーが関連付けられている LoginStatus の一時的なコピーを作成してデザイン時マークアップを生成することを示します。

メソッドは GetDesignTimeHtml 、デザイン時に関連付けられた LoginStatus をレンダリングするために使用されるマークアップを返します。 メソッドは Initialize 、デザイナーが、関連付けられている LoginStatusを表示、編集、およびデザインできるように準備します。

コンストラクター

LoginStatusDesigner()

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

プロパティ

ActionLists

このデザイナーのデザイナー アクション リスト コレクションを取得します。

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

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

(継承元 ComponentDesigner)
ShadowProperties

ユーザー設定値をオーバーライドするプロパティ値のコレクションを取得します。

(継承元 ComponentDesigner)
ShouldCodeSerialize
古い.

シリアル化中に、現在のデザイン ドキュメントの分離コード ファイル内でコントロールのフィールド宣言を作成するかどうかを示す値を取得または設定します。

(継承元 HtmlControlDesigner)
Tag

関連付けられているコントロールの HTML マークアップ要素を表すオブジェクトを取得します。

(継承元 ControlDesigner)
TemplateGroups

それぞれが 1 つまたは複数のテンプレート定義を含む、テンプレート グループのコレクションを取得します。

(継承元 ControlDesigner)
UsePreviewControl

デザイン時のマークアップを生成するときに、デザイナーが関連付けられた実際のコントロールではなく、一時的なコピーを使用するかどうかを示す値を取得します。

Verbs

デサイナに関連付けられているコンポーネントがサポートしているデザイン時の動詞を取得します。

(継承元 ComponentDesigner)
ViewControl

デザイン時 HTML マークアップのプレビュー用に使用できる Web サーバー コントロールを取得または設定します。

(継承元 ControlDesigner)
ViewControlCreated

View コントロールがデザイン サーフェイスでの表示用に作成されているかどうかを示す値を取得または設定します。

(継承元 ControlDesigner)
Visible

コントロールがデザイン時に表示されるかどうかを示す値を取得します。

(継承元 ControlDesigner)

メソッド

CreateChildControls()

対象の CompositeControl コントロールの子コントロールを作成します。

(継承元 CompositeControlDesigner)
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()
古い.

コントロールの永続化できる内部 HTML マークアップを取得します。

(継承元 ControlDesigner)
GetService(Type)

デザイナーのコンポーネントのデザイン モード サイトから、指定した型のサービスの取得を試みます。

(継承元 ComponentDesigner)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
GetViewRendering()

関連付けられているコントロールの内容および領域のデザイン時マークアップを格納しているオブジェクトを取得します。

(継承元 ControlDesigner)
Initialize(IComponent)

関連付けられたコントロールをデザイナーで表示、編集、デザインできるように準備します。

InitializeExistingComponent(IDictionary)

既存のコンポーネントを再初期化します。

(継承元 ComponentDesigner)
InitializeNewComponent(IDictionary)

新たに作成されたコンポーネントを初期化します。

(継承元 ComponentDesigner)
InitializeNonDefault()
古い.
古い.

既定値以外の値に既に初期化されている、インポートされたコンポーネントの設定値を初期化します。

(継承元 ComponentDesigner)
Invalidate()

デザイン サーフェイスに表示されたコントロールの領域全体を無効化し、コントロールを再描画するようにコントロール デザイナーに通知します。

(継承元 ControlDesigner)
Invalidate(Rectangle)

デザイン サーフェイスに表示されたコントロールの指定された領域を無効化し、コントロールを再描画するようにコントロール デザイナーに通知します。

(継承元 ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)

指定した InheritanceAttributeComponentDesigner を取得します。

(継承元 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)

関連付けられているコントロールが変更されたときに呼び出されます。

(継承元 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)

適用対象

こちらもご覧ください