ElementInformation.IsCollection プロパティ

.NET Framework クラス ライブラリ リファレンス

ElementInformation.IsCollection プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

関連付けられている ConfigurationElement オブジェクトが ConfigurationElementCollection コレクションであるかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 IsCollection As Boolean

Visual Basic (使用法)

Dim instance As ElementInformation
Dim value As Boolean

value = instance.IsCollection

C#

public bool IsCollection { get;
 }

C++

public:
property bool IsCollection {
    bool get ();
}

J#

/** @property */
public boolean get_IsCollection ()

JScript

public function get IsCollection
 () : boolean

プロパティ値
関連付けられている ConfigurationElement オブジェクトが ConfigurationElementCollection コレクションである場合は true。それ以外の場合は false。

使用例

IsCollection プロパティを使用する方法を次のコード例に示します。

Visual Basic

Imports System
Imports System.Configuration
Imports System.Collections




' Define a custom section containing 
' a simple element and a collection of 
' the same element. It uses two custom 
' types: UrlsCollection and 
' UrlsConfigElement.

Public Class UrlsSection
    Inherits ConfigurationSection
    
    ' Test flag.
    Private Shared _displayIt As
 Boolean = False
    
    ' Declare the custom element type.
    ' This element will also be part of
    ' the custom collection.
    Private url As UrlConfigElement
    
    
    Public Sub New() 
        ' Create the element.
        url = New UrlConfigElement()
    
    End Sub 'New
    
    <ConfigurationProperty("name", _
    DefaultValue:="MyFavorites", _
    IsRequired:=True, _
    IsKey:=False), _
    StringValidator( _
    InvalidCharacters:=" ~!@#$%^&*()[]{}/;'""|\",
 _
    MinLength:=1, MaxLength:=60)> _
    Public Property Name() As
 String

        Get
            Return CStr(Me("name"))
        End Get
        Set(ByVal value As
 String)
            Me("name") = value
        End Set
    End Property
    
    ' Declare a simple element of the type
    ' UrlConfigElement. In the configuration
    ' file it corresponds to <simple .... />.
    <ConfigurationProperty("simple")> _
    Public ReadOnly Property
 Simple() _
    As UrlConfigElement
        Get
            Dim url As UrlConfigElement = _
            CType(Me("simple"),
 _
            UrlConfigElement)
            Return url
        End Get
    End Property
    
    ' Declare a collection element represented 
    ' in the configuration file by the sub-section
    ' <urls> <add .../> </urls> 
    ' Note: the "IsDefaultCollection = false" 
    ' instructs the .NET Framework to build a nested 
    ' section like <urls> ...</urls>.
    <ConfigurationProperty("urls", _
    IsDefaultCollection:=False)> _
    Public ReadOnly Property
 Urls() _
    As UrlsCollection
        Get
            Dim urlsCollection _
            As UrlsCollection = _
            CType(Me("urls"), UrlsCollection)
            Return urlsCollection
        End Get
    End Property
    
    
    
    Protected Overrides Sub
 DeserializeSection( _
    ByVal reader As System.Xml.XmlReader)
        MyBase.DeserializeSection(reader)

        ' Enter your custom processing code here.
        If _displayIt Then
            Console.WriteLine( _
            "UrlsSection.DeserializeSection({0}) called",
 _
            IIf(reader Is Nothing, "null",
 _
            reader.ToString()))
        End If
    End Sub 'DeserializeSection

    Protected Overrides Function
 SerializeSection( _
    ByVal parentElement As ConfigurationElement,
 _
    ByVal name As String,
 _
    ByVal saveMode As ConfigurationSaveMode)
 As String
        Dim s As String
 = _
        MyBase.SerializeSection(parentElement, _
        name, saveMode)
        ' Enter your custom processing code here.

        If _displayIt Then
            Console.WriteLine( _
            "UrlsSection.SerializeSection({0}, {1}, {2}) called
 = {3}", _
            parentElement.ToString(), _
            name, saveMode.ToString(), s)
        End If
        Return s

    End Function 'SerializeSection
End Class 'UrlsSection 

C#

using System;
using System.Configuration;
using System.Collections;


namespace Samples.AspNet
{

    // Define a custom section containing 
    // a simple element and a collection of 
    // the same element. It uses two custom 
    // types: UrlsCollection and 
    // UrlsConfigElement.
    public class UrlsSection :
        ConfigurationSection
    {

        // Test flag.
        private static bool
 _displayIt = false;

        // Declare the custom element type.
        // This element will also be part of
        // the custom collection.
        UrlConfigElement url;

        public UrlsSection()
        {
            // Create the element.
            url = new UrlConfigElement();
        }

        [ConfigurationProperty("name", 
            DefaultValue = "MyFavorites",
            IsRequired = true, 
            IsKey = false)]
        [StringValidator(InvalidCharacters = 
            " ~!@#$%^&*()[]{}/;'\"|\\",
            MinLength = 1, MaxLength = 60)]
        public string Name
        {

            get
            {
                return (string)this["name"];
            }
            set
            {
                this["name"] = value;
            }

        }


        // Declare a simple element of the type
        // UrlConfigElement. In the configuration
        // file it corresponds to <simple .... />.
        [ConfigurationProperty("simple")]
        public UrlConfigElement Simple
        {
            get
            {
                UrlConfigElement url =
                (UrlConfigElement)base["simple"];
                return url;
            }
        }

        // Declare a collection element represented 
        // in the configuration file by the sub-section
        // <urls> <add .../> </urls> 
        // Note: the "IsDefaultCollection = false" 
        // instructs the .NET Framework to build a nested 
        // section like <urls> ...</urls>.
        [ConfigurationProperty("urls",
            IsDefaultCollection = false)]
        public UrlsCollection Urls
        {

            get
            {
                UrlsCollection urlsCollection =
                (UrlsCollection)base["urls"];
                return urlsCollection;
            }
        }


        protected override void DeserializeSection(
            System.Xml.XmlReader reader)
        {
            base.DeserializeSection(reader);

            // Enter your custom processing code here.
            if (_displayIt)
            {
                Console.WriteLine(
                    "UrlsSection.DeserializeSection({0}) called",
                    (reader == null) ? "null"
 : reader.ToString());
            }
        }

        protected override string SerializeSection(
            ConfigurationElement parentElement,
            string name, ConfigurationSaveMode saveMode)
        {
            string s =
                base.SerializeSection(parentElement,
                name, saveMode);

            // Enter your custom processing code here.

            if (_displayIt)
            {
                Console.WriteLine(
                   "UrlsSection.SerializeSection({0}, {1}, {2}) called = {3}"
,
                   parentElement.ToString(), name,
                   saveMode.ToString(), s);
            }
            return s;
        }

    }
}

プラットフォーム

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

参照

関連項目
ElementInformation クラス
ElementInformation メンバ
System.Configuration 名前空間