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

Aspose.Tasks для C ++ позволяет вам работать с файлами Microsoft Project (MPP/XML) без установки Microsoft Project или с использованием Microsoft Office Automation. Мощный и гибкий API, Aspose.Tasks экономит ваше время и усилия, предоставляя вам инструменты, необходимые для написания эффективного кода для манипулирования файлами проекта в ваших приложениях C ++.

В этой статье объясняется, как открыть и прочитать файл проекта.

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

На данный момент Aspose.Tasks может экспортировать Microsoft Project только в формат XML Microsoft Project. Это правда, если вы создаете новый проект. 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());
    }
}