ExpandableObjectConverter 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供型別轉換器，可將可展開物件轉換為各種其他表示方式。
public ref class ExpandableObjectConverter : System::ComponentModel::TypeConverterpublic class ExpandableObjectConverter : System.ComponentModel.TypeConvertertype ExpandableObjectConverter = class
inherit TypeConverterPublic Class ExpandableObjectConverter
Inherits TypeConverter- 繼承
- 衍生
範例
以下程式碼範例將一個型態 Margins 的變數轉換成字串變數。
String^ strM = "1,2,3,4";
System::Drawing::Printing::Margins^ m = gcnew System::Drawing::Printing::Margins( 1,2,3,4 );
Console::WriteLine( TypeDescriptor::GetConverter( strM )->CanConvertTo( System::Drawing::Printing::Margins::typeid ) );
Console::WriteLine( TypeDescriptor::GetConverter( m )->ConvertToString( m ) );
string strM = "1,2,3,4";
System.Drawing.Printing.Margins m = new(1, 2, 3, 4);
Console.WriteLine(TypeDescriptor.GetConverter(strM).CanConvertTo(typeof(System.Drawing.Printing.Margins)));
Console.WriteLine(TypeDescriptor.GetConverter(m).ConvertToString(m));
Dim strM As String
strM = "1,2,3,4"
Dim m As New System.Drawing.Printing.Margins(1, 2, 3, 4)
Console.WriteLine(TypeDescriptor.GetConverter(strM).CanConvertTo(GetType(System.Drawing.Printing.Margins)))
Console.WriteLine(TypeDescriptor.GetConverter(m).ConvertToString(m))
以下程式碼範例示範如何使用 NotifyParentPropertyAttribute 和 類別 ExpandableObjectConverter ，在自訂控制項上建立可展開的屬性。 此程式碼範例是本類別更大範例 NotifyParentPropertyAttribute 的一部分。
[TypeConverter(typeof(BorderAppearanceConverter))]
public class BorderAppearance
{
int borderSizeValue = 1;
Color borderColorValue = Color.Empty;
[Browsable(true),
NotifyParentProperty(true),
EditorBrowsable(EditorBrowsableState.Always),
DefaultValue(1)]
public int BorderSize
{
get => borderSizeValue;
set
{
if (value < 0)
{
throw new ArgumentOutOfRangeException(
"BorderSize",
value,
"must be >= 0");
}
if (borderSizeValue != value)
{
borderSizeValue = value;
}
}
}
[Browsable(true)]
[NotifyParentProperty(true)]
[EditorBrowsable(EditorBrowsableState.Always)]
[DefaultValue(typeof(Color), "")]
public Color BorderColor
{
get => borderColorValue;
set
{
if (value.Equals(Color.Transparent))
{
throw new NotSupportedException("Transparent colors are not supported.");
}
if (borderColorValue != value)
{
borderColorValue = value;
}
}
}
}
<TypeConverter(GetType(BorderAppearanceConverter))> _
Public Class BorderAppearance
Private borderSizeValue As Integer = 1
Private borderColorValue As Color = Color.Empty
<Browsable(True), NotifyParentProperty(True), EditorBrowsable(EditorBrowsableState.Always), DefaultValue(1)> _
Public Property BorderSize() As Integer
Get
Return borderSizeValue
End Get
Set
If value < 0 Then
Throw New ArgumentOutOfRangeException("BorderSize", value, "must be >= 0")
End If
If borderSizeValue <> value Then
borderSizeValue = value
End If
End Set
End Property
<Browsable(True), NotifyParentProperty(True), EditorBrowsable(EditorBrowsableState.Always), DefaultValue(GetType(Color), "")> _
Public Property BorderColor() As Color
Get
Return borderColorValue
End Get
Set
If value.Equals(Color.Transparent) Then
Throw New NotSupportedException("Transparent colors are not supported.")
End If
If borderColorValue <> value Then
borderColorValue = value
End If
End Set
End Property
End Class
備註
此類別在 所提供 TypeConverter的方法與屬性之外，新增了對物件屬性的支援。 為了使某類型的性質在 中PropertyGrid可展開，請GetPropertiesSupported對 和 GetProperties的標準實作指定此TypeConverter點。 用 標記子屬性 NotifyParentPropertyAttribute ，以確保控制項中的 PropertyGrid 正確行為。
備註
你絕對不應該直接使用字型轉換器。 相反地，請使用 TypeDescriptor相應的轉換器。 更多資訊請參閱基底類別中的範例 TypeConverter 。
欲了解更多類型轉換器的資訊，請參閱 TypeConverter 基底類別。
建構函式
| 名稱 | Description |
|---|---|
| ExpandableObjectConverter() |
初始化 ExpandableObjectConverter 類別的新執行個體。 |
