Projektdateien lesen

Mit ASPOSPE.Beaks für C ++ können Sie mit MCP -Projekten (Microsoft Project (MPP/XML)) arbeiten, ohne dass Microsoft Project installiert wird oder die Microsoft Office -Automatisierung verwendet. Eine leistungsstarke und flexible API Aspose.Tasks spart Ihnen Zeit und Mühe, indem Sie Ihnen die Tools geben, die Sie benötigen, um effiziente Code zum Manipulieren von Projektdateien in Ihren C ++ - Anwendungen zu schreiben.

In diesem Artikel wird erläutert, wie die Projektdatei geöffnet und gelesen wird.

Lesen einer Projektdatei

Im Moment können Aspose.Tasks Microsoft Project nur in das XML -Format von Microsoft Project exportieren. Dies gilt, wenn Sie ein neues Projekt erstellen. Mit ASPOSPE.Beaks für C ++ können Sie vorhandene MPP -Dateien lesen und diese nach der Aktualisierung im MPP -Format wieder speichern. Dies ermöglicht das Lesen von MPP sowie MPT -Formaten als Eingangsvorlagen. Dieser Artikel zeigt, wie eine Projektdatei (xml, mpp, mpt) mit dem Konstruktor der Projektklasse gelesen werden kann.

Projektdateien als Vorlage lesen

// 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());
    }
}