ControlValuePropertyAttribute コンストラクター

定義

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

オーバーロード

ControlValuePropertyAttribute(String)

指定したプロパティ名を使用して、ControlValuePropertyAttribute クラスの新しいインスタンスを初期化します。

ControlValuePropertyAttribute(String, Object)

指定したプロパティ名と既定値を使用して、ControlValuePropertyAttribute クラスの新しいインスタンスを初期化します。

ControlValuePropertyAttribute(String, Type, String)

指定したプロパティ名と既定値を使用して、ControlValuePropertyAttribute クラスの新しいインスタンスを初期化します。 既定値は指定したデータ型に変換されます。

ControlValuePropertyAttribute(String)

指定したプロパティ名を使用して、ControlValuePropertyAttribute クラスの新しいインスタンスを初期化します。

public:
 ControlValuePropertyAttribute(System::String ^ name);
public ControlValuePropertyAttribute (string name);
new System.Web.UI.ControlValuePropertyAttribute : string -> System.Web.UI.ControlValuePropertyAttribute
Public Sub New (name As String)

パラメーター

name
String

コントロールの既定のプロパティ。

次のコード例は、カスタム コントロールに既定のプロパティを ControlValuePropertyAttribute 指定する属性を適用する方法を示しています。 このコンストラクターは、属性を表すオブジェクトを作成ControlValuePropertyAttributeするために ASP.NET によって内部的に呼び出されます。


using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS.Controls
{
    // Set ControlValueProperty attribute to specify the default
    // property of this control that a ControlParameter object 
    // binds to at run time.
    [DefaultProperty("Text")]
    [ControlValueProperty("Text")]
    public class SimpleCustomControl : WebControl
    {
        private string text;

        [Bindable(true)]
        [Category("Appearance")]
        [DefaultValue("")]
        public string Text
        {
            get
            {
                return text;
            }
            set
            {
                text = value;
            }
        }

        protected override void Render(HtmlTextWriter output)
        {
            output.Write(Text);
        }
    }
}

Imports System.ComponentModel
Imports System.Web.UI

Namespace Samples.AspNet.VB.Controls

    ' Set ControlValueProperty attribute to specify the default
    ' property of this control that a ControlParameter object 
    ' binds to at run time.
    <DefaultProperty("Text"), ControlValueProperty("Text")> Public Class SimpleCustomControl
        Inherits System.Web.UI.WebControls.WebControl

        Dim _text As String

        <Bindable(True), Category("Appearance"), DefaultValue("")> Property [Text]() As String
            Get
                Return _text
            End Get

            Set(ByVal Value As String)
                _text = Value
            End Set
        End Property

        Protected Overrides Sub Render(ByVal output As System.Web.UI.HtmlTextWriter)
            output.Write([Text])
        End Sub

    End Class

End Namespace

注釈

このコンストラクターを使用して、指定したプロパティ名を ControlValuePropertyAttribute 使用してクラスの新しいインスタンスを作成します。 次の表は、クラスのインスタンスの初期プロパティ値を ControlValuePropertyAttribute 示しています。

プロパティ 初期値
Name name パラメーターの値。

こちらもご覧ください

適用対象

ControlValuePropertyAttribute(String, Object)

指定したプロパティ名と既定値を使用して、ControlValuePropertyAttribute クラスの新しいインスタンスを初期化します。

public:
 ControlValuePropertyAttribute(System::String ^ name, System::Object ^ defaultValue);
public ControlValuePropertyAttribute (string name, object defaultValue);
new System.Web.UI.ControlValuePropertyAttribute : string * obj -> System.Web.UI.ControlValuePropertyAttribute
Public Sub New (name As String, defaultValue As Object)

パラメーター

name
String

コントロールの既定のプロパティ。

defaultValue
Object

既定のプロパティの既定値。

次のコード例では、既定のプロパティと値を ControlValuePropertyAttribute 指定する属性をカスタム コントロールに適用する方法を示します。 このコンストラクターは、属性を表すオブジェクトを作成ControlValuePropertyAttributeするために ASP.NET によって内部的に呼び出されます。


using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS.Controls
{
    // Set ControlValueProperty attribute to specify the default
    // property of this control that a ControlParameter object 
    // binds to at run time.
    [DefaultProperty("Text")]
    [ControlValueProperty("Text", "Default Text")]
    public class SimpleCustomControl : WebControl
    {
        private string text;

        [Bindable(true)]
        [Category("Appearance")]
        [DefaultValue("")]
        public string Text
        {
            get
            {
                return text;
            }
            set
            {
                text = value;
            }
        }

        protected override void Render(HtmlTextWriter output)
        {
            output.Write(Text);
        }
    }
}

Imports System.ComponentModel
Imports System.Web.UI

Namespace Samples.AspNet.VB.Controls

    ' Set ControlValueProperty attribute to specify the default
    ' property of this control that a ControlParameter object 
    ' binds to at run time.
    <DefaultProperty("Text"), ControlValueProperty("Text", "DefaultText")> Public Class SimpleCustomControl
        Inherits System.Web.UI.WebControls.WebControl

        Dim _text As String

        <Bindable(True), Category("Appearance"), DefaultValue("")> Property [Text]() As String
            Get
                Return _text
            End Get

            Set(ByVal Value As String)
                _text = Value
            End Set
        End Property

        Protected Overrides Sub Render(ByVal output As System.Web.UI.HtmlTextWriter)
            output.Write([Text])
        End Sub

    End Class

End Namespace

注釈

このコンストラクターを使用して、指定したプロパティ名と既定値を ControlValuePropertyAttribute 使用してクラスの新しいインスタンスを作成します。 ControlValuePropertyAttribute クラスのインスタンスのプロパティの初期値を次の表に示します。

プロパティ 初期値
Name name パラメーターの値。
DefaultValue defaultValue パラメーターの値。

こちらもご覧ください

適用対象

ControlValuePropertyAttribute(String, Type, String)

指定したプロパティ名と既定値を使用して、ControlValuePropertyAttribute クラスの新しいインスタンスを初期化します。 既定値は指定したデータ型に変換されます。

public:
 ControlValuePropertyAttribute(System::String ^ name, Type ^ type, System::String ^ defaultValue);
public ControlValuePropertyAttribute (string name, Type type, string defaultValue);
new System.Web.UI.ControlValuePropertyAttribute : string * Type * string -> System.Web.UI.ControlValuePropertyAttribute
Public Sub New (name As String, type As Type, defaultValue As String)

パラメーター

name
String

コントロールの既定のプロパティ。

type
Type

既定値の変換先となる Type

defaultValue
String

既定のプロパティの既定値。

注釈

このコンストラクターを使用して、指定したプロパティ名と既定値を ControlValuePropertyAttribute 使用してクラスの新しいインスタンスを作成します。 また、このバージョンのコンストラクターは、既定値をパラメーターで type 指定されたデータ型に変換しようとします。 既定値を変換できない場合、 DefaultValue プロパティは設定されません。 ControlValuePropertyAttribute クラスのインスタンスのプロパティの初期値を次の表に示します。

プロパティ 初期値
Name name パラメーターの値。
DefaultValue パラメーターで defaultValue 指定されたデータ型に値を変換できる場合のパラメーターの type 値。

こちらもご覧ください

適用対象