Project.MarkDirty Метод

Определение

Вызывается для принудительной пометки проекта как "грязного" и нуждающегося в повторной оценке.Called to forcibly mark the project as dirty requiring reevaluation. Обычно это необязательно для установки. Все изменения, влияющие на этот проект, автоматически делают его "грязным".Generally this is not necessary to set; all edits affecting this project will automatically make it dirty. Однако есть потенциальные тупиковые случаи, когда необходимо пометить проект как "грязный" напрямую.However there are potential corner cases where it is necessary to mark the project dirty directly. Например, если в проекте есть условный импорт в имеющийся на диске файл, но файл не существовал во время оценки, то после того, как он будет создан, проект не сможет понять, что повторная оценка будет продуктивной.For example, if the project has an import conditioned on a file existing on disk, and the file did not exist at evaluation time, then someone subsequently creates that file, the project cannot know that reevaluation would be productive. В этом случае узел может помочь нам, установив флаг "Грязный" явным образом, чтобы ReevaluateIfNecessary() мог распознать необходимость в оценке.In such a case the host can help us by setting the dirty flag explicitly so that ReevaluateIfNecessary() will recognize an evaluation is indeed necessary. Не помечает базовый файл проекта как нуждающийся в сохранении.Does not mark the underlying project file as requiring saving.

public:
 void MarkDirty();
public void MarkDirty ();
member this.MarkDirty : unit -> unit
Public Sub MarkDirty ()

Комментарии

Вызывать этот метод явным образом нередко, так как все изменения, затрагивающие проект, автоматически помечают его как измененный.It is seldom necessary to call this method explicitly, because all edits affecting a project automatically mark it as modified.

Однако иногда этот метод должен вызываться.Sometimes, however, this method must be called. Например, проект может содержать элемент Import, условие которого зависит от файла, существующего на диске.For example, a project may have an Import element whose condition depends on a file that exists on a disk. Если этот файл не существует во время вычисления и создан после вычисления, то проект должен быть явно помечен как измененный.If that file does not exist at evaluation time, and it is created after evaluation, then the project must be explicitly marked as modified.

ReevaluateIfNecessaryМетод использует это свойство, чтобы определить, требуется ли оценка.The ReevaluateIfNecessary method uses this property to determine if an evaluation is necessary.

Применяется к