KeyValueConfigurationElementとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

KeyValueConfigurationElement クラス

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

キーと値のペアを格納する構成要素を表します。

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

Visual Basic (宣言)

Public Class KeyValueConfigurationElement
    Inherits ConfigurationElement

Visual Basic (使用法)

Dim instance As KeyValueConfigurationElement

public class KeyValueConfigurationElement :
 ConfigurationElement

C++

public ref class KeyValueConfigurationElement
 : public ConfigurationElement

public class KeyValueConfigurationElement extends
 ConfigurationElement

JScript

public class KeyValueConfigurationElement extends
 ConfigurationElement

解説

KeyValueConfigurationElement オブジェクトは ConfigurationElement 基本クラスから継承します。ConfigurationElement オブジェクトは、構成ファイル内の要素を表します。KeyValueConfigurationElement オブジェクトは、KeyValueConfigurationCollection コレクションに属することができます。

使用例

KeyValueConfigurationElement クラスのメンバを使用する方法を次のコード例に示します。

using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Web;
using System.Web.Configuration;

namespace Samples.Aspnet.Config
{
  class KeyValueConfigCollection
  {
    static void Main(string[]
 args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "/aspnet";

        // Get the Web application configuration object.
        Configuration config =
          WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        AppSettingsSection configSection =
          (AppSettingsSection)config.GetSection
          ("appSettings");

        // Display title and info.
        Console.WriteLine("ASP.NET Configuration Info");
        Console.WriteLine();

        // Display Config details.
        Console.WriteLine("File Path: {0}",
          config.FilePath);
        Console.WriteLine("Section Path: {0}",
          configSection.SectionInformation.Name.ToString());
        Console.WriteLine();

        // Create the KeyValueConfigurationElement.
        KeyValueConfigurationElement myAdminKeyVal = 
          new KeyValueConfigurationElement(
          "myAdminTool", "admin.aspx");

        // Determine if the configuration contains
        // any KeyValueConfigurationElements.
        KeyValueConfigurationCollection configSettings = 
          config.AppSettings.Settings;
        if (configSettings.AllKeys.Length == 0)
        {
          // Add KeyValueConfigurationElement to collection.
          config.AppSettings.Settings.Add(myAdminKeyVal);

          if (!configSection.SectionInformation.IsLocked)
          {
            config.Save();
            Console.WriteLine("** Configuration updated.");
          }
          else
          {
            Console.WriteLine("** Could not update, section is locked.");
          }
        }

        // Get the KeyValueConfigurationCollection 
        // from the configuration.
        KeyValueConfigurationCollection settings = 
          config.AppSettings.Settings;

        // Display each KeyValueConfigurationElement.
        foreach (KeyValueConfigurationElement keyValueElement
 in settings)
        {
          Console.WriteLine("Key: {0}", keyValueElement.Key);
          Console.WriteLine("Value: {0}", keyValueElement.Value);
          Console.WriteLine();
        }

      }
      catch (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait
      Console.ReadLine();
    }
  }
}

継承階層

System.Object
System.Configuration.ConfigurationElement
System.Configuration.KeyValueConfigurationElement

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
KeyValueConfigurationElement メンバ
System.Configuration 名前空間
ConfigurationElement クラス
その他の技術情報
appSettings 要素 (全般設定スキーマ)

KeyValueConfigurationElement コンストラクタ

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

指定されたパラメータに基づいて、KeyValueConfigurationElement クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    key As String, _
    value As String _
)

Visual Basic (使用法)

Dim key As String
Dim value As String

Dim instance As New KeyValueConfigurationElement(key,
 value)

public KeyValueConfigurationElement (
    string key,
    string value
)

C++

public:
KeyValueConfigurationElement (
    String^ key, 
    String^ value
)

public KeyValueConfigurationElement (
    String key, 
    String value
)

JScript

public function KeyValueConfigurationElement
 (
    key : String, 
    value : String
)

パラメータ

key: KeyValueConfigurationElement のキー。

value: KeyValueConfigurationElement の値。

使用例

KeyValueConfigurationElement コンストラクタを使用する方法を次のコード例に示します。このコード例は KeyValueConfigurationCollection クラスの概要で取り上げているコード例の一部分です。

Visual Basic

' Create the KeyValueConfigurationElement.
Dim myAdminKeyVal As KeyValueConfigurationElement
 = _
  New KeyValueConfigurationElement _
  ("myAdminTool", "admin.aspx")

// Create the KeyValueConfigurationElement.
KeyValueConfigurationElement myAdminKeyVal = 
  new KeyValueConfigurationElement(
  "myAdminTool", "admin.aspx");

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

KeyValueConfigurationElement プロパティ

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

( プロテクトプロパティも参照)

	名前	説明
	ElementInformation	ConfigurationElement オブジェクトのカスタマイズできない情報と機能を格納する ElementInformation オブジェクトを取得します。 ( ConfigurationElement から継承されます。)
	Key	KeyValueConfigurationElement オブジェクトのキーを取得します。
	LockAllAttributesExcept	ロックされている属性のコレクションを取得します。 ( ConfigurationElement から継承されます。)
	LockAllElementsExcept	ロックされている要素のコレクションを取得します。 ( ConfigurationElement から継承されます。)
	LockAttributes	ロックされている属性のコレクションを取得します。 ( ConfigurationElement から継承されます。)
	LockElements	ロックされている要素のコレクションを取得します。 ( ConfigurationElement から継承されます。)
	LockItem	要素がロックされているかどうかを示す値を取得または設定します。 ( ConfigurationElement から継承されます。)
	Value	KeyValueConfigurationElement オブジェクトの値を取得または設定します。

プロテクトプロパティ

	名前	説明
	ElementProperty	ConfigurationElement オブジェクト自体を表す ConfigurationElementProperty オブジェクトを取得します。 ( ConfigurationElement から継承されます。)
	EvaluationContext	ConfigurationElement オブジェクトの ContextInformation オブジェクトを取得します。 ( ConfigurationElement から継承されます。)
	Item	オーバーロードされます。この ConfigurationElement オブジェクトのプロパティ、属性、または子要素を取得または設定します。 ( ConfigurationElement から継承されます。)
	Properties	オーバーライドされます。プロパティのコレクションを取得します。

参照

その他の技術情報

appSettings 要素 (全般設定スキーマ)

KeyValueConfigurationElement メソッド

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

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。現在の ConfigurationElement インスタンスを、指定したオブジェクトと比較します。 ( ConfigurationElement から継承されます。)
	GetHashCode	現在の ConfigurationElement インスタンスを表す一意の値を取得します。 ( ConfigurationElement から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsReadOnly	ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。 ( ConfigurationElement から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	DeserializeElement	構成ファイルから XML を読み取ります。 ( ConfigurationElement から継承されます。)
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	Init	オーバーライドされます。 KeyValueConfigurationElement オブジェクトを初期状態に設定します。
	InitializeDefault	ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。 ( ConfigurationElement から継承されます。)
	IsModified	派生クラスに実装された場合、この構成要素が最後の保存または読み込み以降に変更されたかどうかを示します。 ( ConfigurationElement から継承されます。)
	ListErrors	この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティのエラーを、渡されたリストに追加します。 ( ConfigurationElement から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnDeserializeUnrecognizedAttribute	逆シリカル化中に不明な属性が発生したかどうかを示す値を取得します。 ( ConfigurationElement から継承されます。)
	OnDeserializeUnrecognizedElement	逆シリカル化中に不明な要素が発生したかどうかを示す値を取得します。 ( ConfigurationElement から継承されます。)
	OnRequiredPropertyNotFound	必須プロパティが見つからなかったかどうかを示す値を取得します。 ( ConfigurationElement から継承されます。)
	PostDeserialize	逆シリアル化後に呼び出されます。 ( ConfigurationElement から継承されます。)
	PreSerialize	シリアル化前に呼び出されます。 ( ConfigurationElement から継承されます。)
	Reset	ConfigurationElement オブジェクトの内部状態 (ロックやプロパティコレクションなど) をリセットします。 ( ConfigurationElement から継承されます。)
	ResetModified	派生クラスに実装された場合、IsModified メソッドの値を false にリセットします。 ( ConfigurationElement から継承されます。)
	SerializeElement	派生クラスに実装されている場合、この構成要素の内容を構成ファイルに書き込みます。 ( ConfigurationElement から継承されます。)
	SerializeToXmlElement	派生クラスに実装されている場合、この構成要素の外側のタグを構成ファイルに書き込みます。 ( ConfigurationElement から継承されます。)
	SetPropertyValue	プロパティを指定した値に設定します。 ( ConfigurationElement から継承されます。)
	SetReadOnly	ConfigurationElement オブジェクトおよびすべてのサブ要素に IsReadOnly プロパティを設定します。 ( ConfigurationElement から継承されます。)
	Unmerge	保存しないすべての値を削除するには、ConfigurationElement オブジェクトを変更します。 ( ConfigurationElement から継承されます。)

参照

その他の技術情報

appSettings 要素 (全般設定スキーマ)

KeyValueConfigurationElement メンバ

キーと値のペアを格納する構成要素を表します。

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

パブリックコンストラクタ

	名前	説明
	KeyValueConfigurationElement	指定されたパラメータに基づいて、KeyValueConfigurationElement クラスの新しいインスタンスを初期化します。

パブリックプロパティ

( プロテクトプロパティも参照)

	名前	説明
	ElementInformation	ConfigurationElement オブジェクトのカスタマイズできない情報と機能を格納する ElementInformation オブジェクトを取得します。 (ConfigurationElement から継承されます。)
	Key	KeyValueConfigurationElement オブジェクトのキーを取得します。
	LockAllAttributesExcept	ロックされている属性のコレクションを取得します。(ConfigurationElement から継承されます。)
	LockAllElementsExcept	ロックされている要素のコレクションを取得します。(ConfigurationElement から継承されます。)
	LockAttributes	ロックされている属性のコレクションを取得します。 (ConfigurationElement から継承されます。)
	LockElements	ロックされている要素のコレクションを取得します。(ConfigurationElement から継承されます。)
	LockItem	要素がロックされているかどうかを示す値を取得または設定します。(ConfigurationElement から継承されます。)
	Value	KeyValueConfigurationElement オブジェクトの値を取得または設定します。

プロテクトプロパティ

	名前	説明
	ElementProperty	ConfigurationElement オブジェクト自体を表す ConfigurationElementProperty オブジェクトを取得します。(ConfigurationElement から継承されます。)
	EvaluationContext	ConfigurationElement オブジェクトの ContextInformation オブジェクトを取得します。(ConfigurationElement から継承されます。)
	Item	オーバーロードされます。この ConfigurationElement オブジェクトのプロパティ、属性、または子要素を取得または設定します。(ConfigurationElement から継承されます。)
	Properties	オーバーライドされます。プロパティのコレクションを取得します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。現在の ConfigurationElement インスタンスを、指定したオブジェクトと比較します。 (ConfigurationElement から継承されます。)
	GetHashCode	現在の ConfigurationElement インスタンスを表す一意の値を取得します。 (ConfigurationElement から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsReadOnly	ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。 (ConfigurationElement から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	DeserializeElement	構成ファイルから XML を読み取ります。 (ConfigurationElement から継承されます。)
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	Init	オーバーライドされます。 KeyValueConfigurationElement オブジェクトを初期状態に設定します。
	InitializeDefault	ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。 (ConfigurationElement から継承されます。)
	IsModified	派生クラスに実装された場合、この構成要素が最後の保存または読み込み以降に変更されたかどうかを示します。 (ConfigurationElement から継承されます。)
	ListErrors	この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティのエラーを、渡されたリストに追加します。 (ConfigurationElement から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnDeserializeUnrecognizedAttribute	逆シリカル化中に不明な属性が発生したかどうかを示す値を取得します。 (ConfigurationElement から継承されます。)
	OnDeserializeUnrecognizedElement	逆シリカル化中に不明な要素が発生したかどうかを示す値を取得します。 (ConfigurationElement から継承されます。)
	OnRequiredPropertyNotFound	必須プロパティが見つからなかったかどうかを示す値を取得します。 (ConfigurationElement から継承されます。)
	PostDeserialize	逆シリアル化後に呼び出されます。 (ConfigurationElement から継承されます。)
	PreSerialize	シリアル化前に呼び出されます。 (ConfigurationElement から継承されます。)
	Reset	ConfigurationElement オブジェクトの内部状態 (ロックやプロパティコレクションなど) をリセットします。 (ConfigurationElement から継承されます。)
	ResetModified	派生クラスに実装された場合、IsModified メソッドの値を false にリセットします。 (ConfigurationElement から継承されます。)
	SerializeElement	派生クラスに実装されている場合、この構成要素の内容を構成ファイルに書き込みます。 (ConfigurationElement から継承されます。)
	SerializeToXmlElement	派生クラスに実装されている場合、この構成要素の外側のタグを構成ファイルに書き込みます。 (ConfigurationElement から継承されます。)
	SetPropertyValue	プロパティを指定した値に設定します。 (ConfigurationElement から継承されます。)
	SetReadOnly	ConfigurationElement オブジェクトおよびすべてのサブ要素に IsReadOnly プロパティを設定します。 (ConfigurationElement から継承されます。)
	Unmerge	保存しないすべての値を削除するには、ConfigurationElement オブジェクトを変更します。 (ConfigurationElement から継承されます。)

参照

その他の技術情報

appSettings 要素 (全般設定スキーマ)

>> 「KeyValueConfigurationElement」を含む用語の索引
KeyValueConfigurationElementのページへのリンク

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

KeyValueConfigurationElement クラス

KeyValueConfigurationElement コンストラクタ

KeyValueConfigurationElement プロパティ

関連項目

その他の技術情報

KeyValueConfigurationElement メソッド

関連項目

その他の技術情報

KeyValueConfigurationElement メンバ

関連項目

その他の技術情報

英和和英テキスト翻訳

「KeyValueConfigurationElement」の関連用語


	© 2026 Microsoft.All rights reserved.

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

KeyValueConfigurationElement クラス

KeyValueConfigurationElement コンストラクタ

KeyValueConfigurationElement プロパティ

関連項目

その他の技術情報

KeyValueConfigurationElement メソッド

関連項目

その他の技術情報

KeyValueConfigurationElement メンバ

関連項目

その他の技術情報

英和和英テキスト翻訳

「KeyValueConfigurationElement」の関連用語

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