ConfigurationPropertyとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

ConfigurationProperty クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

このクラスは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

構成要素の属性または子を表します。このクラスは継承できません。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文構文

Visual Basic (宣言)
Public NotInheritable Class
 ConfigurationProperty
Visual Basic (使用法)
Dim instance As ConfigurationProperty
C#
public sealed class ConfigurationProperty
C++
public ref class ConfigurationProperty sealed
J#
public final class ConfigurationProperty
JScript
public final class ConfigurationProperty
解説解説

次の例に示す CustomSection のように、単純な ConfigurationElement の場合、ConfigurationProperty オブジェクトは、fileName などの属性を表します。

authentication など、サブセクションを含むセクションのように、もっと複雑な構成要素の場合、ConfigurationProperty オブジェクトは、属性だけでなく ConfigurationElement オブジェクトも表すことがあります。

ConfigurationPropertyCollection クラスは、構成要素の属性または ConfigurationElement オブジェクトとなる、ConfigurationProperty オブジェクトのコレクションを表します。

ConfigurationProperty クラスは、個々の構成設定を表します。このクラスを使用すると、特定の構成エンティティ (属性または要素) の名前、型、および既定値の取得または設定を行うことができ、また、属性が必須かどうか、属性が要素キーであるかどうか、または属性が既定の要素コレクションを表すかどうかを指定できます。

実装時の注意 すべての ConfigurationElement オブジェクトは、要素属性または子要素のコレクションを表す ConfigurationProperty オブジェクトの内部コレクションである ConfigurationPropertyCollection を作成します。 カスタマイズできない情報や機能は、ElementInformation プロパティが提供する ElementInformation オブジェクトに格納されます。 プログラム コーディング モデルまたは宣言 (属性付き) コーディング モデルを使用して、カスタム構成要素を作成できます。

使用例使用例

  1. カスタム セクションの作成時に ConfigurationProperty を使用する方法を次のコード例に示します。

Visual Basic
' Define a custom section.
' It shows how to use the ConfigurationProperty
' class when defining a custom section
' programmatically. 
' The variables prefixed with the
' _ sign are ConfigurationProperty types.

NotInheritable Public Class
 CustomSection
   Inherits ConfigurationSection
   
   
   ' CustomSection constructor.
   Shared Sub New()
      
      ' Initialize the _FileName
         _FileName = New ConfigurationProperty( _
         "fileName", GetType(String),
 _
         "default.txt")
      ' Initialize the _MaxUsers
         _MaxUsers = New ConfigurationProperty( _
         "maxUsers", GetType(Long),
 _
         Fix(1000), ConfigurationPropertyOptions.None)
      ' Initialize the _MaxIdleTime
         Dim minTime As TimeSpan = _
         TimeSpan.FromSeconds(30)
         Dim maxTime As TimeSpan = _
         TimeSpan.FromMinutes(5)
      
         Dim _TimeSpanValidator = _
         New TimeSpanValidator(minTime, maxTime, False)
      
         _MaxIdleTime = New ConfigurationProperty( _
         "maxIdleTime", GetType(TimeSpan),
 _
         TimeSpan.FromMinutes(5), _
         TypeDescriptor.GetConverter(GetType(TimeSpan)), _
         _TimeSpanValidator, _
         ConfigurationPropertyOptions.IsRequired, _
         "[Description:This is the max idle time.]")

         ' Initialize the _Alias
         _Alias = New ConfigurationProperty( _
         "alias", GetType(String),
 "alias.txt")
      
      
      
      ' Property collection initialization.
      ' The collection (property bag) that contains 
      ' the properties is declared as:
      ' ConfigurationPropertyCollection _Properties;
      _Properties = New ConfigurationPropertyCollection()
      ' The collection (property bag) that contains 
      ' the properties is declared as:
      ' ConfigurationPropertyCollection _Properties;
      _Properties.Add(_FileName)
      _Properties.Add(_Alias)
      _Properties.Add(_MaxUsers)
         _Properties.Add(_MaxIdleTime)

     End Sub 'New 
   
   ' Return the initialized property bag
   ' for the configuration element.
   ' The collection (property bag) that contains 
   ' the properties is declared as:
   ' ConfigurationPropertyCollection _Properties;
   
     Protected Overrides ReadOnly
 Property Properties() _
     As ConfigurationPropertyCollection
         Get
             Return _Properties
         End Get
     End Property
   
   
   ' Clear the property.
   ' It deletes all the attributes of the
   ' configuration element represented by
   ' the property.
   Public Sub ClearCollection()
      Properties.Clear()
   End Sub 'ClearCollection
   
   ' Remove an element from the property collection.
   ' It deletes the specified attribute from the
   ' configuration element represented by
   ' the property.
   Public Sub RemoveCollectionElement(elName
 As String)
      Properties.Remove(elName)
   End Sub 'RemoveCollectionElement
   
   ' Get the property collection enumerator.
   Public Function GetCollectionEnumerator()
 As IEnumerator
      Return Properties.GetEnumerator()
   End Function 'GetCollectionEnumerator
   
   
   
     <StringValidator(InvalidCharacters:= _
     " ~!@#$%^&*()[]{}/;'""|\", MinLength:=1,
 _
     MaxLength:=60)> _
     Public Property FileName() As
 String
         Get
             Return CStr(Me("fileName"))
         End Get
         Set(ByVal value As
 String)
             Me("fileName") = Value
         End Set
     End Property
   
   
     <StringValidator(InvalidCharacters:= _
     " ~!@#$%^&*()[]{}/;'""|\", MinLength:=1,
 _
     MaxLength:=60)> _
     Public Property [Alias]() As
 String
         Get
             Return CStr(Me("alias"))
         End Get
         Set(ByVal value As
 String)
             Me("alias") = Value
         End Set
     End Property
   
   
     <LongValidator(MinValue:=1, _
     MaxValue:=1000000, ExcludeRange:=False)> _
     Public Property MaxUsers() As
 Long
         Get
             Return Fix(Me("maxUsers"))
         End Get
         Set(ByVal value As
 Long)
             Me("maxUsers") = Value
         End Set
     End Property
   
   
   
   Public Property MaxIdleTime() As
 TimeSpan
      Get
         Return CType(Me("maxIdleTime"),
 TimeSpan)
      End Get
      Set
         Me("maxIdleTime") = value
      End Set
   End Property
End Class 'CustomSection
C#
// Define a custom section.
// It shows how to use the ConfigurationProperty
// class when defining a custom section
// programmatically. 
// The variables prefixed with the
// _ sign are ConfigurationProperty types.
public sealed class CustomSection :
    ConfigurationSection
{

    // CustomSection constructor.
    static CustomSection()
    {

        // Initialize the _FileName
        _FileName =
            new ConfigurationProperty("fileName",
            typeof(string), "default.txt");

        // Initialize the _MaxUsers
        _MaxUsers =
            new ConfigurationProperty("maxUsers",
            typeof(long), (long)1000,
            ConfigurationPropertyOptions.None);

        // Initialize the _MaxIdleTime
        TimeSpan minTime = TimeSpan.FromSeconds(30);
        TimeSpan maxTime = TimeSpan.FromMinutes(5);

        ConfigurationValidatorBase _TimeSpanValidator =
            new TimeSpanValidator(minTime, maxTime, false);

        _MaxIdleTime =
           new ConfigurationProperty("maxIdleTime",
       typeof(TimeSpan), TimeSpan.FromMinutes(5),
       TypeDescriptor.GetConverter(typeof(TimeSpan)),
       _TimeSpanValidator,
       ConfigurationPropertyOptions.IsRequired,
       "[Description:This is the max idle time.]");

        // Initialize the _Alias
        _Alias =
            new ConfigurationProperty("alias",
            typeof(string), "alias.txt");



        // Property collection initialization.
        // The collection (property bag) that contains 
        // the properties is declared as:
        // ConfigurationPropertyCollection _Properties;
        _Properties =
            new ConfigurationPropertyCollection();

        // The collection (property bag) that contains 
        // the properties is declared as:
        // ConfigurationPropertyCollection _Properties;
        _Properties.Add(_FileName);
        _Properties.Add(_Alias);
        _Properties.Add(_MaxUsers);
        _Properties.Add(_MaxIdleTime);

    }

    // Return the initialized property bag
    // for the configuration element.
    // The collection (property bag) that contains 
    // the properties is declared as:
    // ConfigurationPropertyCollection _Properties;
    protected override ConfigurationPropertyCollection Properties
    {
        get
        {
            return _Properties;
        }
    }


    // Clear the property.
    // It deletes all the attributes of the
    // configuration element represented by
    // the property.
    public void ClearCollection()
    {
        Properties.Clear();
    }

    // Remove an element from the property collection.
    // It deletes the specified attribute from the
    // configuration element represented by
    // the property.
    public void RemoveCollectionElement(string
 elName)
    {
        Properties.Remove(elName);
    }

    // Get the property collection enumerator.
    public IEnumerator GetCollectionEnumerator()
    {
        return (Properties.GetEnumerator());
    }

    

    [StringValidator(InvalidCharacters = " ~!@#$%^&*()[]{}/;'\"|\\"
,
        MinLength = 1, MaxLength = 60)]
    public string FileName
    {
        get
        {
            return (string)this["fileName"];
        }
        set
        {
            this["fileName"] = value;
        }
    }

    [StringValidator(InvalidCharacters = " ~!@#$%^&*()[]{}/;'\"|\\"
,
        MinLength = 1, MaxLength = 60)]
    public string Alias
    {
        get
        {
            return (string)this["alias"];
        }
        set
        {
            this["alias"] = value;
        }
    }

    [LongValidator(MinValue = 1, MaxValue = 1000000,
        ExcludeRange = false)]
    public long MaxUsers
    {
        get
        {
            return (long)this["maxUsers"];
        }
        set
        {
            this["maxUsers"] = value;
        }
    }


    public TimeSpan MaxIdleTime
    {
        get
        {
            return (TimeSpan)this["maxIdleTime"];
        }
        set
        {
            this["maxIdleTime"] = value;
        }
    }

}

上記のコード例で使用した構成の抜粋を次に示します。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="CustomSection" type="Samples.AspNet, ConfigurationProperty,
 Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" allowDefinition="Everywhere"
 allowExeDefinition="MachineToApplication" restartOnExternalChanges="true" />
  </configSections>
  <CustomSection fileName="default.txt" alias="alias.txt" maxUsers="1000"
    maxIdleTime="00:05:00" />
</configuration>

上記のセクションを作成する方法の例を次に示します。

Visual Basic
' Create a custom section.
Shared Sub CreateSection()
   Try
      
      Dim customSection As CustomSection
      
      ' Get the current configuration file.
         Dim config As System.Configuration.Configuration
 = _
         ConfigurationManager.OpenExeConfiguration( _
         ConfigurationUserLevel.None)
      
      ' Create the section entry  
      ' in the <configSections> and the 
      ' related target section in <configuration>.
      If config.Sections("CustomSection")
 Is Nothing Then
         customSection = New CustomSection()
         config.Sections.Add("CustomSection", customSection)
         customSection.SectionInformation.ForceSave = True
         config.Save(ConfigurationSaveMode.Full)
      End If
   Catch err As ConfigurationErrorsException
      Console.WriteLine(err.ToString())
   End Try
End Sub 'CreateSection
C#
// Create a custom section.
static void CreateSection()
{
    try
    {

        CustomSection customSection;

        // Get the current configuration file.
        System.Configuration.Configuration config =
                ConfigurationManager.OpenExeConfiguration(
                ConfigurationUserLevel.None);

        // Create the section entry  
        // in the <configSections> and the 
        // related target section in <configuration>.
        if (config.Sections["CustomSection"] == null)
        {
            customSection = new CustomSection();
            config.Sections.Add("CustomSection", customSection);
            customSection.SectionInformation.ForceSave = true;
            config.Save(ConfigurationSaveMode.Full);
        }
    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine(err.ToString());
    }

}
継承階層継承階層
System.Object
  System.Configuration.ConfigurationProperty
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
ConfigurationProperty メンバ
System.Configuration 名前空間
ElementInformation
ConfigurationElementCollection クラス
ConfigurationElementCollectionType 列挙体
ConfigurationElement クラス
ConfigurationPropertyCollection
ConfigurationSection

ConfigurationProperty コンストラクタ (String, Type, Object)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

このコンストラクタは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

ConfigurationProperty クラスの新しいインスタンスを作成します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    name As String, _
    type As Type, _
    defaultValue As Object _
)
Visual Basic (使用法)
Dim name As String
Dim type As Type
Dim defaultValue As Object

Dim instance As New ConfigurationProperty(name,
 type, defaultValue)
C#
public ConfigurationProperty (
    string name,
    Type type,
    Object defaultValue
)
C++
public:
ConfigurationProperty (
    String^ name, 
    Type^ type, 
    Object^ defaultValue
)
J#
public ConfigurationProperty (
    String name, 
    Type type, 
    Object defaultValue
)
JScript
public function ConfigurationProperty (
    name : String, 
    type : Type, 
    defaultValue : Object
)

パラメータ

name

構成エンティティの名前。

type

構成エンティティの型。

defaultValue

構成エンティティの既定値。

解説解説

このコンストラクタを使用して ConfigurationProperty オブジェクトをインスタンス化する場合、IsRequired プロパティおよび IsKey プロパティは false に設定されます。また、このコンストラクタを使用して作成されたインスタンスは、既定のコレクション キー プロパティとしては機能しません。

使用例使用例

System.Configuration.ConfigurationProperty(String,Type,Object) コンストラクタを使用して、構成プロパティ オブジェクトをインスタンス化する方法を次のコード例に示します。

Visual Basic
' Initialize the _FileName
   _FileName = New ConfigurationProperty( _
   "fileName", GetType(String),
 _
   "default.txt")
C#
// Initialize the _FileName
_FileName =
    new ConfigurationProperty("fileName",
    typeof(string), "default.txt");
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
ConfigurationProperty クラス
ConfigurationProperty メンバ
System.Configuration 名前空間
ElementInformation
ConfigurationElementCollection クラス
ConfigurationElementCollectionType 列挙体
ConfigurationElement クラス
ConfigurationPropertyCollection
ConfigurationSection

ConfigurationProperty コンストラクタ (String, Type, Object, ConfigurationPropertyOptions)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

このコンストラクタは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

ConfigurationProperty クラスの新しいインスタンスを作成します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    name As String, _
    type As Type, _
    defaultValue As Object, _
    options As ConfigurationPropertyOptions _
)
Visual Basic (使用法)
Dim name As String
Dim type As Type
Dim defaultValue As Object
Dim options As ConfigurationPropertyOptions

Dim instance As New ConfigurationProperty(name,
 type, defaultValue, options)
C#
public ConfigurationProperty (
    string name,
    Type type,
    Object defaultValue,
    ConfigurationPropertyOptions options
)
C++
public:
ConfigurationProperty (
    String^ name, 
    Type^ type, 
    Object^ defaultValue, 
    ConfigurationPropertyOptions options
)
J#
public ConfigurationProperty (
    String name, 
    Type type, 
    Object defaultValue, 
    ConfigurationPropertyOptions options
)
JScript
public function ConfigurationProperty (
    name : String, 
    type : Type, 
    defaultValue : Object, 
    options : ConfigurationPropertyOptions
)

パラメータ

name

構成エンティティの名前。

type

構成エンティティの型。

defaultValue

構成エンティティの既定値。

options

ConfigurationPropertyOptions 列挙値の 1 つ。

使用例使用例

System.Configuration.ConfigurationProperty(String,Type,Object,ConfigurationPropertyOptions) コンストラクタを使用して、構成プロパティ オブジェクトをインスタンス化する方法を次のコード例に示します。

Visual Basic
' Initialize the _MaxUsers
   _MaxUsers = New ConfigurationProperty( _
   "maxUsers", GetType(Long),
 _
   Fix(1000), ConfigurationPropertyOptions.None)
C#
// Initialize the _MaxUsers
_MaxUsers =
    new ConfigurationProperty("maxUsers",
    typeof(long), (long)1000,
    ConfigurationPropertyOptions.None);
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
ConfigurationProperty クラス
ConfigurationProperty メンバ
System.Configuration 名前空間
ElementInformation
ConfigurationElementCollection クラス
ConfigurationElementCollectionType 列挙体
ConfigurationElement クラス
ConfigurationPropertyCollection
ConfigurationSection

ConfigurationProperty コンストラクタ (String, Type, Object, TypeConverter, ConfigurationValidatorBase, ConfigurationPropertyOptions)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

このコンストラクタは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

ConfigurationProperty クラスの新しいインスタンスを作成します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    name As String, _
    type As Type, _
    defaultValue As Object, _
    typeConverter As TypeConverter, _
    validator As ConfigurationValidatorBase, _
    options As ConfigurationPropertyOptions _
)
Visual Basic (使用法)
Dim name As String
Dim type As Type
Dim defaultValue As Object
Dim typeConverter As TypeConverter
Dim validator As ConfigurationValidatorBase
Dim options As ConfigurationPropertyOptions

Dim instance As New ConfigurationProperty(name,
 type, defaultValue, typeConverter, validator, options)
C#
public ConfigurationProperty (
    string name,
    Type type,
    Object defaultValue,
    TypeConverter typeConverter,
    ConfigurationValidatorBase validator,
    ConfigurationPropertyOptions options
)
C++
public:
ConfigurationProperty (
    String^ name, 
    Type^ type, 
    Object^ defaultValue, 
    TypeConverter^ typeConverter, 
    ConfigurationValidatorBase^ validator, 
    ConfigurationPropertyOptions options
)
J#
public ConfigurationProperty (
    String name, 
    Type type, 
    Object defaultValue, 
    TypeConverter typeConverter, 
    ConfigurationValidatorBase validator, 
    ConfigurationPropertyOptions options
)
JScript
public function ConfigurationProperty (
    name : String, 
    type : Type, 
    defaultValue : Object, 
    typeConverter : TypeConverter, 
    validator : ConfigurationValidatorBase, 
    options : ConfigurationPropertyOptions
)

パラメータ

name

構成エンティティの名前。

type

構成エンティティの型。

defaultValue

構成エンティティの既定値。

typeConverter

適用するコンバータの型。

validator

使用する検証コントロール。

options

ConfigurationPropertyOptions 列挙値の 1 つ。

使用例使用例

System.Configuration.ConfigurationProperty(String,Type,Object,TypeConverter,ConfigurationValidatorBase,ConfigurationPropertyOptions) コンストラクタを呼び出すときに使用するパラメータの種類を次のコード例に示します。

Visual Basic
' Initialize the _MaxIdleTime
   Dim minTime As TimeSpan = _
   TimeSpan.FromSeconds(30)
   Dim maxTime As TimeSpan = _
   TimeSpan.FromMinutes(5)

   Dim _TimeSpanValidator = _
   New TimeSpanValidator(minTime, maxTime, False)

   _MaxIdleTime = New ConfigurationProperty( _
   "maxIdleTime", GetType(TimeSpan),
 _
   TimeSpan.FromMinutes(5), _
   TypeDescriptor.GetConverter(GetType(TimeSpan)), _
   _TimeSpanValidator, _
   ConfigurationPropertyOptions.IsRequired, _
   "[Description:This is the max idle time.]")
C#
 // Initialize the _MaxIdleTime
 TimeSpan minTime = TimeSpan.FromSeconds(30);
 TimeSpan maxTime = TimeSpan.FromMinutes(5);

 ConfigurationValidatorBase _TimeSpanValidator =
     new TimeSpanValidator(minTime, maxTime, false);

 _MaxIdleTime =
    new ConfigurationProperty("maxIdleTime",
typeof(TimeSpan), TimeSpan.FromMinutes(5),
TypeDescriptor.GetConverter(typeof(TimeSpan)),
_TimeSpanValidator,
ConfigurationPropertyOptions.IsRequired,
"[Description:This is the max idle time.]");
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
ConfigurationProperty クラス
ConfigurationProperty メンバ
System.Configuration 名前空間
ElementInformation
ConfigurationElementCollection クラス
ConfigurationElementCollectionType 列挙体
ConfigurationElement クラス
ConfigurationPropertyCollection
ConfigurationSection

ConfigurationProperty コンストラクタ (String, Type, Object, TypeConverter, ConfigurationValidatorBase, ConfigurationPropertyOptions, String)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

このコンストラクタは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

ConfigurationProperty クラスの新しいインスタンスを作成します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    name As String, _
    type As Type, _
    defaultValue As Object, _
    typeConverter As TypeConverter, _
    validator As ConfigurationValidatorBase, _
    options As ConfigurationPropertyOptions, _
    description As String _
)
Visual Basic (使用法)
Dim name As String
Dim type As Type
Dim defaultValue As Object
Dim typeConverter As TypeConverter
Dim validator As ConfigurationValidatorBase
Dim options As ConfigurationPropertyOptions
Dim description As String

Dim instance As New ConfigurationProperty(name,
 type, defaultValue, typeConverter, validator, options, description)
C#
public ConfigurationProperty (
    string name,
    Type type,
    Object defaultValue,
    TypeConverter typeConverter,
    ConfigurationValidatorBase validator,
    ConfigurationPropertyOptions options,
    string description
)
C++
public:
ConfigurationProperty (
    String^ name, 
    Type^ type, 
    Object^ defaultValue, 
    TypeConverter^ typeConverter, 
    ConfigurationValidatorBase^ validator, 
    ConfigurationPropertyOptions options, 
    String^ description
)
J#
public ConfigurationProperty (
    String name, 
    Type type, 
    Object defaultValue, 
    TypeConverter typeConverter, 
    ConfigurationValidatorBase validator, 
    ConfigurationPropertyOptions options, 
    String description
)
JScript
public function ConfigurationProperty (
    name : String, 
    type : Type, 
    defaultValue : Object, 
    typeConverter : TypeConverter, 
    validator : ConfigurationValidatorBase, 
    options : ConfigurationPropertyOptions, 
    description : String
)

パラメータ

name

構成エンティティの名前。

type

構成エンティティの型。

defaultValue

構成エンティティの既定値。

typeConverter

適用するコンバータの型。

validator

使用する検証コントロール。

options

ConfigurationPropertyOptions 列挙値の 1 つ。

description

構成エンティティの説明。

使用例使用例

System.Configuration.ConfigurationProperty(String,Type,Object,TypeConverter,ConfigurationValidatorBase,ConfigurationPropertyOptions,String) コンストラクタを使用して、構成プロパティ オブジェクトをインスタンス化する方法を次のコード例に示します。

Visual Basic
' Initialize the _MaxIdleTime
   Dim minTime As TimeSpan = _
   TimeSpan.FromSeconds(30)
   Dim maxTime As TimeSpan = _
   TimeSpan.FromMinutes(5)

   Dim _TimeSpanValidator = _
   New TimeSpanValidator(minTime, maxTime, False)

   _MaxIdleTime = New ConfigurationProperty( _
   "maxIdleTime", GetType(TimeSpan),
 _
   TimeSpan.FromMinutes(5), _
   TypeDescriptor.GetConverter(GetType(TimeSpan)), _
   _TimeSpanValidator, _
   ConfigurationPropertyOptions.IsRequired, _
   "[Description:This is the max idle time.]")
C#
 // Initialize the _MaxIdleTime
 TimeSpan minTime = TimeSpan.FromSeconds(30);
 TimeSpan maxTime = TimeSpan.FromMinutes(5);

 ConfigurationValidatorBase _TimeSpanValidator =
     new TimeSpanValidator(minTime, maxTime, false);

 _MaxIdleTime =
    new ConfigurationProperty("maxIdleTime",
typeof(TimeSpan), TimeSpan.FromMinutes(5),
TypeDescriptor.GetConverter(typeof(TimeSpan)),
_TimeSpanValidator,
ConfigurationPropertyOptions.IsRequired,
"[Description:This is the max idle time.]");
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
ConfigurationProperty クラス
ConfigurationProperty メンバ
System.Configuration 名前空間
ElementInformation
ConfigurationElementCollection クラス
ConfigurationElementCollectionType 列挙体
ConfigurationElement クラス
ConfigurationPropertyCollection
ConfigurationSection

ConfigurationProperty コンストラクタ (String, Type)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

このコンストラクタは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

ConfigurationProperty クラスの新しいインスタンスを作成します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    name As String, _
    type As Type _
)
Visual Basic (使用法)
Dim name As String
Dim type As Type

Dim instance As New ConfigurationProperty(name,
 type)
C#
public ConfigurationProperty (
    string name,
    Type type
)
C++
public:
ConfigurationProperty (
    String^ name, 
    Type^ type
)
J#
public ConfigurationProperty (
    String name, 
    Type type
)
JScript
public function ConfigurationProperty (
    name : String, 
    type : Type
)

パラメータ

name

構成エンティティの名前。

type

構成エンティティの型。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
ConfigurationProperty クラス
ConfigurationProperty メンバ
System.Configuration 名前空間

ConfigurationProperty コンストラクタ

この ConfigurationProperty の新しいインスタンスを作成します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
ConfigurationProperty (String, Type) ConfigurationProperty クラスの新しいインスタンスを作成します。
ConfigurationProperty (String, Type, Object) ConfigurationProperty クラスの新しいインスタンスを作成します。
ConfigurationProperty (String, Type, Object, ConfigurationPropertyOptions) ConfigurationProperty クラスの新しいインスタンスを作成します。
ConfigurationProperty (String, Type, Object, TypeConverter, ConfigurationValidatorBase, ConfigurationPropertyOptions) ConfigurationProperty クラスの新しいインスタンスを作成します。
ConfigurationProperty (String, Type, Object, TypeConverter, ConfigurationValidatorBase, ConfigurationPropertyOptions, String) ConfigurationProperty クラスの新しいインスタンスを作成します。
参照参照

関連項目

ConfigurationProperty クラス
ConfigurationProperty メンバ
System.Configuration 名前空間

ConfigurationProperty プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ Converter 構成ファイルへの書き込みを目的として、この ConfigurationProperty を XML 表現に変換するために使用する TypeConverter を取得します。
パブリック プロパティ DefaultValue この ConfigurationProperty プロパティの既定値を取得します。
パブリック プロパティ Description ConfigurationProperty に関連付けられている説明を取得します。
パブリック プロパティ IsDefaultCollection プロパティが要素の既定のコレクションであるかどうかを取得または設定します。
パブリック プロパティ IsKey この ConfigurationProperty が、格納する側の ConfigurationElement オブジェクトのキーかどうかを示す値を取得します。
パブリック プロパティ IsRequired この ConfigurationProperty が必要かどうかを示す値を取得します。
パブリック プロパティ Name この ConfigurationProperty の名前を取得します。
パブリック プロパティ Type この ConfigurationProperty オブジェクトの型を取得します。
パブリック プロパティ Validator この ConfigurationProperty オブジェクトを検証するために使用する ConfigurationValidatorAttribute を取得します。
参照参照

関連項目

ConfigurationProperty クラス
System.Configuration 名前空間
ElementInformation
ConfigurationElementCollection クラス
ConfigurationElementCollectionType 列挙体
ConfigurationElement クラス
ConfigurationPropertyCollection
ConfigurationSection

ConfigurationProperty メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
参照参照

関連項目

ConfigurationProperty クラス
System.Configuration 名前空間
ElementInformation
ConfigurationElementCollection クラス
ConfigurationElementCollectionType 列挙体
ConfigurationElement クラス
ConfigurationPropertyCollection
ConfigurationSection

ConfigurationProperty メンバ

構成要素の属性または子を表します。このクラスは継承できません。

ConfigurationProperty データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド ConfigurationProperty オーバーロードされます。 この ConfigurationProperty の新しいインスタンスを作成します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ Converter 構成ファイルへの書き込みを目的として、この ConfigurationProperty を XML 表現に変換するために使用する TypeConverter を取得します。
パブリック プロパティ DefaultValue この ConfigurationProperty プロパティの既定値を取得します。
パブリック プロパティ Description ConfigurationProperty に関連付けられている説明を取得します。
パブリック プロパティ IsDefaultCollection プロパティが要素の既定のコレクションであるかどうかを取得または設定します。
パブリック プロパティ IsKey この ConfigurationProperty が、格納する側の ConfigurationElement オブジェクトのキーかどうかを示す値を取得します。
パブリック プロパティ IsRequired この ConfigurationProperty が必要かどうかを示す値を取得します。
パブリック プロパティ Name この ConfigurationProperty の名前を取得します。
パブリック プロパティ Type この ConfigurationProperty オブジェクトの型を取得します。
パブリック プロパティ Validator この ConfigurationProperty オブジェクトを検証するために使用する ConfigurationValidatorAttribute を取得します。
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
参照参照

関連項目

ConfigurationProperty クラス
System.Configuration 名前空間
ElementInformation
ConfigurationElementCollection クラス
ConfigurationElementCollectionType 列挙体
ConfigurationElement クラス
ConfigurationPropertyCollection
ConfigurationSection

急上昇のことば

蒙る
筆まめ
矢口アサミ
寂寥
おろそか

英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「ConfigurationProperty」の関連用語

1
ConfigurationProperty コンストラクタ
.NET Framework クラス ライブラリ リファレンス
100% |||||

2
ConfigurationProperty プロパティ
.NET Framework クラス ライブラリ リファレンス
96% |||||

3
ConfigurationPropertyCollection.CopyTo メソッド
.NET Framework クラス ライブラリ リファレンス
78% |||||

4
ConfigurationPropertyCollection.Item プロパティ
.NET Framework クラス ライブラリ リファレンス
74% |||||

5
ConfigurationPropertyCollection.Add メソッド
.NET Framework クラス ライブラリ リファレンス
70% |||||

6
ConfigurationProperty メンバ
.NET Framework クラス ライブラリ リファレンス
58% |||||

7
ConfigurationElement.Item プロパティ
.NET Framework クラス ライブラリ リファレンス
56% |||||

8
ConfigurationElement.SetPropertyValue メソッド
.NET Framework クラス ライブラリ リファレンス
56% |||||

9
ConfigurationProperty.Validator プロパティ
.NET Framework クラス ライブラリ リファレンス
54% |||||

10
ConfigurationProperty.Converter プロパティ
.NET Framework クラス ライブラリ リファレンス
52% |||||

ConfigurationPropertyのお隣キーワード

ConfigurationPermissionAttribute クラス

ConfigurationPermissionAttribute コンストラクタ

ConfigurationPermissionAttribute プロパティ

ConfigurationPermissionAttribute メソッド

ConfigurationPermissionAttribute メンバ

ConfigurationPermissionAttribute.CreatePermission メソッド

ConfigurationProperty

ConfigurationPropertyAttribute クラス

ConfigurationPropertyAttribute コンストラクタ

ConfigurationPropertyAttribute プロパティ

ConfigurationPropertyAttribute メソッド

ConfigurationPropertyAttribute メンバ

ConfigurationPropertyAttribute.DefaultValue プロパティ

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


ConfigurationPropertyのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS