プロジェクトファイルを読む

C ++のAspose.Tasksでは、Microsoft Projectをインストールせずに、またはMicrosoft Office Automationを使用せずに、Microsoft Project(MPP/XML)ファイルを操作できます。強力で柔軟なAPI、Aspose.Tasksは、C ++アプリケーションでプロジェクトファイルを操作するために効率的なコードを作成するために必要なツールを提供することにより、時間と労力を節約します。

この記事では、プロジェクトファイルを開いて読む方法について説明します。

プロジェクトファイルを読む

現時点では、Aspose.TasksはMicrosoftプロジェクトをMicrosoft ProjectのXML形式のみにエクスポートできます。これは、新しいプロジェクトを作成している場合に当てはまります。 C ++のAspose.Tasksでは、既存のMPPファイルを読み取り、更新後にこれらをMPP形式で保存できます。これにより、MPPとMPT形式を入力テンプレートとして読み取ることができます。この記事では、プロジェクトファイル(xml、mpp、mpt)をプロジェクトクラスのコンストラクターを使用して読み取る方法を示しています。

プロジェクトファイルをテンプレートとして読む

// The path to the documents directory.
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
    
// Read existing project template file
System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"ReadProjectFiles.mpp");

Reading Project File from Stream

// The path to the documents directory.
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
    
// Read project xml into file stream
{
    System::SharedPtr<System::IO::Stream> filesStream = System::MakeObject<System::IO::FileStream>(dataDir + u"ReadProjectFileFromStream.xml", System::IO::FileMode::Open);
    // Clearing resources under 'using' statement
    System::Details::DisposeGuard<1> __dispose_guard_0({ filesStream});
    // ------------------------------------------
    
    try
    {
        // Create project using file stream
        System::SharedPtr<Project> project = System::MakeObject<Project>(filesStream);
    }
    catch(...)
    {
        __dispose_guard_0.SetCurrentException(std::current_exception());
    }
}

Ignoring invalid characters during loading Project

Some files may have invalid characters in the custom fields. Microsoft Project does not allow invalid character so the files have been created or manipulated with automation or some other tools. If these files are loaded using the API, they may lead to an exception. In order to ignore such invalid characters, the overloaded constructor of Project class can be used with the delegate method ParseErrorCallBack.

void IgnoreInvalidCharactersDuringloadingProject::Run()
{
    // Open modified xml stream
    {
        System::SharedPtr<System::IO::MemoryStream> stream = System::MakeObject<System::IO::MemoryStream>(System::Text::Encoding::get_UTF8()->GetBytes(GetModifiedXml()));
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ stream});
        // ------------------------------------------
        
        try
        {
            System::SharedPtr<Project> project = System::MakeObject<Project>(stream, static_cast<ParseErrorCallback>(CustomDurationHandler));
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }
}

Read Password Protected Projects (2003 Format)

The Project class exposes the Project() constructor which is capable of reading password-protected files in 2003 format. Saving a password-protected file is not supported yet.

To read a password-protected project file:

1. Load a Microsoft Project file.
2. In the constructor, provide a password as the second argument to the constructor.

The following code example demonstrates how to read password-protected project file.

// The path to the documents directory.
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
    
System::SharedPtr<Project> project = System::MakeObject<Project>(dataDir + u"PasswordProtectedProject.mpp", System::String(u"password"));

Working With Encodings

Aspose.Tasks provides support for the encoding of MPX files. The following code example demonstrates how to use the encoding settings.

// Specify Encodings
{
    System::SharedPtr<System::IO::StreamReader> streamReader = System::MakeObject<System::IO::StreamReader>(dataDir + u"Project.mpx", System::Text::Encoding::GetEncoding(u"ISO-8859-1"));
    // Clearing resources under 'using' statement
    System::Details::DisposeGuard<1> __dispose_guard_0({ streamReader});
    // ------------------------------------------
    
    try
    {
        auto project = System::MakeObject<Project>(streamReader->get_BaseStream());
    }
    catch(...)
    {
        __dispose_guard_0.SetCurrentException(std::current_exception());
    }
}