Читання файлів проектів

Aspose.Tasks для C ++ дозволяє працювати з файлами Microsoft Project (MPP/XML), не встановлюючи Microsoft Project, або за допомогою автоматизації Microsoft Office. Потужний та гнучкий API, Aspose.Tasks ЗБЕРЕГАЄТЬСЯ ВАШІ ЧАС І СВІТЛИ, Даючи вам інструменти, необхідні для написання ефективного коду для маніпулювання файлами проектів у ваших програмах C ++.

Ця стаття пояснює, як відкрити та читати файл проекту.

Читання файлу проекту

На даний момент Aspose.Tasks може експортувати проект Microsoft лише до формату XML Project Microsoft. Це правда, якщо ви створюєте новий проект. Aspose.Tasks для C ++ дозволяє прочитати існуючі файли 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());
    }
}