ProjectStartedEventArgs

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

ProjectStartedEventArgs クラス

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

ProjectStarted イベントのデータを提供します。

名前空間: Microsoft.Build.Framework
アセンブリ: Microsoft.Build.Framework (microsoft.build.framework.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class ProjectStartedEventArgs
    Inherits BuildStatusEventArgs

Visual Basic (使用法)

Dim instance As ProjectStartedEventArgs

C#

[SerializableAttribute] 
public class ProjectStartedEventArgs : BuildStatusEventArgs

C++

[SerializableAttribute] 
public ref class ProjectStartedEventArgs :
 public BuildStatusEventArgs

J#

/** @attribute SerializableAttribute() */ 
public class ProjectStartedEventArgs extends
 BuildStatusEventArgs

JScript

SerializableAttribute 
public class ProjectStartedEventArgs extends
 BuildStatusEventArgs

使用例

ビルド イベントに応答する基本 logger を作成する方法を次の例に示します。

C#

using System;
using System.IO;
using System.Security;
using Microsoft.Build.Framework;
using Microsoft.Build.Utilities;

namespace MyLoggers
{
    // This logger will derive from the Microsoft.Build.Utilities.Logger
 class,
    // which provides it with getters and setters for Verbosity and
 Parameters,
    // and a default empty Shutdown() implementation.
    public class BasicFileLogger : Logger
    {
        /// <summary>
        /// Initialize is guaranteed to be called by MSBuild at the
 start of the build
        /// before any events are raised.
        /// </summary>
        public override void Initialize(IEventSource
 eventSource)
        {
            // The name of the log file should be passed as the first
 item in the
            // "parameters" specification in the /logger switch.
  It is required
            // to pass a log file to this logger. Other loggers may
 have zero or more than 
            // one parameters.
            if (null == Parameters)
            {
                throw new LoggerException("Log file was not
 set.");
            }
            string[] parameters = Parameters.Split(';');
            
            string logFile = parameters[0];
            if (String.IsNullOrEmpty(logFile))
            {
                throw new LoggerException("Log file was not
 set.");
            }
            
            if (parameters.Length > 1)
            {
                throw new LoggerException("Too many parameters
 passed.");
            }
            
            try
            {
                // Open the file
                this.streamWriter = new StreamWriter(logFile);
            }
            catch (Exception ex)
            {
                if
                (
                    ex is UnauthorizedAccessException
                    || ex is ArgumentNullException
                    || ex is PathTooLongException
                    || ex is DirectoryNotFoundException
                    || ex is NotSupportedException
                    || ex is ArgumentException
                    || ex is SecurityException
                    || ex is IOException
                )
                {
                    throw new LoggerException("Failed to
 create log file: " + ex.Message);
                }
                else
                {
                    // Unexpected failure
                    throw;
                }
            }

            // For brevity, we'll only register for certain event types.
 Loggers can also
            // register to handle TargetStarted/Finished and other events.
            eventSource.ProjectStarted += new ProjectStartedEventHandler(eventSource_ProjectStarted);
            eventSource.TaskStarted += new TaskStartedEventHandler(eventSource_TaskStarted);
            eventSource.MessageRaised += new BuildMessageEventHandler(eventSource_MessageRaised);
            eventSource.WarningRaised += new BuildWarningEventHandler(eventSource_WarningRaised);
            eventSource.ErrorRaised += new BuildErrorEventHandler(eventSource_ErrorRaised);
            eventSource.ProjectFinished += new ProjectFinishedEventHandler(eventSource_ProjectFinished);
        }

        void eventSource_ErrorRaised(object sender, BuildErrorEventArgs
 e)
        {
            // BuildErrorEventArgs adds LineNumber, ColumnNumber, File,
 amongst other parameters
            string line = String.Format(": ERROR {0}({1},{2}):
 ", e.File, e.LineNumber, e.ColumnNumber);
            WriteLineWithSenderAndMessage(line, e);
        }
        
        void eventSource_WarningRaised(object sender, BuildWarningEventArgs
 e)
        {
            // BuildWarningEventArgs adds LineNumber, ColumnNumber,
 File, amongst other parameters
            string line = String.Format(": Warning {0}({1},{2}):
 ", e.File, e.LineNumber, e.ColumnNumber);
            WriteLineWithSenderAndMessage(line, e);
        }

        void eventSource_MessageRaised(object sender, BuildMessageEventArgs
 e)
        {
            // BuildMessageEventArgs adds Importance to BuildEventArgs
            // Let's take account of the verbosity setting we've been
 passed in deciding whether to log the message
            if ((e.Importance == MessageImportance.High &&
 IsVerbosityAtLeast(LoggerVerbosity.Minimal))
                || (e.Importance == MessageImportance.Normal && IsVerbosityAtLeast(LoggerVerbosity.Normal))
                || (e.Importance == MessageImportance.Low && IsVerbosityAtLeast(LoggerVerbosity.Detailed))
                
                )
            {
                WriteLineWithSenderAndMessage(String.Empty, e);
            }
        }

        void eventSource_TaskStarted(object sender, TaskStartedEventArgs
 e)
        {
            // TaskStartedEventArgs adds ProjectFile, TaskFile, TaskName
            // To keep this log clean, this logger will ignore these
 events.
        }
        
        void eventSource_ProjectStarted(object sender, ProjectStartedEventArgs
 e)
        {
            // ProjectStartedEventArgs adds ProjectFile, TargetNames
            // Just the regular message string is good enough here,
 so just display that.
            WriteLine(String.Empty, e);
            indent++;
        }

        void eventSource_ProjectFinished(object sender, ProjectFinishedEventArgs
 e)
        {
            // The regular message string is good enough here too.
            indent--;
            WriteLine(String.Empty, e);
        }
        
        /// <summary>
        /// Write a line to the log, adding the SenderName and Message
        /// (these parameters are on all MSBuild event argument objects)
        /// </summary>
        private void WriteLineWithSenderAndMessage(string
 line, BuildEventArgs e)
        {
            if (0 == String.Compare(e.SenderName, "MSBuild",
 true /*ignore case*/))
            {
                // Well, if the sender name is MSBuild, let's leave
 it out for prettiness
                WriteLine(line, e);
            }
            else
            {
                WriteLine(e.SenderName + ": " + line, e);
            }
        }
        
        /// <summary>
        /// Just write a line to the log
        /// </summary>
        private void WriteLine(string
 line, BuildEventArgs e)
        {
            for (int i = indent; i > 0;
 i--)
            {
                streamWriter.Write("\t");
            }
            streamWriter.WriteLine(line + e.Message);
        }
        
        /// <summary>
        /// Shutdown() is guaranteed to be called by MSBuild at the
 end of the build, after all 
        /// events have been raised.
        /// </summary>
        public override void Shutdown()
        {
            // Done logging, let go of the file
            streamWriter.Close();
        }

        private StreamWriter streamWriter;
        private int indent;
    }
}

継承階層

System.Object
   System.EventArgs
     Microsoft.Build.Framework.BuildEventArgs
       Microsoft.Build.Framework.BuildStatusEventArgs
        Microsoft.Build.Framework.ProjectStartedEventArgs

スレッド セーフ

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

プラットフォーム

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

参照

関連項目
ProjectStartedEventArgs メンバ
Microsoft.Build.Framework 名前空間

ProjectStartedEventArgs コンストラクタ ()

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

ProjectStartedEventArgs クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.Build.Framework
アセンブリ: Microsoft.Build.Framework (microsoft.build.framework.dll 内)
構文

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New ProjectStartedEventArgs

C#

protected ProjectStartedEventArgs ()

C++

protected:
ProjectStartedEventArgs ()

J#

protected ProjectStartedEventArgs ()

JScript

protected function ProjectStartedEventArgs
 ()

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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

参照

関連項目
ProjectStartedEventArgs クラス
ProjectStartedEventArgs メンバ
Microsoft.Build.Framework 名前空間

ProjectStartedEventArgs コンストラクタ

ProjectStartedEventArgs クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
ProjectStartedEventArgs ()	ProjectStartedEventArgs クラスの新しいインスタンスを初期化します。
ProjectStartedEventArgs (String, String, String, String, IEnumerable, IEnumerable)	値を指定して、ProjectStartedEventArgs クラスの新しいインスタンスを初期化します。

参照

関連項目

ProjectStartedEventArgs クラス
ProjectStartedEventArgs メンバ
Microsoft.Build.Framework 名前空間

ProjectStartedEventArgs コンストラクタ (String, String, String, String, IEnumerable, IEnumerable)

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

値を指定して、ProjectStartedEventArgs クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.Build.Framework
アセンブリ: Microsoft.Build.Framework (microsoft.build.framework.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    message As String, _
    helpKeyword As String, _
    projectFile As String, _
    targetNames As String, _
    properties As IEnumerable, _
    items As IEnumerable _
)

Visual Basic (使用法)

Dim message As String
Dim helpKeyword As String
Dim projectFile As String
Dim targetNames As String
Dim properties As IEnumerable
Dim items As IEnumerable

Dim instance As New ProjectStartedEventArgs(message,
 helpKeyword, projectFile, targetNames, properties, items)

C#

public ProjectStartedEventArgs (
    string message,
    string helpKeyword,
    string projectFile,
    string targetNames,
    IEnumerable properties,
    IEnumerable items
)

C++

public:
ProjectStartedEventArgs (
    String^ message, 
    String^ helpKeyword, 
    String^ projectFile, 
    String^ targetNames, 
    IEnumerable^ properties, 
    IEnumerable^ items
)

J#

public ProjectStartedEventArgs (
    String message, 
    String helpKeyword, 
    String projectFile, 
    String targetNames, 
    IEnumerable properties, 
    IEnumerable items
)

JScript

public function ProjectStartedEventArgs (
    message : String, 
    helpKeyword : String, 
    projectFile : String, 
    targetNames : String, 
    properties : IEnumerable, 
    items : IEnumerable
)

パラメータ

message

イベントのテキスト。

helpKeyword

イベントに関連付けられているヘルプ キーワード。

projectFile

プロジェクト ファイル名。

targetNames

ビルドするターゲット。

properties

プロパティの一覧。

items

アイテムの一覧。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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

参照

関連項目
ProjectStartedEventArgs クラス
ProjectStartedEventArgs メンバ
Microsoft.Build.Framework 名前空間

ProjectStartedEventArgs プロパティ

パブリック プロパティ

	名前	説明
	HelpKeyword	イベントのヘルプ キーワードを取得します。 ( BuildEventArgs から継承されます。)
	Items	イベントのアイテムの一覧を取得します。
	Message	イベントに関するメッセージを取得します。 ( BuildEventArgs から継承されます。)
	ProjectFile	イベントに関連付けられているプロジェクト ファイルを取得します。
	Properties	イベントのプロパティの一覧を取得します。
	SenderName	イベントの発生元の Object の名前を取得します。 ( BuildEventArgs から継承されます。)
	TargetNames	プロジェクトでビルドされるターゲットの一覧を取得します。
	ThreadId	イベントの発生元のスレッドを示す、整数の識別子を取得します。 ( BuildEventArgs から継承されます。)
	Timestamp	イベントが発生した時刻を DateTime として取得します。 ( BuildEventArgs から継承されます。)

参照

関連項目

ProjectStartedEventArgs クラス
Microsoft.Build.Framework 名前空間

ProjectStartedEventArgs メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

ProjectStartedEventArgs クラス
Microsoft.Build.Framework 名前空間

ProjectStartedEventArgs メンバ

ProjectStarted イベントのデータを提供します。

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

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

( プロテクト コンストラクタ も参照)

	名前	説明
	ProjectStartedEventArgs	オーバーロードされます。 ProjectStartedEventArgs クラスの新しいインスタンスを初期化します。

プロテクト コンストラクタ

	名前	説明
	ProjectStartedEventArgs	オーバーロードされます。 ProjectStartedEventArgs クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	HelpKeyword	イベントのヘルプ キーワードを取得します。(BuildEventArgs から継承されます。)
	Items	イベントのアイテムの一覧を取得します。
	Message	イベントに関するメッセージを取得します。(BuildEventArgs から継承されます。)
	ProjectFile	イベントに関連付けられているプロジェクト ファイルを取得します。
	Properties	イベントのプロパティの一覧を取得します。
	SenderName	イベントの発生元の Object の名前を取得します。(BuildEventArgs から継承されます。)
	TargetNames	プロジェクトでビルドされるターゲットの一覧を取得します。
	ThreadId	イベントの発生元のスレッドを示す、整数の識別子を取得します。(BuildEventArgs から継承されます。)
	Timestamp	イベントが発生した時刻を DateTime として取得します。(BuildEventArgs から継承されます。)

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

ProjectStartedEventArgs クラス
Microsoft.Build.Framework 名前空間