EventMappingSettingsCollection クラス

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

EventMappingSettingsCollection クラス

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

EventMappingSettings オブジェクトのコレクションを提供します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 EventMappingSettingsCollection
    Inherits ConfigurationElementCollection

Visual Basic (使用法)

Dim instance As EventMappingSettingsCollection

C#

public sealed class EventMappingSettingsCollection
 : ConfigurationElementCollection

C++

public ref class EventMappingSettingsCollection
 sealed : public ConfigurationElementCollection

J#

public final class EventMappingSettingsCollection
 extends ConfigurationElementCollection

JScript

public final class EventMappingSettingsCollection
 extends ConfigurationElementCollection

解説

EventMappingSettings クラスは、eventMappings 構成ファイル要素に対応します。eventMappings 要素を使用して、イベント ソースにフレンドリ名を割り当てることができます。これらの名前は、構成ファイルの healthMonitoring セクションの rules サブセクションで、プロバイダと呼ばれる関連イベント コンシューマにイベント ソースを関連付けるのに使用されます。

使用例

EventMappingSettingsCollection 型を使用する方法を次のコード例に示します。このコード例は、HealthMonitoringSection クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Add a EventMappingsSettings object to the EventMappings collection
 property.
Dim eventMappingSetting As EventMappingSettings
 = New EventMappingSettings( _
    "Failure Audits", "System.Web.Management.WebAuditEvent,
 System.Web")
eventMappingSetting.Name = "All Errors"
eventMappingSetting.Type = _
    "System.Web.Management.WebErrorEvent, System.Web"
eventMappingSetting.StartEventCode = 0
eventMappingSetting.EndEventCode = 4096
healthMonitoringSection.EventMappings.Add(eventMappingSetting)

' Add an EventMappingsSettings object to the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Add(new EventMappingSettings(
 _
    "Failure Audits", "System.Web.Management.WebAuditEvent,
 System.Web"))

' Add an EventMappingsSettings object to the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Add(new EventMappingSettings(
 _
    "Success Audits", "System.Web.Management.WebAuditEvent,
 System.Web", _
    512, Int32.MaxValue))

' Insert an EventMappingsSettings object into the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Insert(1, _
    new EventMappingSettings("HeartBeats",
 "", 1, 2))

' Display contents of the EventMappings collection property
Console.WriteLine( _
    "EventMappings Collection contains {0} values:",
 healthMonitoringSection.EventMappings.Count)

' Display all elements.
For i As System.Int32 = 0 To
 healthMonitoringSection.EventMappings.Count - 1
eventMappingSetting = healthMonitoringSection.EventMappings(i)
Dim name As String = eventMappingSetting.Name
Dim type As String = eventMappingSetting.Type
Dim startCd As Integer =
 eventMappingSetting.StartEventCode
Dim endCd As Integer = eventMappingSetting.EndEventCode
    Dim item As String =
 "Name='" & name & "', Type='" & type
 & _
        "', StartEventCode =  '" & startCd.ToString()
 & _
        "', EndEventCode =  '" & endCd.ToString() &
 "'"
    Console.WriteLine("  Item {0}: {1}", i, item)
Next

' See if the EventMappings collection property contains the event 'HeartBeats'.
Console.WriteLine("EventMappings contains 'HeartBeats': {0}.",
 _
    healthMonitoringSection.EventMappings.Contains("HeartBeats"))

' Get the index of the 'HeartBeats' event in the EventMappings collection
 property.
Console.WriteLine("EventMappings index for 'HeartBeats':
 {0}.", _
    healthMonitoringSection.EventMappings.IndexOf("HeartBeats"))

' Get a named EventMappings
eventMappingSetting = healthMonitoringSection.EventMappings("HeartBeats")

' Remove an EventMappingsSettings object from the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Remove("HeartBeats")

' Remove an EventMappingsSettings object from the EventMappings collection
 property.
healthMonitoringSection.EventMappings.RemoveAt(0)

' Clear all EventMappingsSettings object from the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Clear()

C#

// Add a EventMappingsSettings object to the EventMappings collection
 property.
EventMappingSettings eventMappingSetting = new EventMappingSettings(
    "Failure Audits", "System.Web.Management.WebAuditEvent, System.Web");
eventMappingSetting.Name = "All Errors";
eventMappingSetting.Type = 
    "System.Web.Management.WebErrorEvent, System.Web";
eventMappingSetting.StartEventCode = 0;
eventMappingSetting.EndEventCode = 4096;
healthMonitoringSection.EventMappings.Add(eventMappingSetting);

// Add an EventMappingsSettings object to the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Add(new EventMappingSettings(
    "Failure Audits", "System.Web.Management.WebAuditEvent, System.Web"));

// Add an EventMappingsSettings object to the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Add(new EventMappingSettings(
    "Success Audits", "System.Web.Management.WebAuditEvent, System.Web"
,
    512, Int32.MaxValue));

// Insert an EventMappingsSettings object into the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Insert(1, 
    new EventMappingSettings("HeartBeats", "",
 1, 2));

// Display contents of the EventMappings collection property
Console.WriteLine(
    "EventMappings Collection contains {0} values:", healthMonitoringSection.EventMappings.Count);

// Display all elements.
for (System.Int32 i = 0; i < healthMonitoringSection.EventMappings.Count;
 i++)
{
eventMappingSetting = healthMonitoringSection.EventMappings[i];
string name = eventMappingSetting.Name;
string type = eventMappingSetting.Type;
int startCd = eventMappingSetting.StartEventCode;
int endCd = eventMappingSetting.EndEventCode;
    string item = "Name='" + name + "', Type='"
 + type +
        "', StartEventCode =  '" + startCd.ToString() +
        "', EndEventCode =  '" + endCd.ToString() + "'";
    Console.WriteLine("  Item {0}: {1}", i, item);
}

// See if the EventMappings collection property contains the event 'HeartBeats'.
Console.WriteLine("EventMappings contains 'HeartBeats': {0}.",
    healthMonitoringSection.EventMappings.Contains("HeartBeats"));

// Get the index of the 'HeartBeats' event in the EventMappings collection
 property.
Console.WriteLine("EventMappings index for 'HeartBeats':
 {0}.",
    healthMonitoringSection.EventMappings.IndexOf("HeartBeats"));

// Get a named EventMappings
eventMappingSetting = healthMonitoringSection.EventMappings["HeartBeats"];

// Remove an EventMappingsSettings object from the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Remove("HeartBeats");

// Remove an EventMappingsSettings object from the EventMappings collection
 property.
healthMonitoringSection.EventMappings.RemoveAt(0);

// Clear all EventMappingsSettings object from the EventMappings collection
 property.
healthMonitoringSection.EventMappings.Clear();

継承階層

System.Object
   System.Configuration.ConfigurationElement
     System.Configuration.ConfigurationElementCollection
      System.Web.Configuration.EventMappingSettingsCollection

スレッド セーフ

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

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
EventMappingSettingsCollection メンバ
System.Web.Configuration 名前空間
HealthMonitoringSection
EventMappingSettings クラス
ProviderSettings
その他の技術情報
healthMonitoring の eventMappings 要素 (ASP.NET 設定スキーマ)