WebPartsSection クラス
アセンブリ: System.Web (system.web.dll 内)


webParts 構成ファイル セクションを使用すると、Web パーツ パーソナル化プロバイダの指定、パーソナル化承認の設定、および Web パーツ接続で使用する WebPartTransformer クラスを拡張するカスタム クラスの追加を実行できます。

この例では、webParts セクションの複数の属性に対して、宣言によって値を指定する方法を示しています。これらの属性には、WebPartsSection クラスのメンバとしてもアクセスできます。
次の構成ファイルの例では、webParts セクションに対して、宣言によって値を指定する方法を示しています。
<system.web> <webParts> <personalization defaultProvider=" AspNetSqlPersonalizationProvider "> <!—- Providers may only be defined at the application level --> <providers> <add name="AspNetSqlPersonalizationProvider" type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider" connectionStringName="LocalSqlServer" applicationName="/" /> </providers> <authorization> <deny users="*" verbs="enterSharedScope" /> <allow users="Admin" verbs="modifyState" /> </authorization> </personalization> <transformers> <add name="RowToFieldTransformer" type="System.Web.UI.WebControls.WebParts.RowToFieldTransformer" /> <add name="RowToFilterTransformer" type="System.Web.UI.WebControls.WebParts.RowToFilterTransformer" /> <add name="RowToParametersTransformer" type="System.Web.UI.WebControls.WebParts.RowToParametersTransformer" /> </transformers> </webParts> </system.web>
WebPartsSection クラスを使用する方法を次のコード例に示します。
Imports System Imports System.Collections Imports System.Collections.Specialized Imports System.IO Imports System.Text Imports System.Text.RegularExpressions Imports System.Configuration Imports System.Web.Configuration Namespace Samples.Aspnet.SystemWebConfiguration ' Accesses the System.Web.Configuration.WebPartsSection ' members selected by the user. Class UsingWebPartsSection Public Shared Sub Main() ' Process the System.Web.Configuration.WebPartsSectionobject. Try ' Get the Web application configuration. Dim configuration As System.Configuration.Configuration = _ WebConfigurationManager.OpenWebConfiguration("/aspnet") ' Get the section. Dim webPartsSection As WebPartsSection = _ CType(configuration.Sections("system.web/webParts"), _ WebPartsSection) ' Add a Transfomer Info Object to the collection using a constructor. webPartsSection.Transformers.Add(New TransformerInfo( _ "RowToFilterTransformer", _ "MyCustomTransformers.RowToFilterTransformer")) ' Show all TransformerInfo objects in the collection. Dim ti As Integer For ti = 0 To webPartsSection.Personalization.Providers.Count - 1 Console.WriteLine(" #{0} Name={1} Type={2}", ti, _ webPartsSection.Transformers(ti).Name, _ webPartsSection.Transformers(ti).Type) Next ' Remove a TransformerInfo object by name. webPartsSection.Transformers.Remove("RowToFilterTransformer") ' Remove a TransformerInfo object by index. webPartsSection.Transformers.RemoveAt(0) ' Clear all TransformerInfo objects from the collection. webPartsSection.Transformers.Clear() ' Get the current DefaultProvider property value. Console.WriteLine( _ "Current DefaultProvider value: '{0}'", _ webPartsSection.Personalization.DefaultProvider) ' Set the DefaultProvider property. webPartsSection.Personalization.DefaultProvider = _ "ASPNetSQLPersonalizationProvider" ' Add a provider. webPartsSection.Personalization.Providers.Add( _ New ProviderSettings("CustomProvider", _ "MyCustomProviders.Provider")) ' List current providers. Dim pi As Integer For pi = 0 To webPartsSection.Personalization.Providers.Count - 1 Console.WriteLine(" #{0} Name={1} Type={2}", pi, _ webPartsSection.Personalization.Providers(pi).Name, _ webPartsSection.Personalization.Providers(pi).Type) Next ' Add an authorization. Dim ar As AuthorizationRule = _ New AuthorizationRule(AuthorizationRuleAction.Allow) ar.Verbs.Add("ModifyState") ar.Users.Add("Admin") webPartsSection.Personalization.Authorization.Rules.Add(ar) ' List current authorizations. Dim ai As Integer For ai = 0 To _ webPartsSection.Personalization.Authorization.Rules.Count Console.WriteLine(" #{0}:", ai) Dim aRule As AuthorizationRule = _ webPartsSection.Personalization.Authorization.Rules(ai) Console.WriteLine(" Verbs=") Dim verb As String For Each verb In aRule.Verbs Console.WriteLine(" * {0}", verb) Console.WriteLine(" Roles=") Next Dim role As String For Each role In aRule.Roles Console.WriteLine(" * {0}", role) Console.WriteLine(" Users=") Next Dim user As String For Each user In aRule.Users Console.WriteLine(" * {0}", user) Next Next ' Update if not locked. If Not webPartsSection.IsReadOnly() Then configuration.Save() Console.WriteLine("** Configuration updated.") Else Console.WriteLine("** Could not update, section is locked.") End If Catch e As System.ArgumentException ' Unknown error. Console.WriteLine( _ "A invalid argument exception detected in UsingWebPartsSection Main. Check your") Console.WriteLine("command line for errors.") End Try End Sub End Class ' UsingWebPartsSection. End Namespace ' Samples.Aspnet.SystemWebConfiguration
using System; using System.Collections; using System.Collections.Specialized; using System.IO; using System.Text; using System.Text.RegularExpressions; using System.Configuration; using System.Configuration.Provider; using System.Web.Configuration; namespace Samples.Aspnet.SystemWebConfiguration { // Accesses the System.Web.Configuration.WebPartsSection // members selected by the user. class UsingWebPartsSection { public static void Main() { // Process the System.Web.Configuration.WebPartsSectionobject. try { // Get the Web application configuration. Configuration configuration = WebConfigurationManager.OpenWebConfiguration("/aspnet"); // Get the section. WebPartsSection webPartsSection = (WebPartsSection) configuration.Sections["system.web/webParts"]; // Add a Transfomer Info Object to the collection using a constructor. webPartsSection.Transformers.Add(new TransformerInfo( "RowToFilterTransformer", "MyCustomTransformers.RowToFilterTransformer")); // Show all TransformerInfo objects in the collection. for (int ti = 0; ti < webPartsSection.Personalization.Providers.Count; ti++) { Console.WriteLine(" #{0} Name={1} Type={2}", ti, webPartsSection.Transformers[ti].Name, webPartsSection.Transformers[ti].Type); } // Remove a TransformerInfo object by name. webPartsSection.Transformers.Remove("RowToFilterTransformer"); // Remove a TransformerInfo object by index. webPartsSection.Transformers.RemoveAt(0); // Clear all TransformerInfo objects from the collection. webPartsSection.Transformers.Clear(); // Get the current DefaultProvider property value. Console.WriteLine( "Current DefaultProvider value: '{0}'", webPartsSection.Personalization.DefaultProvider); // Set the DefaultProvider property. webPartsSection.Personalization.DefaultProvider = "ASPNetSQLPersonalizationProvider"; // Add a provider. webPartsSection.Personalization.Providers.Add( new ProviderSettings("CustomProvider", "MyCustomProviders.Provider")); // List current providers. for (int pi = 0; pi < webPartsSection.Personalization.Providers.Count; pi++) { Console.WriteLine(" #{0} Name={1} Type={2}", pi, webPartsSection.Personalization.Providers[pi].Name, webPartsSection.Personalization.Providers[pi].Type); } // Add an authorization. AuthorizationRule ar = new AuthorizationRule(AuthorizationRuleAction.Allow); ar.Verbs.Add("ModifyState"); ar.Users.Add("Admin"); webPartsSection.Personalization.Authorization.Rules.Add(ar); // List current authorizations. for (int ai = 0; ai < webPartsSection.Personalization.Authorization.Rules.Count; ai++) { Console.WriteLine(" #{0}:", ai); AuthorizationRule aRule = webPartsSection.Personalization.Authorization.Rules[ai]; Console.WriteLine(" Verbs="); foreach (string verb in aRule.Verbs) Console.WriteLine(" * {0}", verb); Console.WriteLine(" Roles="); foreach (string role in aRule.Roles) Console.WriteLine(" * {0}", role); Console.WriteLine(" Users="); foreach (string user in aRule.Users) Console.WriteLine(" * {0}", user); } // Update if not locked. if (! webPartsSection.IsReadOnly()) { configuration.Save(); Console.WriteLine("** Configuration updated."); } else Console.WriteLine("** Could not update, section is locked."); } catch (System.ArgumentException e) { // Unknown error. Console.WriteLine( "A invalid argument exception detected in UsingWebPartsSection Main. Check your"); Console.WriteLine("command line for errors."); } } } // UsingWebPartsSection class end. } // Samples.Aspnet.SystemWebConfiguration namespace end.

System.Configuration.ConfigurationElement
System.Configuration.ConfigurationSection
System.Web.Configuration.WebPartsSection


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebPartsSection コンストラクタ
アセンブリ: System.Web (system.web.dll 内)


WebPartsSection コンストラクタは、コードで直接使用するためのものではありません。ASP.NET 構成システムによって呼び出されます。WebPartsSection クラスのインスタンスは、GetSection メソッドを使用して取得します。
このコンストラクタは、コードで直接使用するためのものではありません。ASP.NET 構成システムによって呼び出されます。
このコンストラクタに使用される既定の設定を次の表に示します。

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebPartsSection プロパティ

名前 | 説明 | |
---|---|---|
![]() | ElementInformation | ConfigurationElement オブジェクトのカスタマイズできない情報と機能を格納する ElementInformation オブジェクトを取得します。 ( ConfigurationElement から継承されます。) |
![]() | EnableExport | 制御データの XML 記述ファイルへのエクスポートを有効にするかどうかを示す値を取得または設定します。 |
![]() | LockAllAttributesExcept | ロックされている属性のコレクションを取得します。 ( ConfigurationElement から継承されます。) |
![]() | LockAllElementsExcept | ロックされている要素のコレクションを取得します。 ( ConfigurationElement から継承されます。) |
![]() | LockAttributes | ロックされている属性のコレクションを取得します。 ( ConfigurationElement から継承されます。) |
![]() | LockElements | ロックされている要素のコレクションを取得します。 ( ConfigurationElement から継承されます。) |
![]() | LockItem | 要素がロックされているかどうかを示す値を取得または設定します。 ( ConfigurationElement から継承されます。) |
![]() | Personalization | Web パーツ パーソナル化プロバイダの指定および Web パーツ パーソナル化承認の設定をできるようにする WebPartsPersonalization オブジェクトを取得します。 |
![]() | SectionInformation | ConfigurationSection オブジェクトのカスタマイズできない情報と機能を格納する SectionInformation オブジェクトを取得します。 ( ConfigurationSection から継承されます。) |
![]() | Transformers | TransformerInfo オブジェクトのコレクションを取得します。 |

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

WebPartsSection メソッド

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

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

WebPartsSection メンバ
webParts 構成ファイル セクションにプログラムからアクセスできるようにします。このクラスは継承できません。
WebPartsSection データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | ElementInformation | ConfigurationElement オブジェクトのカスタマイズできない情報と機能を格納する ElementInformation オブジェクトを取得します。 (ConfigurationElement から継承されます。) |
![]() | EnableExport | 制御データの XML 記述ファイルへのエクスポートを有効にするかどうかを示す値を取得または設定します。 |
![]() | LockAllAttributesExcept | ロックされている属性のコレクションを取得します。(ConfigurationElement から継承されます。) |
![]() | LockAllElementsExcept | ロックされている要素のコレクションを取得します。(ConfigurationElement から継承されます。) |
![]() | LockAttributes | ロックされている属性のコレクションを取得します。 (ConfigurationElement から継承されます。) |
![]() | LockElements | ロックされている要素のコレクションを取得します。(ConfigurationElement から継承されます。) |
![]() | LockItem | 要素がロックされているかどうかを示す値を取得または設定します。(ConfigurationElement から継承されます。) |
![]() | Personalization | Web パーツ パーソナル化プロバイダの指定および Web パーツ パーソナル化承認の設定をできるようにする WebPartsPersonalization オブジェクトを取得します。 |
![]() | SectionInformation | ConfigurationSection オブジェクトのカスタマイズできない情報と機能を格納する SectionInformation オブジェクトを取得します。 (ConfigurationSection から継承されます。) |
![]() | Transformers | TransformerInfo オブジェクトのコレクションを取得します。 |

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

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

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

- WebPartsSectionのページへのリンク