healthMonitoring의 providers 요소에 대한 add 요소(ASP.NET 설정 스키마)

아티클
09/05/2008

업데이트: 2007년 11월

공급자 및 해당 공급자를 구현하는 클래스의 이름을 지정합니다.

<configuration> 요소
  system.web 요소(ASP.NET 설정 스키마)
    healthMonitoring 요소(ASP.NET 설정 스키마)
      healthMonitoring에 대한 providers 요소(ASP.NET 설정 스키마)
        healthMonitoring의 providers 요소에 대한 add 요소(ASP.NET 설정 스키마)

<!-- Default, WMIWebEventProvider and WebEventProvider syntax -->
<add   
   name="provider name"
   type="type reference" />

<!-- SQL Implementation Provider syntax -->
<add name="SqlEventProvider"
     type="System.Web.Management.SqlWebEventProvider, System.Web, 
Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
     connectionName="string"
     maxEventDetailLength="int" 
     commandTimeout="interval" 
     buffer="true|false" 
     bufferMode="string" />

<!-- Simple Mail Event and Templated Mail Web Event Providers syntax -->
<add name="MailEventProvider" 
     type="System.Web.Management.MailWebEventProvider,System.Web,
Version=%ASSEMBLY_VERSION%,Culture=neutral,PublicKeyToken=%MICROSOFT_PUBLICKEY%"
     from="string" 
     to="string; string" 
     cc=”string; string” 
     bcc="string; string" 
     priority="High|Normal|Low" 
     subjectPrefix="email subject prefix" 
     bodyHeader="email body header" 
     bodyFooter="email body footer" 
     separator="string" 
     template="string" (cannot be specified with the header/footer/separator) 
     maxSizeForSimpleMessage="number" 
     maxEventLengthForSimpleMessage="number" 
     maxEventCountForTemplateMessage="number" 
     maxMessagesPerNotification="number" 
     buffer="true|false" 
     bufferMode="string" />

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
bcc	선택적 String 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 클래스에만 적용됩니다. 숨은 참조(bcc) 목록에 포함할 받는 사람 주소가 세미콜론(;)으로 구분된 목록을 정의합니다.
bodyFooter	선택적 String 특성입니다. SimpleMailWebEventProvider 특성에만 적용됩니다. 단순 전자 메일 형식에서 전자 메일 본문의 맨 아래에 포함할 텍스트를 지정합니다. 참고 이 특성은 template 특성과 함께 사용할 수 없습니다.
bodyHeader	선택적 String 특성입니다. SimpleMailWebEventProvider 특성에만 적용됩니다. 단순 전자 메일 형식에서 전자 메일 본문의 맨 위에 포함할 텍스트를 지정합니다. 참고 이 특성은 template 특성과 함께 사용할 수 없습니다.
buffer	필수 Boolean 특성입니다. SqlWebEventProvider 클래스에만 적용됩니다. 공급자에서 버퍼링을 사용할지 아니면 각 이벤트를 받는 사람에게 즉시 보낼지 지정합니다. 기본값은 false입니다.
bufferMode	선택적 String 특성입니다. SQLWebEventProvider 특성에만 적용됩니다. 공급자가 버퍼링 모드에 있는 경우 해당 공급자에 사용되는 버퍼링 모드의 이름을 지정합니다. 이 이름은 BufferModesCollection 컬렉션에 있는 기존 버퍼링 모드 중 하나를 참조해야 하고 그렇지 않으면 예외가 throw됩니다. 버퍼링을 사용하도록 설정된 경우에는 이 특성이 있어야 합니다.
cc	선택적 String 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 특성에만 적용됩니다. 참조(cc) 목록에 포함할 받는 사람 주소가 세미콜론(;)으로 구분된 목록을 정의합니다.
commandTimeout	선택적 Int32 특성입니다. SQLWebEventProvider 특성에만 적용됩니다. 멤버 자격 데이터 소스에 대해 실행되는 명령이 시간 초과되기 전의 시간(초)을 지정합니다. 이 제한 시간은 SQL 공급자가 SqlCommand 개체를 만들 때 사용됩니다. 기본적으로 이 특성은 ASP.NET 구성에 설정되어 있지 않습니다. 따라서 ADO.NET 기본값인 30초가 사용됩니다. 이 특성을 설정하면 SQL 공급자는 데이터베이스에 대해 실행되는 모든 SQL 명령에 해당 제한 시간 값을 사용해야 합니다. 유효성 검사가 실패하면 System.Configuration.Provider.ProviderException 예외가 throw됩니다. 기본값은 30(ADO.NET 기본값)입니다.
connectionStringName	필수 String 특성입니다. SQLWebEventProvider 특성에만 적용됩니다. 데이터베이스에 연결할 때 사용할 문자열을 지정합니다.
detailedTemplateErrors	선택적 Boolean 특성입니다. TemplatedMailWebEventProvider 특성에만 적용됩니다. 템플릿을 컴파일하는 동안 또는 런타임에 오류가 발생할 경우 전자 메일 메시지를 통해 예외 정보를 보낼지 여부를 지정합니다. 기본값은 false입니다.
from	선택적 String 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 특성에만 적용됩니다. 보낸 사람 주소를 지정합니다. 이 특성은 지정되지 않은 경우 SMTP 메일 구성 섹션에서 상속됩니다.
maxEventDetailLength	선택적 Int32 특성입니다. SQLWebEventProvider 특성에만 적용됩니다. 다음과 같이 각 이벤트에 허용되는 이벤트 정보의 최대 길이(문자 수)를 지정합니다. 이벤트 정보(event.ToString())가 이 특성보다 크면 maxEventDetailLength 길이에서 이벤트 정보가 잘립니다. 0이면 각 이벤트에 정보가 제공되지 않습니다. Infinite이면 최대 길이 검사가 수행되지 않고 전체 정보 텍스트가 포함됩니다. 참고 이벤트 정보 길이에 제한이 없는 경우 이 특성은 보안상 위험할 수 있습니다.
maxEventLengthForSimpleMessage	선택적 Int32 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 특성에만 적용됩니다. 다음과 같이 각 이벤트에 허용되는 이벤트 정보의 최대 길이(문자 수)를 지정합니다. 이벤트 정보(event.ToString())가 이 특성보다 크면 maxEventLengthForSimpleMessage 길이에서 이벤트 정보가 잘립니다. 0이면 알림 메시지에 이벤트 정보가 포함되지 않습니다. Infinite이면 이벤트 정보 길이에 대한 상한이 설정되지 않습니다. 참고 메시지 크기에 제한이 없는 경우 이 특성은 보안상 위험할 수 있습니다. 기본값은 5000자입니다.
maxSizeForSimpleMessage	선택적 Int32 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 특성에만 적용됩니다. 공급자에서 보내는 알림 메시지의 최대 크기(바이트)를 지정합니다. Infinite이면 단순 모드에서 메일 분할이 수행되지 않습니다. 참고 이 특성을 사용하면 전자 메일 시스템에서 메시지가 삭제될 수 있으며 보안상 위험합니다. 기본값은 1024KB입니다.
maxEventCountForTemplateMessage	선택적 Int32 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 특성에만 적용됩니다. 템플릿 모드에 있는 경우 공급자에서 보내는 각 알림 메시지의 최대 이벤트 수를 지정합니다. Infinite이면 메일 분할이 수행되지 않습니다. 참고 이 특성을 사용하면 전자 메일 시스템에서 메시지가 삭제될 수 있으며 보안상 위험합니다. 기본값은 100입니다.
maxMessagesPerNotification	선택적 Int32 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 특성에만 적용됩니다. 각 알림에 대해 분할할 수 있는 이벤트 간 최대 메시지 수를 지정합니다. Infinite이면 제한이 지정되지 않습니다. 참고 이 특성을 사용하면 전자 메일 용량이 초과될 수 있으며 보안상 위험합니다. 기본값은 100입니다.
name	필수 String 특성입니다. 공급자 이름을 지정합니다.
priority	선택적 String 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 특성에만 적용됩니다. 이 특성은 MailPriority 열거형의 멤버이며 전자 메일 메시지의 우선 순위를 설정합니다. 기본값은 Normal입니다.
separator	선택적 String 특성입니다. SimpleMailWebEventProvider 특성에만 적용됩니다. 단순 전자 메일 형식에서 각 이벤트 사이와 각 섹션 헤더 뒤에 포함할 텍스트를 지정합니다. 참고 이 특성은 template 특성과 함께 사용할 수 없습니다.
smtpAddresses	필수 String 특성입니다. SimpleMailWebEventProvider 특성에만 적용됩니다. 이벤트 알림이 전송되는 전자 메일 주소가 쉼표로 구분된 목록을 지정합니다. 프로필 이벤트에 따라 다른 전자 메일 주소 집합이 사용될 경우에는 공급자의 인스턴스를 여러 개 구성할 수 있습니다.
subjectPrefix	선택적 String 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 특성에만 적용됩니다. 전자 메일 제목 앞에 추가되는 문자열을 지정하여 각 공급자 인스턴스에 대해 전자 메일 메시지에 사용자 지정 제목이 포함되도록 할 수 있습니다. 참고 이 특성은 template 특성과 함께 사용할 수 없습니다.
template	선택적 String 특성입니다. TemplatedMailWebEventProvider 특성에만 적용됩니다. 각 알림 메시지의 본문을 만드는 데 사용하기 위해 사용자가 제공한 템플릿 페이지(.aspx)를 지정합니다. 참고 이 특성은 bodyHeader, bodyFooter 및 separator 특성과 함께 사용할 수 없습니다.
to	선택적 String 특성입니다. SimpleMailWebEventProvider 및 TemplatedMailWebEventProvider 특성에만 적용됩니다. 받는 사람(to:) 목록에 포함할 받는 사람 주소가 세미콜론(;)으로 구분된 목록을 정의합니다.
type	필수 String 특성입니다. System.Configuration.Provider.ProviderBase 클래스를 구현하는 클래스에 대한 정규화된 어셈블리 참조를 지정합니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소를 지정합니다.
system.web	ASP.NET 구성 섹션의 루트 요소를 지정합니다.
healthMonitoring	상태 모니터링에 대한 응용 프로그램을 구성합니다.
providers	이벤트를 처리하는 상태 모니터링 공급자를 정의합니다.

설명

다른 이름/값 쌍이 더 있는 경우에는 공급자에서 이러한 이름/값 쌍을 처리해야 합니다.

기본 구성

다음의 기본 add 요소는 .NET Framework 버전 2.0의 루트 Web.config 파일에 구성되어 있습니다.

<add name="EventLogProvider" type="System.Web.Management.EventLogWebEventProvider,
System.Web,Version=2.0.0.0,Culture=neutral,
     PublicKeyToken=b03f5f7f11d50a3a" />
<add ConnectionStringName="LocalSqlServer" maxEventDetailsLength="1073741823" 
     buffer="false" bufferMode="Notification" name="SqlWebEventProvider" 
     type="System.Web.Management.SqlWebEventProvider,
System.Web,Version=2.0.0.0,
     Culture=neutral,PublicKeyToken=b03f5f7f11d50a3a" />
<add name="WmiWebEventProvider" type="System.Web.Management.WmiWebEventProvider,
System.Web,Version=2.0.0.0,Culture=neutral,
     PublicKeyToken=b03f5f7f11d50a3a" />

예제

다음 코드 예제에서는 공급자를 추가하는 방법을 보여 줍니다.

<providers>
  <add name="WmiEventProvider"
       type="System.Web.Management.WmiWebEventProvider,
     System.Web,Version=1.2.3400.0,Culture=neutral,
     PublicKeyToken=b03f5f7f11d50a3a"/>
  <add name="SampleEventProvider"     
       type="Samples.AspNet.SampleEventProvider,SampleEventProvider,
     Version=0.0.0.0,Culture=neutral,PublicKeyToken=92029af6cf75bd7c,
     ProcessorArchitecture=Neutral"/>
</providers>

요소 정보

구성 섹션 처리기	System.Web.Configuration.HealthMonitoringSection
구성 멤버	HealthMonitoringSection.Providers
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 Microsoft .NET Framework 2.0 Microsoft Visual Studio 2005

참고 항목

다음을 통해 공유