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 атрибут, указывающий свойство по умолчанию к пользовательскому элементу управления. Этот конструктор вызывается внутри ASP.NET для создания ControlValuePropertyAttribute объекта, представляющего атрибут.
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 атрибут, указывающий свойство и значение по умолчанию к пользовательскому элементу управления. Этот конструктор вызывается внутри ASP.NET для создания ControlValuePropertyAttribute объекта, представляющего атрибут.
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
Свойство, используемое по умолчанию для элемента управления.
- defaultValue
- String
Значение по умолчанию для используемого по умолчанию свойства.
Комментарии
Используйте этот конструктор для создания нового экземпляра ControlValuePropertyAttribute класса, используя указанное имя свойства и значение по умолчанию. Эта версия конструктора также пытается преобразовать значение по умолчанию в тип данных, заданный параметром type
. Если значение по умолчанию невозможно преобразовать, DefaultValue свойство не задано. В следующей таблице представлены исходные значения свойств для экземпляра класса ControlValuePropertyAttribute.
Свойство. | Начальное значение |
---|---|
Name | Значение параметра name . |
DefaultValue | Значение defaultValue параметра, если значение можно преобразовать в тип данных, заданный параметром type . |